Cages and TRACE¶
Ask which molecules sit in a complete ice cage, or which polyhedra match a ring-size signature. TRACE, as run by ClavisCage, searches a hydrogen-bond graph for hydrate polyhedra. The commands below are the d-SEAMS counts.
Ice cages¶
seams cages reports hexagonal cages (HC, ice Ih), double-diamond
cages (DDC, ice Ic), molecules that sit in both, and water. The
default graph is seeded: the mutual four-nearest list and the union
of each atom’s four nearest neighbours, both taken inside
--cutoff + 1.5 Å. The cutoff default is 3.5 Å. Water is every
selected molecule that is in neither complete cage.
seams cages input/traj/exampleTraj.lammpstrj --type 2
seams cages input/traj/mW_cubic.lammpstrj --type 1
The mixed TIP4P frame, oxygen type 2, prints:
nop 250 graph seeded hexagonal 0 cubic 0 both 0 water 250
The 4096-molecule cubic mW cell prints:
nop 4096 graph seeded hexagonal 0 cubic 4096 both 0 water 0
A signature¶
--signature names a face census. 512 is twelve pentagons and
prints 5:12. 51262 is twelve pentagons and two hexagons and prints
5:12,6:2. Other names are 51264, 51268, hc, ddc, sh,
sodalite and alpha. The default face-edge window is 2.65,3.15
in the coordinate units of the file. --cage-edge none keeps every
face from the ring census. --guest-types names the LAMMPS types of
guests. Each guest is assigned to the nearest cage center inside
--guest-radius (default 4.0). The language call is
seams_frame_signature. A window is seams_frame_signature_edge.
On the default graph name seeded, a signature search uses the union
list. The command below reads the structure I cell on the cutoff
graph, the oxygen list used for ice and for the TIP4P oxygens in the
TRACE comparison. Joining names with + prints one line per
signature. The cell is orthogonal, and --cage-edge none on this
command prints the same two lines.
# excerpt: docs/orgmode/user/tutorials/clathrate.org
seams cages input/traj/genice_sI.lammpstrj --type 1 --graph cutoff --signature 512+51262
nop 46 graph cutoff signature 5:12 cages 2 atoms 40
nop 46 graph cutoff signature 5:12,6:2 cages 6 atoms 46
TRACE¶
ClavisCage 0.3.18 runs TRACE, the hydrogen-bond cage search of Hsu
and Lin, J. Chem. Theory Comput. 2025
(10.1021/acs.jctc.5c01459).
The two constructions are
TRACE and signature cages.
d-SEAMS counts \(5^{12}\), \(5^{12}6^{2}\) and \(5^{12}6^{4}\) with
seams cages --signature and seams_frame_signature. It does not
call TRACE.
The comparison places hydrogens 0.96 Å from each oxygen along an
out-degree-2 orientation of the oxygen neighbour graph. TRACE then
uses its default 0.35 nm cutoff and a 35 degree angle. On ice and on
the TIP4P oxygens that graph is the 3.5 Å list. The dense frame
input/traj/dump-l.lammpstrj (512 atoms of type 1) has median degree
56 inside 3.5 Å. TRACE at 0.35 nm does not return on that shell, so
that frame is compared on the four nearest neighbours.
Ideal ice has no five-rings. seams rings on
input/traj/ice1h.lammpstrj and on the cubic mW cell prints only
six-rings, so those three cages are absent. The clathrate cells,
where the cages are present, are the table on
ClavisCage TRACE. The ice
rows are in
Literature head-to-head.