Ionic-liquid dumps

An ionic-liquid dump is a multi-type frame, and CHILL is the wrong score for the ions. Keep CHILL and cages on water with --water-types T (the neighbour mask). --type is the load filter. Use seams rdf for a partial g_IJ(r) under the dump minimum image. Use seams density-z for a type-resolved \(\rho(z)\) in a slit.

The bundled frame input/traj/il_tiny.lammpstrj has 12 atoms of LAMMPS types 1, 2, 3 and 4 in a 24 Å cube. When --family is omitted and the loaded frame has more than two types, stderr prints

hint: more than two LAMMPS types; set --family (default waterIce)

and the command still exits 0.

Pick one type

--type / -t selects the loaded type. 0, the default, keeps type 2 when that type is present, and type 1 when it is absent. density-z is the exception: 0 keeps every atom. A dump whose species is not that guess needs the integer type.

seams read input/traj/il_tiny.lammpstrj
seams read input/traj/il_tiny.lammpstrj --type 3

The first command keeps type 2 and prints nop 4 frame 1 box 24 24 24. --type 3 keeps two atoms and prints nop 2 frame 1 box 24 24 24.

Unlike-type neighbours

nneigh::neighListPair(rcut, cloud, typeI, typeJ) builds I-J pairs. I == J is the like-type list (neighListO). Distances use gen::periodicDistSq, so a sheared dump box uses the same MIC as the ice neighbour lists.

Partial g(r)

seams rdf input/traj/il_tiny.lammpstrj --pair-types 1,2 --cutoff 6.0
seams rdf input/traj/il_tiny.lammpstrj --pair-types 1,2 --cutoff 6.0 --bins 60
seams rdf input/traj/il_tiny.lammpstrj --type 2 --cutoff 6.0

--pair-types I,J selects the pair. The default is I = J = --type, a like-type g(r) of the guessed or requested species. --types is a deprecated exact alias of --pair-types and prints --types is deprecated; use --pair-types. --cutoff is rmax. --bins is optional (default rmax / 0.1, so 60 bins at 6 Å).

Stdout is # r g count, then # types I J rmax R bins N volume V, then one r g count row per bin. The normalization volume is det(H) from the dump box. On this orthorhombic frame that volume is 13824. Tilt xy xz yz enters H when the dump carries it. The unlike-pair header is

# types 1 2 rmax 6 bins 60 volume 13824

seams rdf is a pair histogram. CHILL and cages stay on water.

Site kinds and ion vertices

LAMMPS type is a column, and the chemistry lives in a site::Table of type-to-kind (and optional atom-ID overrides). Table::of looks up the override first, then the type, else unspecified. indicesOf(polar) is the union of cationHead, anion, and explicit polar; indicesOf(apolar) is tail plus explicit apolar. site::ionCloud emits one vertex per molID that carries a cation head or anion: the unweighted COM of those tagged atoms, unwrapped with gen::relDist to the first atom of the group, with Point::type 1 (cation) or 2 (anion). A long-chain cation COM sits on the polar head, because the tail atoms are not in that average. Family is an input on the table. Types do not set it.

On that ion cloud, nneigh::nearestUnlike(cloud, 1, 2) is each ion’s nearest unlike neighbour and the MIC distance. nneigh::mutualNearestUnlike keeps the mutual edges. Those are contact pairs. seams cn is the coordination number, from the integral of \(g(r)\).

Polar and apolar domains

seams domains input/traj/il_tiny.lammpstrj --site '1=cationHead,2=anion,3=tail' --subset polar
seams domains input/traj/il_tiny.lammpstrj --site '1=cationHead,2=anion,3=tail' --subset apolar

seams domains builds the mask from site::indicesOf and walks Stoddard’s clusters on that subset. Neighbours are the dump-MIC cutoff list (--cutoff, default 3.5 Å). Stdout is subset NAME n N largest L P, and P = L / N. On this frame the lines are subset polar n 8 largest 4 P 0.5 and subset apolar n 2 largest 1 P 0.5. Missing --site prints domains needs --site and exits 2. --family applies to ice scores. Domains ignore it.

Confined layers

A slit or slab dump needs type-resolved \(\rho(z)\).

seams density-z input/traj/il_tiny.lammpstrj
seams density-z input/traj/il_tiny.lammpstrj --type 1 --bins 80
seams density-z input/traj/il_tiny.lammpstrj --type 2 --axis z

--type 0 (default) histograms every atom. --type I keeps one LAMMPS type. --axis is the Cartesian coordinate (x, y, or z; default z). --bins is optional (default the bound span over \(0.1\), 240 bins on this 24 Å cube).

Stdout is # z rho then one row per bin. The slice volume is \(A_\perp \times dz\). \(A_\perp\) comes from dump H (ly*lz for x, lx*lz for y, lx*ly for z) using the recovered edge lengths. The integral of rho * A * dz is the number of selected atoms.

Confined IL work is this histogram plus the in-plane rdf2::rdf2Danalysis_AA sampler. seams chill input/traj/il_tiny.lammpstrj --family confinedIL exits 2.

Molten salt is seams rdf / cn plus ionCloud when the melt is multi-site. DES adds explicit donor H-bonds. Electrolyte is ion–O rdf/cn plus water H-bonds. Silica / BeF2 is rdf/cn plus Franzblau on the M–X graph and getq6 on the tetrahedral cation (steinhardtQlVoronoi otherwise).

Read the box

seams read FILE prints nop N frame F box Lx Ly Lz and, when the dump is triclinic (box.size() >= 6), the tilt xy xz yz. On il_tiny.lammpstrj the default load prints nop 4 frame 1 box 24 24 24. Bound spans are the edge lengths on this orthorhombic frame. A sheared dump carries tilt as well. See Sheared cells.

Family names

--family names the material. The default is waterIce. seams chill, chill-plus, and cages exit 2 when --family is ionicLiquid, moltenSalt, des, electrolyte, confinedIL, confinedWater, or networkFormer. The message names the family. For ionicLiquid it is CHILL/TUM refused for family ionicLiquid. Unflagged seams chill stays the historical water path.

seams rdf input/traj/il_tiny.lammpstrj --pair-types 1,2 --cutoff 6.0
seams cn input/traj/il_tiny.lammpstrj --pair-types 1,2 --cutoff 6.0
seams cn input/traj/il_tiny.lammpstrj --ions --site '1=cationHead,2=anion'
seams pairs input/traj/il_tiny.lammpstrj --site '1=cationHead,2=anion'
seams domains input/traj/il_tiny.lammpstrj --site '1=cationHead,2=anion,3=tail' --subset polar
seams density-z input/traj/il_tiny.lammpstrj --type 1 --bins 80
seams chill input/traj/il_tiny.lammpstrj --family ionicLiquid  # exits 2

The coordination line is # types 1 2 cutoff 6 cn 1.75 nI 4 nJ 4 volume 13824. The ion coordination line is cage ionCloud types 1 2 cutoff 3.5 degree 1.5 nCation 4 nAnion 4. The contact line is contact-pair count 4 nCation 4 nAnion 4. The last command exits 2.

Flags and the rest of the surface live on seams CLI. Formats live on data formats.