Cage census of sI, sII and sH¶
A clathrate cage is a closed polyhedron of primitive rings. The signature is the face list: \(5^{12}\) is twelve pentagons, and \(5^{12}6^{2}\) adds two hexagons. Counting those polyhedra is how you tell sI from sII from sH. GenIce builds the empty host. Guests would sit in the cages and are left out here, because the census is of the water rings.
The test writes only the oxygen sites into a LAMMPS dump. Hydrogens
and the massless site would change the neighbour list. sI and sII are
orthogonal. sH is skewed, so the dump keeps the tilt. A window that
measured bond lengths as if the box were a rectangle would drop the
long faces. --cage-edge none is why every primitive ring stays
eligible.
meson test docs_paper_cages checks
cages sI 2 6
cages sII 16 8
cages sH 6 4 2
sI, one cell, 46 waters: 2 of \(5^{12}\) and 6 of \(5^{12}6^{2}\). sII, 136 waters: 16 of \(5^{12}\) and 8 of \(5^{12}6^{4}\). sH, the GenIce HS3 cell, 68 waters: 6 of \(5^{12}\), 4 of \(4^{3}5^{6}6^{3}\), and 2 of \(5^{12}6^{8}\). OVITO draws the sI oxygens. The test exits 77 when GenIce or OVITO is absent.
Full run¶
The unit cell is already the right cage. A larger host has to hold
that census times the number of cells, or the count is wrong.
snakemake -s docs/tutorials/Snakefile cages builds sI as 2 by 2 by
2, eight cells and 368 waters, and sII and sH as 2 by 2 by 1, four
cells, 544 and 272 waters. sH keeps its tilt. --cage-edge none
still leaves every primitive ring eligible.
meson test --suite slow docs_paper_cages_full checks
cages full sI 16 48
cages full sII 64 32
cages full sH 24 16 8
The run prints 368, 544 and 272 waters, which are eight sI cells and four sII and sH cells. The paper unit cells are 46, 136 and 68 waters. Eight sI cells hold 16 of \(5^{12}\) and 48 of \(5^{12}6^{2}\). Four sII cells hold 64 of \(5^{12}\) and 32 of \(5^{12}6^{4}\). Four sH cells hold 24 of \(5^{12}\), 16 of \(4^{3}5^{6}6^{3}\), and 8 of \(5^{12}6^{8}\). Each number is the unit-cell count times the number of cells. OVITO draws the sI repeat. The test exits 77 when GenIce, OVITO, or Snakemake is absent.