File: doc_extract_lammps_data.md

package info (click to toggle)
moltemplate 2.22.4-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 26,084 kB
  • sloc: python: 25,770; sh: 3,746; tcl: 170; makefile: 14; awk: 4
file content (69 lines) | stat: -rw-r--r-- 2,315 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
extract_lammps_data.py
===========

## Description
**extract_lammps_data.py** is a simple script which extracts sections of
text from a LAMMPS data file.  (Of course, you can accomplish the same
thing with a text editor, but this script turns it into a one-line command.)
Although it was written in python, **extract_lammps_data.py** is a stand-alone
executable intended to be run from the terminal (shell).

## Typical usage

```
extract_lammps_data.py SECTION_NAME < FILE.DATA > EXCERPT.TXT
```
This extracts a section from a LAMMPS data file and saves it in EXCERPT.TXT.

## More general usage

```
extract_lammps_data.py [-n] SECTION_LIST < FILE.DATA > EXCERPT.TXT
```
The SECTION_LIST is a list of sections you want in your output file
(eg "EXCERPT.TXT").  Each section must be a quoted-string, and spaces
(not commas) should separate each section name.

The optional "-n" flag negates the selection.  (Selecting instead, everything
except the sections you listed.)

## Examples

```
extract_lammps_data.py "Atoms" < FILE.DATA > Atoms.txt
extract_lammps_data.py "Header" < FILE.DATA > Header.txt
extract_lammps_data.py -n "Header" < FILE.DATA > everything_except_Header.txt

extract_lammps_data.py "Bonds" "Angles" "Dihedrals" "Impropers" \
                       < FILE.DATA > topology.txt

extract_lammps_data.py "Pair Coeffs" "Bond Coeffs" "Angle Coeffs" \
                       "Dihedral Coeffs" "Improper Coeffs" \
                       < FILE.DATA > force_field.txt
```

The following section names are allowed:
```
"Header"                   # The header section at the beginning of the file.
"Atoms"
"Masses"
"Bonds"
"Bond Coeffs"
"Angles"
"Angle Coeffs"
"Dihedrals"
"Dihedral Coeffs"
"Impropers"
"Improper Coeffs"
"BondBond Coeffs"          # class2 angles
"BondAngle Coeffs"         # class2 angles
"MiddleBondTorsion Coeffs" # class2 dihedrals
"EndBondTorsion Coeffs"    # class2 dihedrals
"AngleTorsion Coeffs"      # class2 dihedrals
"AngleAngleTorsion Coeffs" # class2 dihedrals
"BondBond13 Coeffs"        # class2 dihedrals
"AngleAngle Coeffs"        # class2 impropers
"Angles By Type"           # moltemplate-specific. (not standard LAMMPS)
"Dihedrals By Type"        # moltemplate-specific. (not standard LAMMPS)
"Angles By Type'           # moltemplate-specific. (not standard LAMMPS)
```