Skip to content

Keyword reference

DSEAMS_CAGES registers the keywords and components below in registerKeywords of src/DseamsCages.cpp. Lengths are in A; LENGTH_SCALE converts the PLUMED length unit.

Keywords

Keyword Kind Default Meaning
ATOMS atoms, required The oxygen atoms of the water molecules.
CUTOFF compulsory 3.5 Neighbour cutoff in A for the CHILL+ graph.
CANDIDATE compulsory 5.5 Candidate shell in A for the four-nearest walk.
K compulsory 4 Neighbours per molecule in the bonded graph.
LENGTH_SCALE compulsory 10.0 Factor from the PLUMED length unit to A (10 for nm, 1 after UNITS LENGTH=A).
COMPLETE flag off Fill the last vertex of six-rings whose other vertices carry a label.
IONS atoms Ions read against the water assignment; not part of the graph. See Ions.
ION_CUTOFF compulsory 3.5 Radius in A of an ion's first water shell.
HOPS compulsory 3 Bonds from the centre in each local topology key.
LIBRARY optional One or more topology key libraries, comma separated. See Topology keys.
SIGNATURE optional A ring-size census (4:6,6:8) or a named table.
GUESTS atoms One atom per guest molecule; needs SIGNATURE.
GUEST_RADIUS compulsory 4.0 A guest belongs to the nearest cage centre within this distance (A).

SIGNATURE takes the named tables sodalite, alpha, 512, 51262, 51264, 51268, sh, sH, hc and ddc. hc and ddc keep the seeded ice finders. ncages counts the closed polyhedra that match.

GUESTS lists one atom per guest molecule (methane carbon, THF oxygen, an ion). Each guest goes to the nearest cage centre, the periodic centroid of a cage's vertices, within GUEST_RADIUS. GUESTS without SIGNATURE is an error.

LIBRARY takes files written by seams fingerprint --emit-library. Several files, built at different hop counts, name each molecule by the deepest library that holds its key. The deepest library must be built at HOPS. Two libraries at one hop count, or libraries that differ in colouring, are errors.

sod: DSEAMS_CAGES ATOMS=1-324 CUTOFF=3.5 SIGNATURE=sodalite
PRINT ARG=sod.ncages STRIDE=100 FILE=SOD

Omit LIBRARY, IONS, SIGNATURE or GUESTS when unused.

Components

Each component is an integer count with no derivative. Use them in PRINT, COMMITTOR and analysis, not in a bias.

Component Count
nice Molecules in a hexagonal or double-diamond cage.
nmax Largest connected cluster of cage molecules.
nclus Number of connected cage clusters.
nic Molecules in a double-diamond cage only.
nih Molecules in a hexagonal cage only.
nmixed Molecules in both cage types.
chillice CHILL+ cubic plus hexagonal molecules.
chillmax Largest CHILL+ bulk-ice cluster.
chillinterfacial CHILL+ interfacial molecules.
sixrings Primitive six-membered rings on the union graph.
nionice Ions whose first water shell is all cage molecules.
nionfront Ions with a mixed first shell.
nionliq Ions with no cage molecule in the first shell.
nclasses Distinct local topology classes on the mutual graph.
nnamed Molecules whose local key the LIBRARY names.
ncages Closed polyhedra matching SIGNATURE.
noccupied SIGNATURE cages holding at least one guest.
nmultiple SIGNATURE cages holding more than one guest.
nfreeguest Guests in no SIGNATURE cage.

Without IONS the three ion components stay 0. Without LIBRARY, nnamed stays 0. Without SIGNATURE, ncages stays 0; without GUESTS, the three guest components stay 0.