Classify a dump¶
You have a LAMMPS water dump and want counts. The flag table is seams CLI. Counts for the mixed TIP4P frame are in the mixed TIP4P tutorial. The CHILL+ rules are on CHILL+.
Run the blocks below from a seams-core checkout, so input/traj/
resolves. On your own dump, pass the same flags with that path.
One frame¶
input/traj/exampleTraj.lammpstrj is one frame of mixed TIP4P:
750 atoms, type 2 oxygen, type 1 hydrogen. The default cutoff is
3.5 Å.
seams read input/traj/exampleTraj.lammpstrj
seams chill-plus input/traj/exampleTraj.lammpstrj --cutoff 3.5 --type 2
seams cages input/traj/exampleTraj.lammpstrj --type 2
seams rdf input/traj/exampleTraj.lammpstrj --type 2 --cutoff 10
read prints nop 250. chill-plus prints interClathrate 9 water 241.
cages prints water 250.
chill is the original CHILL rule.
chill-plus is the published CHILL+ rule: a crystal row has exactly
four neighbours inside the cutoff, q3 is the mean over the four
nearest of them, and the Table 1 neighbour test stays on.
chill_plus is an alias of chill-plus.
ovito-chill+ is the OVITO 3.17.2 rule: the same shell of four, q3
over that whole shell, and the neighbour test off.
ovito_chill_plus is an alias of ovito-chill+.
--rule ovito-chill+ selects the OVITO rule on chill-plus.
A path given to --rule is read as text and scanned for a rule or
chill-plus key, written rule: or rule =. Comments are skipped.
When --rule is absent, CHILL_PLUS_RULE in the environment, or in
./seams.env when that file is loaded, is the same string.
chill and chill-plus read one neighbour list. The stored default
graph name is seeded, and both commands map that name onto the
cutoff list: every pair closer than --cutoff.
--graph mutual keeps the mutual four nearest neighbours.
--cutoff is the cell-size hint for that search.
Type¶
--type 0, the default, keeps type 2 on a single LAMMPS frame when
any atom has it, and type 1 otherwise.
--type is that load filter.
--water-types is the neighbour mask: the mixed frame is loaded,
and ice is scored on the named LAMMPS types only. Substrate and ions
stay out of the neighbour list.
--family defaults to waterIce. chill, chill-plus, cages,
and ions exit 2 for every other family. The message names the family.
input/traj/mW_cubic.lammpstrj is single-site mW, type 1.
input/traj/agi_water_tiny.lammpstrj has water type 1 and ion types
3 and 4.
seams cages input/traj/mW_cubic.lammpstrj --type 1
seams chill-plus input/traj/agi_water_tiny.lammpstrj --water-types 1
seams cages input/traj/agi_water_tiny.lammpstrj --graph seeded --water-types 1
seams ions input/traj/agi_water_tiny.lammpstrj --ion-types 3,4 --water-types 1
seams chill-plus input/traj/exampleTraj.lammpstrj --type 2 --family ionicLiquid # exits 2
The family command prints CHILL/TUM refused for family ionicLiquid.
A dump with more than two LAMMPS types, and no --family, prints a
hint and still exits 0. The AgI commands above do that.
A triclinic dump uses the stored tilt. See
Sheared cells.
Frame range¶
Frames are 1-based. --last is inclusive. On a LAMMPS dump, a
--last past the end of the file stops at the last frame.
--jobs is the OpenMP worker count for that dump. --jobs 1 is
serial. mW_cubic.lammpstrj has 11 frames.
seams chill-plus input/traj/mW_cubic.lammpstrj --type 1 --frame 1 --last 2 --jobs 2
Bond graph for cages¶
seeded is the default: mutual k-nearest seeds and the union of
each atom’s k nearest. k defaults to 4. -k sets it.
--complete fills the last vertex of a six-ring when the other
vertices already carry a label.
seams cages input/traj/mW_cubic.lammpstrj --type 1 --graph seeded
seams cages input/traj/mW_cubic.lammpstrj --type 1 --graph seeded --complete
seams cages input/traj/mW_cubic.lammpstrj --type 1 --graph cutoff --cutoff 3.5
seams cages input/traj/mW_cubic.lammpstrj --type 1 --graph knn -k 4
seams cages input/traj/mW_cubic.lammpstrj --type 1 --graph knn-union -k 4
On that cubic cell each of the four graphs prints cubic 4096.
Features of this binary¶
seams --features
Each line is a compile-time switch, enabled or disabled.
OpenMP, chemfiles, and readcon-core are the switches the other
how-tos name.