========================= TRACE and signature cages ========================= TRACE (Hsu and Lin, J. Chem. Theory Comput. 2025, `10.1021/acs.jctc.5c01459 `_) assembles hydrate cages from a hydrogen-bond graph. d-SEAMS answers the oxygen question: which rings tile a closed polyhedron of a given face census. The timed comparison is the how-to `Cages and TRACE <../howto/cages-trace.rst>`_. This page is the two constructions. The hydrogen-bond cage ---------------------- TRACE places one hydrogen :math:`0.96\,\text{Å}` from each oxygen along each of the two nearest oxygen-oxygen bonds, then keeps a bond when the donor-acceptor distance is inside :math:`0.35\,\text{nm}` and the angle at the donor is within :math:`35^\circ` of linear. Cups are grown by depth-first search and closed when the face list matches a hydrate polyhedron. The three census strings used in the sitting are :math:`5^{12}`, :math:`5^{12}6^{2}` and :math:`5^{12}6^{4}`. d-SEAMS does not place those hydrogens and does not call TRACE. On ice, which has no five-rings, both searches report no cage of those three kinds. The numbers are in the rc3 sitting tables. A closed face list ------------------ ``seams_frame_signature`` and ``seams cages --signature`` count a set of primitive rings as one cage when two conditions hold. Every vertex of the surface lies on at least three faces that close around it, and the cell is a topological sphere: .. math:: V - E + F = 2. :math:`F` is the number of faces, :math:`E` the number of distinct edges, and :math:`V` the number of distinct vertices. A ring whose minimum-image bonds sum to a nonzero lattice vector winds through the periodic cell and is dropped before this test. The default face-edge window is :math:`[2.65, 3.15]` in the coordinate units of the file. ``none`` leaves the bound to the census alone. The string ``512`` is twelve pentagons. ``51262`` is twelve pentagons and two hexagons. The C entry that takes the window is ``seams_frame_signature_edge``. Both calls are on :doc:`/stable/cpp`.