# d-SEAMS > d-SEAMS reads molecular-dynamics trajectories and classifies ice with CHILL and CHILL+, topological cages, primitive rings, Steinhardt q_l, and ice and brine fronts. Use it from the command line, a language binding, or a supported simulation engine. Each link below is the Markdown twin of a page on https://docs.dseams.info, served beside the HTML. ## Start - [d-SEAMS](https://docs.dseams.info/index.md): d-SEAMS 2.14 reads a molecular-dynamics trajectory and names the ice in it. ## Getting started - [Getting started](https://docs.dseams.info/getting-started/index.md): Install the engine, then classify one frame. - [Install the engine](https://docs.dseams.info/getting-started/install.md): Release 2.14.0 provides the seams command, libyodaLib, libseams (include/seams.h), and libseams_lang (bindings/cxx/seams_lang.h). - [Quickstart](https://docs.dseams.info/getting-started/quickstart.md): Install the engine, classify one cubic cell, then read one LAMMPS frame. - [Videos](https://docs.dseams.info/videos/index.md): Short screencasts of d-SEAMS in each language and tutorial are hosted on d-SEAMS on Odysee. ## User guide - [User guide](https://docs.dseams.info/user/index.md): Recipes and worked examples, grouped by the job you came to do. - [Classify ice](https://docs.dseams.info/user/classify.md): Name the ice in a frame with CHILL+, cages, or the symmetry classifier. - [Classify ice on the mixed TIP4P example](https://docs.dseams.info/user/tutorials/bulk-ice.md): You classify one in-tree frame two ways: CHILL+ (a staggered or eclipsed star on each oxygen) and cage membership (hexagonal cage or double-diamond cage). - [Ice and clathrate labels](https://docs.dseams.info/user/tutorials/ice-and-clathrate.md): You label one frame two ways. CHILL+ reads a staggered or eclipsed star. - [Classify a clathrate](https://docs.dseams.info/user/tutorials/clathrate.md): Hexagonal cages on ice Ih, double-diamond cages on cubic ice, and the sI, sII and sH census on the repeated cells. - [Classify a dump](https://docs.dseams.info/user/howto/classify-cli.md): You have a LAMMPS water dump and want counts. - [CHILL+](https://docs.dseams.info/user/howto/chill-plus.md): Label every oxygen with the published CHILL+ rule, or with the OVITO rule. - [The symmetry classifier](https://docs.dseams.info/user/howto/symmetry-classifier.md): Name the ice shell of each oxygen. - [Rings, cages, and order](https://docs.dseams.info/user/order.md): Primitive rings, cage signatures, Steinhardt parameters, and the neighbour list they share. - [Primitive rings](https://docs.dseams.info/user/tutorials/rings.md): The recording counts primitive rings on the mixed TIP4P frame, 511 rings, then the 256 six-rings of ice Ih. - [Bond-orientational order parameters](https://docs.dseams.info/user/tutorials/order-parameters.md): The local Steinhardt parameter of atom i is - [Primitive rings](https://docs.dseams.info/user/howto/rings.md): Count primitive rings on a frame you already have. - [Cages and TRACE](https://docs.dseams.info/user/howto/cages-trace.md): Ask which molecules sit in a complete ice cage, or which polyhedra match a ring-size signature. - [Local q4 and q6](https://docs.dseams.info/user/howto/q4-q6.md): Compute the local Steinhardt parameters on the cutoff shell. - [Linkcell neighbours and carried updates](https://docs.dseams.info/user/howto/linkcell-carried.md): Build the cutoff neighbour list, then keep rings when only part of the next frame moved. - [Cutoff neighbour lists](https://docs.dseams.info/user/howto/neighbour-lists.md): Build the cutoff list, choose the thread count, and read the pinned session that compared it with vesin, freud, matscipy, mdapy, and OVITO. - [Choosing a cutoff and padding](https://docs.dseams.info/user/howto/cutoff-padding.md): The neighbour cutoff is the --cutoff of seams chill-plus. - [Interfaces, nucleation, and brine](https://docs.dseams.info/user/interfaces.md): Ice fronts, a growing nucleus, and salt across the interface. - [Ice-water interface](https://docs.dseams.info/user/tutorials/interface.md): The recording labels this basal frame with published CHILL+: hexagonal 352, water 434, and the stack HHHHHHHH....C. - [Nucleation](https://docs.dseams.info/user/tutorials/nucleation.md): The recording reports mean q6-bar on the 148-frame mW trajectory. - [Brine and NaCl](https://docs.dseams.info/user/tutorials/brine.md): The recording follows an ice front through a short brine run, then this 864-water frame with nine ions. - [Basal profiles and the nucleation census](https://docs.dseams.info/user/howto/science-front.md): science-front reads a LAMMPS dump and writes either a basal layer profile or a single-trajectory nucleation census. - [From a trajectory to the ice front](https://docs.dseams.info/user/howto/from-trajectory.md): You have a trajectory and want CHILL+ labels, the primitive rings, and the position of the ice front. - [Ionic-liquid dumps](https://docs.dseams.info/user/howto/ionic-liquid.md): An ionic-liquid dump is a multi-type frame, and CHILL is the wrong score for the ions. - [Confined ice](https://docs.dseams.info/user/confined.md): Ice in a nanotube or a monolayer, and a triclinic cell whose edge lengths are not the bound spans. - [Confined water](https://docs.dseams.info/user/tutorials/confined-water.md): Quasi-one-dimensional ice is a stack of prism blocks. - [Quasi-one-dimensional ice](https://docs.dseams.info/user/tutorials/nanotube.md): A nanotube ice is a stack of prism blocks of one ring size. - [Confined ice](https://docs.dseams.info/user/howto/confined-ice.md): Classify ice in a nanotube or a monolayer. - [Sheared cells](https://docs.dseams.info/user/howto/sheared-cells.md): You have a triclinic LAMMPS dump and want the engine to use the real cell, not a diagonal of bound spans. - [Engines](https://docs.dseams.info/user/engines.md): Read a trajectory from LAMMPS, GROMACS, OpenMM, or PLUMED, or label the frame inside the run. - [Run in situ](https://docs.dseams.info/user/tutorials/insitu-run.md): The recording scores the ice Ih cell: 128 hexagonal labels, 256 six-rings, and mean local q6 0.625855. - [LAMMPS](https://docs.dseams.info/user/howto/engine-lammps.md): Build run_hook against conda-forge LAMMPS from 2024.8.29 up through the 2025 releases. - [GROMACS](https://docs.dseams.info/user/howto/engine-gromacs.md): Build gmx-seams against conda-forge GROMACS 2026.3, or a later 2026 release. - [OpenMM](https://docs.dseams.info/user/howto/engine-openmm.md): Build the reporter against conda-forge OpenMM 8.6.1 or a later 8 release. - [PLUMED](https://docs.dseams.info/user/howto/engine-plumed.md): The thread count comes from PLUMED_NUM_THREADS. - [In-situ CHILL+](https://docs.dseams.info/user/howto/engine-insitu.md): InSitu in adapters/python/dseams_insitu/engine.py classifies one frame during a run. - [OpenMP target offload](https://docs.dseams.info/user/howto/openmp-offload.md): Build the Steinhardt kernel and the TUM ice score (hop-bound six-rings and cage affiliation) for an NVIDIA GPU. - [Engine builds](https://docs.dseams.info/engines/index.md) - [LAMMPS](https://docs.dseams.info/engines/lammps.md): Meson builds run_hook, the in-run hook. - [GROMACS](https://docs.dseams.info/engines/gromacs.md): engines/gromacs/seams_ice.cpp is a TrajectoryAnalysisModule. - [OpenMM](https://docs.dseams.info/engines/openmm.md): There is one reporter, DseamsReporter in adapters/python/dseams_insitu/openmm.py. - [PLUMED](https://docs.dseams.info/engines/plumed.md): The d-SEAMS PLUMED plugin egg (plumID:26.018) uses v0.4.1 of the dseams-plumed repository. - [In-situ](https://docs.dseams.info/engines/insitu.md): adapters/python/dseams_insitu/engine.py is InSitu. - [Engine walkthroughs](https://docs.dseams.info/walkthrough/index.md): Each page analyzes a supplied input with published CHILL+, the primitive six-ring histogram, and local q6. - [Language walkthroughs](https://docs.dseams.info/user/languages.md): The same ice cell from C, C++, and each binding, and from each engine driver. - [C tutorial](https://docs.dseams.info/fronts/c.md): Label the eight-atom cubic cell with seams.h and print the library version. - [C++ tutorial](https://docs.dseams.info/fronts/cpp.md): Classify the eight-atom cubic cell with include/seams.hpp, then the ice Ih dump. - [Fortran](https://docs.dseams.info/fronts/fortran.md): Classify ice Ih from Fortran. The recording uses input/traj/ice1h.lammpstrj: seams read prints nop 128, and published CHILL+ at a 3.5 angstrom cutoff prints nop 128 hexagonal 128. - [Julia](https://docs.dseams.info/fronts/julia.md): Classify ice Ih from Julia. The recording uses input/traj/ice1h.lammpstrj: seams read prints nop 128, and published CHILL+ at a 3.5 angstrom cutoff prints nop 128 hexagonal 128. - [Lua and Fennel](https://docs.dseams.info/fronts/lua.md): Classify a frame from Lua or Fennel. The recording follows require("dseams") and the same call from Fennel. - [Python](https://docs.dseams.info/fronts/python.md): Classify ice Ih from Python. The recording uses input/traj/ice1h.lammpstrj: seams read prints nop 128, and published CHILL+ at a 3.5 angstrom cutoff prints nop 128 hexagonal 128. - [R](https://docs.dseams.info/fronts/r.md): Classify ice Ih from R. The recording uses input/traj/ice1h.lammpstrj: seams read prints nop 128, and published CHILL+ at a 3.5 angstrom cutoff prints nop 128 hexagonal 128. - [Rust](https://docs.dseams.info/fronts/rust.md): Classify ice Ih from Rust. The recording uses input/traj/ice1h.lammpstrj: seams read prints nop 128, and published CHILL+ at a 3.5 angstrom cutoff prints nop 128 hexagonal 128. - [Engines tutorial](https://docs.dseams.info/fronts/engines.md): Eight molecules of cubic ice are in engines/tutorial/ice.data. - [GROMACS tutorial](https://docs.dseams.info/fronts/gromacs.md): gmx-seams reads a trajectory after gmx mdrun and classifies it with seams_chill_plus. - [In-situ tutorial](https://docs.dseams.info/fronts/insitu.md): Eight cubic-ice atoms, one observation through InSitu.observe. - [LAMMPS tutorial](https://docs.dseams.info/fronts/lammps.md): engines/lammps/in.dseams is a frozen cubic cell of 64 atoms. - [OpenMM tutorial](https://docs.dseams.info/fronts/openmm.md): DseamsReporter in adapters/python/dseams_insitu/openmm.py asks for positions every interval and calls InSitu.observe. - [PLUMED tutorial](https://docs.dseams.info/fronts/plumed.md): Use the PLUMED engine page to get the d-SEAMS PLUMED plugin v0.4.1. - [Versions and bindings](https://docs.dseams.info/user/versions.md): Move a 1.x script or a 2.13 install onto this release, and find the catalogue of tutorials and tasks. - [Upgrade from 2.13 to 2.14](https://docs.dseams.info/user/howto/upgrade-2.14.md): These notes cover the step from 2.13.0 to 2.14.0. - [Migrate from d-SEAMS 1.x](https://docs.dseams.info/user/howto/migrate-1x.md): 1.x was a Lua script plus yodaStruct -c lua_inputs/config.yml. - [Use a language binding](https://docs.dseams.info/user/howto/bindings.md): This repository builds the engine, the C API libseams (include/seams.h), the C ABI libseams_lang (bindings/cxx/seams_lang.h), and the seams command. - [FAQ](https://docs.dseams.info/user/howto/faq.md): Install the engine. From a checkout, pixi run build writes ./bbdir/seams. - [Troubleshooting](https://docs.dseams.info/user/howto/troubleshooting.md): Two commands on the bundled frames: - [Worked examples](https://docs.dseams.info/user/tutorials/index.md): A tutorial is a learning path. - [Tasks](https://docs.dseams.info/user/howto/index.md): A how-to solves a goal you already have. - [Paper figures](https://docs.dseams.info/user/paper.md): The in-tree numbers behind the published figures, and the gallery drawn from those runs. - [Paper figures](https://docs.dseams.info/user/tutorials/paper-figures.md): The 2020 JCIM figures are drawn from figshare project 73545. - [CHILL+ on an ice/water slab](https://docs.dseams.info/user/tutorials/paper-interface.md): An interface is where a rule is easy to fool. - [Cage census of sI, sII and sH](https://docs.dseams.info/user/tutorials/paper-cages.md): A clathrate cage is a closed polyhedron of primitive rings. - [Primitive rings and the shortest-path test](https://docs.dseams.info/user/tutorials/paper-rings.md): A ring search first walks every simple cycle up to a chosen size. - [Ice growing into brine](https://docs.dseams.info/user/tutorials/paper-brine.md): The front is the height where the crystal slabs stop. - [Ice-likeness along a short nucleation run](https://docs.dseams.info/user/tutorials/paper-nucleation.md): Ice-likeness here is the mean Lechner-Dellago \bar q_6. - [Science gallery](https://docs.dseams.info/user/tutorials/gallery.md): These pictures show the interface, brine, ring, cage, and nucleation examples. - [Science tutorials](https://docs.dseams.info/science/index.md): Three calculations from the papers: an ice-water interface, a brine freezing front, and the sII and sH cages. - [Ice/liquid interface and nucleation](https://docs.dseams.info/science/interface.md): The interface dump is input/traj/interface_f0.lammpstrj, 864 waters in a cell 23 by 22 by 53 angstrom. - [Brine freezing front](https://docs.dseams.info/science/brine.md): The d-SEAMS/brine-front-230K dataset provides the initial and final frames for a 20-pair loading. - [sII and sH hydrate cages](https://docs.dseams.info/science/cages.md): input/traj/genice_sII.lammpstrj and input/traj/genice_sH.lammpstrj are guest-free GenIce hosts, 136 waters each. - [Science figures](https://docs.dseams.info/science/gallery.md): These four molecular views accompany the science tutorials. - [Performance and comparisons](https://docs.dseams.info/user/performance.md): What to time, how the literature codes were run, and where d-SEAMS sits next to them. - [Benchmarks](https://docs.dseams.info/user/howto/benchmarks.md): Time a 2.14.0 build and write down the run. - [Literature head-to-head](https://docs.dseams.info/user/howto/literature-h2h.md): Two recorded comparisons of d-SEAMS 2.14.0. - [Reproduce the literature head-to-head](https://docs.dseams.info/user/howto/literature-reproduce.md): scripts/h2h_rc3_sitting.py writes the six-call sitting. - [Head-to-head](https://docs.dseams.info/user/comparisons.md): Measured comparisons of d-SEAMS 2.14.0 with other structure codes. - [Concepts](https://docs.dseams.info/explanation/index.md): These pages are for understanding. - [Architecture](https://docs.dseams.info/explanation/architecture.md): 0 is one C++ engine, libyodaLib. - [Binding overhead](https://docs.dseams.info/explanation/binding-overhead.md): Ice Ih at 4096, 32768, and 110592 molecules. - [The C API](https://docs.dseams.info/explanation/c-api.md): include/seams.h is ABI 1 of libseams. - [CHILL+: the published rule and the OVITO rule](https://docs.dseams.info/explanation/chill-plus-rules.md): Nguyen and Molinero, /J. Phys. Chem. B/ 2015, 119, 9369 (10.1021/jp510289t), equation 1 averages q_3 over the four nearest neighbours of a shell that already holds four neighbours inside the cutoff. - [CHILL+ versus cages](https://docs.dseams.info/explanation/chill-plus-vs-cages.md): Two classifiers in the engine library libyodaLib answer different questions. - [Citation](https://docs.dseams.info/explanation/citation.md): If you use this software, cite the methods paper. - [ClavisCage TRACE](https://docs.dseams.info/explanation/clavis-trace.md): ClavisCage 0.3.18 runs TRACE (Hsu and Lin, J. Chem. Theory Comput. 2025, 10.1021/acs.jctc.5c01459) on the same hydrate cells as d-SEAMS 2.14.0. - [Carried rings and the hop ball](https://docs.dseams.info/explanation/hop-ball.md): primitive::RingUpdater returns the primitive rings of one neighbour graph. - [Interface and confined ice](https://docs.dseams.info/explanation/interface-order.md): Two published CHILL+ rules, on the same coordinates, with the thresholds left alone. - [Linkcell strong scaling](https://docs.dseams.info/explanation/linkcell-scaling.md): The linkcell manual is linkcell.dseams.info. - [Primitive rings and OVITO FindRings](https://docs.dseams.info/explanation/ovito-findrings.md): A ring is primitive when every pair of its vertices is as close along the ring as it is through the rest of the graph. - [Release-candidate sitting](https://docs.dseams.info/explanation/performance.md): The tables are the release-candidate sitting of d-SEAMS 2.14.0. - [Performance](https://docs.dseams.info/explanation/performance-h2h.md): Head-to-head times for ice Ic and a TIP4P/ice liquid at 884736 molecules. - [Performance overview](https://docs.dseams.info/explanation/performance-overview.md): Each median is printed on one page. - [Performance, 4096 to 110592](https://docs.dseams.info/explanation/performance-range.md): Neighbour lists and primitive rings from the comparisons other than the release-candidate sitting and the 884736-molecule head-to-head. - [Primitive rings and the full graph](https://docs.dseams.info/explanation/primitive-rings.md): A ring is primitive when the graph distance between every pair of its vertices equals the shorter distance along the ring. - [Ring-adjacent completion](https://docs.dseams.info/explanation/ring-completion.md): ring::ringAdjacentCompletion fills a single vacancy on a labeled six-ring. - [Rings on one thread](https://docs.dseams.info/explanation/rings-one-thread.md): primitive::ringNetwork against OVITO 3.17.2 FindRingsModifier. - [SQQ](https://docs.dseams.info/explanation/sqq.md): SQQ 0.5.8 counts shortest-path chordless rings of size 4, 5 and 6. - [Stacking disorder](https://docs.dseams.info/explanation/stacking-disorder.md): Cubic ice and hexagonal ice are the same puckered hexagons stacked in two orders. - [Local symmetry](https://docs.dseams.info/explanation/symmetry.md): The classifier names each oxygen as ice Ih, ice Ic, stacking-disordered ice, or unmatched, and it can name a hydrate cage or a five- or six-ring when one cluster is passed in. - [Topological network criteria](https://docs.dseams.info/explanation/topological-network.md): These are the criteria the classifiers use. - [TRACE and signature cages](https://docs.dseams.info/explanation/trace-assembly.md): TRACE (Hsu and Lin, J. Chem. Theory Comput. 2025, 10.1021/acs.jctc.5c01459) finds hydrate cages on a hydrogen-bond graph. - [Signature-search thread controls](https://docs.dseams.info/explanation/trace-threads.md): The signature search reads one OpenMP width, and the neighbour list may narrow it. ## API reference - [API reference](https://docs.dseams.info/reference/index.md): Lookup pages for the engine. Tutorials and how-tos live elsewhere. - [Python Frame](https://docs.dseams.info/reference/python-frame.md): dseams.userframe.read in pydseamslib 2.14.0 returns a Frame over libseams_lang. - [seams CLI](https://docs.dseams.info/reference/cli.md): The engine command is seams. The parser is Argum. Help, errors, ice-type counts, and --features are colorized through Argum's environmentColorStatus. - [Data Formats](https://docs.dseams.info/reference/data-formats.md): seams and the C++ readers share one suffix table. - [walk_compare](https://docs.dseams.info/reference/walk-compare.md): tests/walk_compare walks a LAMMPS dump and prints one row per frame. - [API map](https://docs.dseams.info/reference/api.md): Lookup for the C++ identifiers in src/include/internal. - [Nix flake](https://docs.dseams.info/reference/nix.md): The flake builds libyodaLib and the seams CLI with Meson. It does not build Python or Lua. There are no overlays. - [One task on every front](https://docs.dseams.info/reference/cross-language.md): The task is CHILL+ on frame 1 of input/traj/mW_cubic.lammpstrj, LAMMPS type 1. - [Glossary](https://docs.dseams.info/reference/glossary.md) - [2.14.0 release notes](https://docs.dseams.info/reference/release-2.14.md): These notes describe the user-visible changes since d-SEAMS 2.13.0. - [C API](https://docs.dseams.info/capi/index.md): Every SEAMS_API function in include/seams.h. - [C](https://docs.dseams.info/stable/c.md): seams.h is ABI 1 of libseams. A handle is opaque. - [C++](https://docs.dseams.info/stable/cpp.md): include/seams.hpp is the header-only C++ API. - [Python](https://docs.dseams.info/stable/python.md): pydseamslib provides import dseams and import pydseams. - [Fortran](https://docs.dseams.info/stable/fortran.md): The Fortran binding is the fpm Git dependency dseams in d-SEAMS/dseams-fortran. - [Julia](https://docs.dseams.info/stable/julia.md): Both live in d-SEAMS/Dseams.jl. - [R](https://docs.dseams.info/stable/r.md): The R package dseams is d-SEAMS/dseams-r. - [Lua and Fennel](https://docs.dseams.info/stable/lua.md): The Lua and Fennel library is d-SEAMS/yodaStruct. - [Rust](https://docs.dseams.info/stable/rust.md): Both live in d-SEAMS/dseams-rs. - [Command line](https://docs.dseams.info/stable/cli.md): seams reads a trajectory and prints one result. - [Science front](https://docs.dseams.info/stable/science.md): src/include/internal/science_front.hpp is the C++ layer profile and the single-trajectory critical size. - [Language APIs](https://docs.dseams.info/lang/index.md): seams-core documents the C API and the C++ front here. ## Project - [Changelog](https://docs.dseams.info/development/changelog.md): Release notes for the d-SEAMS engine. ## Language bindings - [PydSEAMSlib](https://github.com/d-SEAMS/PydSEAMSlib): Install the Python binding with pip install pydseamslib==2.14.0. - [yodaStruct](https://github.com/d-SEAMS/yodaStruct): Clone the Lua and Fennel binding, then run luarocks make in the checkout. - [dseams-r](https://github.com/d-SEAMS/dseams-r): Install the R binding with remotes::install_github("d-SEAMS/dseams-r"). - [Dseams.jl](https://github.com/d-SEAMS/Dseams.jl): Install the Julia binding with Pkg.add(url="https://github.com/d-SEAMS/Dseams.jl"). - [dseams-rs](https://github.com/d-SEAMS/dseams-rs): Install the Rust binding with cargo add dseams@2.14.0. - [dseams-fortran](https://github.com/d-SEAMS/dseams-fortran): Add the Fortran binding as an fpm Git dependency. ## PLUMED plugin - [PLUMED-NEST egg](https://www.plumed-nest.org/eggs/26/018/): d-SEAMS PLUMED plugin v0.4.1, plumID:26.018, tested with PLUMED v2.10 and master. - [dseams-plumed](https://github.com/d-SEAMS/dseams-plumed): Companion repository for the d-SEAMS PLUMED plugin v0.4.1. ## Optional - [Full manual in one file](https://docs.dseams.info/llms-full.txt): Every page of the manual, concatenated, for a long context. - [Project site](https://dseams.info): The d-SEAMS project page.