============================= Cage census of sI, sII and sH ============================= A clathrate cage is a closed polyhedron of primitive rings. The signature is the face list: :math:`5^{12}` is twelve pentagons, and :math:`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 .. code:: text cages sI 2 6 cages sII 16 8 cages sH 6 4 2 sI, one cell, 46 waters: 2 of :math:`5^{12}` and 6 of :math:`5^{12}6^{2}`. sII, 136 waters: 16 of :math:`5^{12}` and 8 of :math:`5^{12}6^{4}`. sH, the GenIce HS3 cell, 68 waters: 6 of :math:`5^{12}`, 4 of :math:`4^{3}5^{6}6^{3}`, and 2 of :math:`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 .. code:: text 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 :math:`5^{12}` and 48 of :math:`5^{12}6^{2}`. Four sII cells hold 64 of :math:`5^{12}` and 32 of :math:`5^{12}6^{4}`. Four sH cells hold 24 of :math:`5^{12}`, 16 of :math:`4^{3}5^{6}6^{3}`, and 8 of :math:`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.