d-SEAMS d-SEAMS d-SEAMS
  • C++ API
    • d-SEAMS engine libyodaLib and the seams CLI
    • PydSEAMSlib (Python) pydseamslib: import dseams and import pydseams
    • yodaStruct (Lua, Fennel) require("dseams")
    • dseams-r (R) The R package dseams
    • Dseams.jl (Julia) The Julia package Dseams
    • dseams-rs (Rust) The crates dseams-sys and dseams
    • dseams-fortran (Fortran) The fpm package dseams
    • linkcell Periodic linked-cell k-nearest neighbours
/

Getting started

  • Quickstart
  • Install the engine
  • Videos

Tutorials

  • Worked examples
  • Classify a clathrate
  • Ice-water interface
  • Nucleation
  • Brine and NaCl
  • Run in situ
  • Classify ice on the mixed TIP4P example
  • Ice and clathrate labels
  • Primitive rings
  • Bond-orientational order parameters
  • Confined water
  • Quasi-one-dimensional ice
  • Paper figures
  • CHILL+ on an ice/water slab
  • Cage census of sI, sII and sH
  • Primitive rings and the shortest-path test
  • Ice growing into brine
  • Ice-likeness along a short nucleation run
  • Science gallery
  • Science tutorials
  • Ice/liquid interface and nucleation
  • Brine freezing front
  • sII and sH hydrate cages
  • Science figures
  • Language tutorials
  • C tutorial
  • C++ tutorial
  • Fortran
  • Julia
  • Lua and Fennel
  • Python
  • R
  • Rust
  • Engines tutorial
  • GROMACS tutorial
  • In-situ tutorial
  • LAMMPS tutorial
  • OpenMM tutorial
  • PLUMED tutorial

How-to

  • Tasks
  • Upgrade from 2.13 to 2.14
  • Migrate from d-SEAMS 1.x
  • Use a language binding
  • Version pins
  • Benchmarks
  • Cutoff neighbour lists
  • OpenMP target offload
  • Classify a dump
  • Primitive rings
  • Cages and TRACE
  • Local q4 and q6
  • CHILL+
  • Choosing a cutoff and padding
  • The symmetry classifier
  • Linkcell neighbours and carried updates
  • Sheared cells
  • Ionic-liquid dumps
  • Confined ice
  • Basal profiles and the nucleation census
  • From a trajectory to the ice front
  • GROMACS
  • LAMMPS
  • OpenMM
  • PLUMED
  • In-situ CHILL+
  • FAQ
  • Troubleshooting
  • Engine walkthroughs

Reference

  • Lookup pages
  • Python Frame
  • seams CLI
  • Data Formats
  • walk_compare
  • API map
  • Nix flake
  • One task, four fronts
  • Glossary
  • 2.14.0 release notes
  • Stable API
  • C
  • C++
  • Python
  • Fortran
  • Julia
  • R
  • Lua and Fennel
  • Rust
  • Command line
  • Science front
  • C API
  • Language APIs
  • API Reference

Engines

  • Engine builds
  • LAMMPS
  • GROMACS
  • OpenMM
  • PLUMED
  • In-situ

Comparisons

  • Head-to-head
  • ClavisCage TRACE
  • SQQ
  • Primitive rings and OVITO FindRings
  • Performance
  • Literature head-to-head
  • Reproduce the literature head-to-head

Explanation

  • Concepts
  • Repositories
  • The C API
  • CHILL+ versus cages
  • CHILL+: the published rule and the OVITO rule
  • Interface and confined ice
  • Ring-adjacent completion
  • Primitive rings and the full graph
  • Linkcell strong scaling
  • Rings on one thread
  • Topological network criteria
  • Local symmetry
  • TRACE and signature cages
  • Stacking disorder
  • Carried rings and the hop ball
  • Signature-search thread controls
  • Release-candidate sitting
  • Performance overview
  • Binding overhead
  • Performance, 4096 to 110592

Project

  • Changelog
  • Contributing
  • Repository map
  • Release process
  • Lean proofs
  • Citation
  • class nneigh::CutoffSkin
  • class nneigh::SkinNeighborList
  • class primitive::RingUpdater
  • class ring::AffiliationUpdater
  • class ring::NeighBond
  • class seams::Brine
  • class seams::Cages
  • class seams::Error
  • class seams::FairWidth
  • class seams::Fingerprint
  • class seams::Neighbours
  • class seams::Rings
  • class seams::Rings::iterator
  • class seams::System
  • template class seams::detail::Handle
  • enum cage::Signature::Kind
  • enum cage::cageType
  • enum cage::iceType
  • enum chill::ChillPlusRule
  • enum chill::CrystalKind
  • enum iface::Cause
  • enum iface::Kind
  • enum molSys::atom_state_type
  • enum molSys::bond_type
  • enum nneigh::BondGraph
  • enum nucleation::CommittorFate
  • enum phase::GlassKind
  • enum primitive::RingRows
  • enum ring::strucType
  • enum seams::product::Int8Backend
  • enum seams::product::Mode
  • enum seams::product::Reduction
  • enum site::Family
  • enum site::IonState
  • enum site::Kind
  • enum symm::Crystal
  • enum symm::Kind
  • enum water::MolMode
  • Generated anchors
  • seams_system_set_atoms
  • seams_system_set_positions
  • seams_handle_error
  • seams_status
  • seams_system
  • seams::CageLabel
  • seams::Status
  • seams::ChillRule
  • seams::DomainSubset
  • seams::Graph
  • seams::Axis
  • seams::set_num_threads
  • group__seams__cpp_1gga67eb3c576e152683e1fb0b0092e753c0a9b9d8a976b42e0bd66381797644943d5
  • group__seams__cpp_1ggaa26c5e09631ed2e863d7ba9069e64683a6f575a49d4e9449dbfc22f0c1753384d
  • group__seams__cpp_1ggaadb6ab84dae1fdc4c8b8c9808622ababa30fa4b9595875c0498e063b76870c5e0
  • group__seams__cpp_1ggaadb6ab84dae1fdc4c8b8c9808622abababc5449e9092ea92f5393be6516916084
  • group__seams__cpp_1ggab0a343eee2fee14066d1e497e54cfb82a21c2e59531c8710156d34a3c30ac81d5
  • Global Namespace
  • Bond
  • Cage
  • Ice/brine fronts
  • Cages and ice shells
  • Frames
  • Frame reload and read-back
  • Library metadata and errors
  • Further analyses
  • Neighbour lists
  • Order parameters
  • Rings
  • Status-returning and length-checked entry points
  • Types
  • Chill
  • Clump
  • Gen
  • MolSys
  • Nneigh
  • Primitive
  • Bulk prisms
  • Rdf
  • Rdf2
  • Ring
  • C++ API
  • Sinp
  • namespace absor
  • namespace bond
  • namespace cage
  • namespace chill
  • namespace chordless
  • namespace clump
  • namespace gen
  • namespace gen::mic
  • namespace gpu
  • namespace iface
  • namespace ira
  • namespace match
  • namespace molSys
  • namespace nneigh
  • namespace nucleation
  • namespace phase
  • namespace pntToPnt
  • namespace primitive
  • namespace prism3
  • namespace rdf
  • namespace rdf2
  • namespace ring
  • namespace science
  • namespace seams
  • namespace seams::cfg
  • namespace seams::cpu
  • namespace seams::detail
  • namespace seams::domain
  • namespace seams::minimax
  • namespace seams::product
  • namespace seams::solid
  • namespace seams::sphericart_ylm
  • namespace seams::steinhardt
  • namespace seams::tsan
  • namespace seams::wigner
  • namespace seams::ylm
  • namespace sinp
  • namespace site
  • namespace sout
  • namespace sph
  • namespace std
  • namespace symm
  • namespace symm::avx2
  • namespace symm::generic
  • namespace topo
  • namespace topoparam
  • namespace tum
  • namespace tum3
  • namespace tum::device
  • namespace water
  • struct cage::Cage
  • struct cage::CageShape
  • struct cage::EdgeWindow
  • struct cage::FormerRow
  • struct cage::FoundCage
  • struct cage::Signature
  • struct chill::AnalysisPhases
  • struct chill::BondClassifier
  • struct chill::BondOrder
  • struct chill::ChillPlusResult
  • struct chill::LinearClassifier
  • struct chill::QlCutoffStages
  • struct chill::QlmAtom
  • struct chill::SteinhardtQl
  • struct chill::TemplateHit
  • struct chill::VoronoiWeights
  • struct chill::YlmAtom
  • struct clump::Domain
  • struct gen::FracBox
  • struct gpu::BatchResult
  • struct gpu::DeviceInfo
  • struct gpu::Footprint
  • struct gpu::Plan
  • struct iface::Bin
  • struct iface::BootstrapInterval
  • struct iface::Front
  • struct iface::Growth
  • struct iface::GrowthFrame
  • struct iface::Profile
  • struct iface::Study
  • struct iface::WillardChandler
  • struct ira::Match
  • struct ira::PointGroup
  • template struct molSys::Point
  • template struct molSys::PointCloud
  • struct molSys::Result
  • struct nucleation::Ascent
  • struct nucleation::CommittorCall
  • struct nucleation::FrameRecord
  • struct nucleation::GrowBasin
  • struct nucleation::HalfRise
  • struct nucleation::Lead
  • struct nucleation::Shift
  • struct phase::IceXXIHit
  • struct primitive::Graph
  • struct primitive::RingSearchSplit
  • struct primitive::Vertex
  • struct rdf::PartialRdf
  • struct ring::CageAffiliation
  • struct ring::DdcSplit
  • struct ring::EquatorChoice
  • struct ring::PackParts
  • struct ring::PackingCertificate
  • struct ring::RingSearchIndex
  • struct ring::SeededAtomLabels
  • struct ring::StackingPlanes
  • struct science::AtomRow
  • struct science::ClusterPart
  • struct science::CriticalSize
  • struct science::Front
  • struct science::LayerRow
  • struct science::Layers
  • struct science::NucleusFrame
  • struct science::SlopeInterval
  • struct seams::BondOptions
  • struct seams::BrineFronts
  • struct seams::BrineOptions
  • struct seams::BrineProfile
  • struct seams::CageCounts
  • struct seams::CageOptions
  • struct seams::ChillOptions
  • struct seams::ChordlessCycles
  • struct seams::Classification
  • struct seams::Contacts
  • struct seams::DensityOptions
  • struct seams::DensityProfile
  • struct seams::Distribution
  • struct seams::DistributionOptions
  • struct seams::DomainOptions
  • struct seams::DomainReport
  • struct seams::EdgeSet
  • struct seams::FairState
  • struct seams::FingerprintOptions
  • struct seams::KnnOptions
  • struct seams::NeighbourOptions
  • struct seams::OrderOptions
  • struct seams::Pockets
  • struct seams::PrismCensus
  • struct seams::PrismOptions
  • struct seams::Q4Q6
  • struct seams::Q6Bar
  • struct seams::Q6BarOptions
  • struct seams::Rejection
  • struct seams::RingOptions
  • struct seams::RunningCoordination
  • struct seams::SheetOptions
  • struct seams::SignatureMatch
  • struct seams::SignatureOptions
  • struct seams::Steinhardt
  • struct seams::SteinhardtOptions
  • struct seams::TeamWidth
  • struct seams::cfg::Runtime
  • struct seams::cpu::Features
  • struct seams::domain::RingPhases
  • struct seams::domain::RingSummary
  • struct seams::domain::Share
  • struct seams::product::Cij
  • struct seams::product::ComplexDot
  • struct seams::product::GemmInfo
  • struct seams::product::RealDot
  • struct seams::tsan::Slot
  • struct site::BrinePocket
  • struct site::ConcentrationBin
  • struct site::ConcentrationProfile
  • struct site::DensityZ
  • struct site::FrontLayerReport
  • struct site::FrontOptions
  • struct site::FrontPair
  • struct site::FrontSnapshot
  • struct site::GuestOccupancy
  • struct site::IceClusterIons
  • struct site::InsideTrace
  • struct site::IonEnvironment
  • struct site::LinearFit
  • struct site::PocketCensus
  • struct site::RejectionCoefficient
  • struct site::Table
  • struct site::TrapEvent
  • struct symm::CanonShell
  • struct symm::Group
  • struct symm::Lattice
  • struct symm::Overlay
  • struct symm::Shell17
  • struct symm::Space
  • struct topo::FrameFingerprint
  • struct topo::KeyLibrary
  • struct topo::LibraryMatch
  • struct topo::LocalKey
  • struct topoparam::LayerStack
  • struct tum::CageCounts
  • struct tum::SpecializedCaps
  • struct water::IonReport
  • struct water::IonSite
  • struct water::Request
  • struct water::Selection
  • ClavisCage TRACE
  • Head-to-head summary
  • Full cutoff ring call
  • 884736 sitting, ice and liquid
  • Neighbours
  • Rings
  • Rings against cycless
  • Rings against SQQ
  • q6
  • q6 against OVITO
  • CHILL+
  • Cages
  • PTM
  • Linkcell scaling
  • What each file holds
  • rc3 sitting, one thread against eight
  • 884736-molecule sitting, one thread against eight
  • signature search, one thread against eight
  • pool-sized kernels, one thread against eight
  • Pool audit at 4096 molecules, four threads against eight
  • binding-overhead.csv
  • h2h-ice-ic-rings-n16.csv
  • h2h-ice-ic-rings.csv
  • h2h-literature.csv
  • h2h-summary.csv
  • h2h-watch-v12.csv
  • h2h-watch-v13.csv
  • h2h-watch-v2.csv
  • h2h-watch-v3.csv
  • h2h-watch-v4.csv
  • h2h-watch-v6-sqq.csv
  • h2h-watch-v7.csv
  • h2h-watch.csv
  • rank-scale.csv
  • rc2perf-literature.csv
  • rc3-sitting.csv
  • thread-scale.csv
  • weak-scale.csv
  • sitting-large.csv
  • neighbours
  • q4
  • q6
  • CHILL+
  • rings
  • cages
  • PTM
  • king
  • ice Ic, 4096 molecules
  • ice Ic, 32768 molecules
  • ice Ic, 110592 molecules
  • ice Ic, 884736 molecules
  • 884736 molecules, rings
  • 884736 molecules, q4
  • 884736 molecules, q6
  • 884736 molecules, q4+q6
  • 884736 molecules, neighbours
  • 884736 molecules, coordination
  • 884736 molecules, chill+
  • 884736 molecules, classifier
  • 884736 molecules, ptm-default
  • 884736 molecules, ptm-ice
  • SQQ
  • signature cages, sI
  • signature cages, sII
  • The bulk-liquid gate
  • Summary rows
  • Layers whose label changed
  • Classify timings
  • One thread against eight
  • Neighbours against OVITO
  • Full cutoff ring call
  • Added
  • Changed
  • Deprecated
  • Removed
  • Fixed
  • Interface slab
  • Brine frame
  • Ice Ih six-rings
  • Nucleation nucleus
  • sI and sII cages
  • Molecule stills

On this page

  • Interface slab
  • Brine frame
  • Ice Ih six-rings
  • Nucleation nucleus
  • sI and sII cages
    • Molecule stills
seams-core 0 0
Edit this page
  1. d-SEAMS /
  2. Science gallery
View Source Open in ChatGPT Open in Claude

Science gallery¶

The pictures are drawn when the book is built, from the same full runs the slow tutorial tests check. OVITO’s Python renderer colors the atoms. When OVITO is missing, matplotlib draws the same coordinates in 3D. The image files are produced in the build and are not stored in the repository.

Each caption says what the colors mean and repeats the numbers the tutorial test asserts. meson test docs_gallery builds the images and checks those numbers against the tutorial reports.

Interface slab¶

Interface slab

The picture is the 864-molecule paper frame, colored by published CHILL+. Published CHILL+ reports hexagonal 352 interfacial 49 water 434 clathrate 3 interClathrate 25. The OVITO rule reports hexagonal 346 interfacial 57 water 437 clathrate 3 interClathrate 20. Hexagonal ice is orange and liquid water is sky blue. The interfacial shell is where the two rules part.

interface full input molecules 864 frames 1 file-frames 1 file input/traj/interface_f0.lammpstrj
interface full paper molecules 864 frames 1
interface full published hexagonal 352 interfacial 49 water 434 clathrate 3 interClathrate 25
interface full ovito hexagonal 346 interfacial 57 water 437 clathrate 3 interClathrate 20
interface full phi-c 0.00283286
interface full stack HHHHHHHH....C.

Brine frame¶

Brine frame

The picture is the shipped brine frame, 864 waters and 9 ions. Sodium is vermillion and chloride is blue. Waters 864 ions 9 hexagonal 352 water 434.

brine full input molecules 873 frames 1 file-frames 1 file input/traj/nacl_front.lammpstrj
brine full paper waters 864 ions 9 frames 1
brine full waters 864 ions 9 hexagonal 352 water 434

Ice Ih six-rings¶

Ice Ih six-rings

The picture is frame 1 of the 4096-molecule mW dump. The drawn bonds are the cutoff neighbours, and in this frame they close six-rings. The histogram is 6 8192. That frame has two six-rings per molecule.

rings full input molecules 4096 frames 1 file-frames 11 file input/traj/mW_cubic.lammpstrj
rings full paper molecules 4096 frames 1 rings 8192
rings full nop 4096 rings 8192
rings full histogram 6 8192

Nucleation nucleus¶

Nucleation nucleus

Each molecule is colored by its own q6bar on frame 2 of the 148-frame paper trajectory. Dark blue is liquid-like and yellow is ice-like. frame 1 q6bar 0.26063. frame 148 q6bar 0.287256.

nucleation full input molecules 4096 frames 148 file-frames 148 file docs/.cache/figshare-11448702/nucleation.lammpstrj
nucleation full paper molecules 4096 frames 148
nucleation full frame 1 q6bar 0.26063
nucleation full frame 148 q6bar 0.287256
nucleation full lines 148

sI and sII cages¶

sI and sII cages
sI and sII cages

The first cluster is sI and the second cluster is sII. Bonds draw the water rings that close the cages. sI holds 16 of the small cage and 48 of the large cage. sII holds 64 of the small cage and 32 of the large cage.

cages full input sI molecules 368 frames 1 file sI-full.lammpstrj
cages full sI 16 48
cages full input sII molecules 544 frames 1 file sII-full.lammpstrj
cages full sII 64 32
cages full input sH molecules 272 frames 1 file sH-full.lammpstrj
cages full sH 24 16 8
cages full paper unit sI molecules 46 cages 2 6
cages full paper unit sII molecules 136 cages 16 8
cages full paper unit sH molecules 68 cages 6 4 2

Molecule stills from chemparseplot sit below the OVITO gallery. They are drawn by docs/scripts/render_molecules.py when the book is built.

Molecule stills¶

Drawn by python docs/scripts/render_molecules.py with chemparseplot. The repository stores the script. The PNG files are produced at build time.

Ice Ih colored by published CHILL+.

Ice Ih colored by published CHILL+.¶

Ice Ih with hydrogen atoms and the hydrogen-bond network.

Ice Ih with hydrogen atoms and the hydrogen-bond network.¶

Ice Ic colored by published CHILL+.

Ice Ic colored by published CHILL+.¶

Five-rings and six-rings drawn as translucent polygons.

Five-rings and six-rings drawn as translucent polygons.¶

Upright six-ring faces of ice Ih.

Upright six-ring faces of ice Ih.¶

GenIce sI with a methane molecule in each cage.

GenIce sI with a methane molecule in each cage.¶

GenIce sII with methane in the small cages and THF in the large cages.

GenIce sII with methane in the small cages and THF in the large cages.¶

GenIce sH with methane and THF guests.

GenIce sH with methane and THF guests.¶

THF guest and the surrounding water.

THF guest and the surrounding water.¶

NaCl front. The chloride in the ice slice is not an ice label. CHILL+ runs on the water alone.

NaCl front. The chloride in the ice slice is not an ice label. CHILL+ runs on the water alone.¶

Basal interface, one ice bilayer. Crystal bonds stop at the ice. An interClathrate oxygen with only liquid neighbours is drawn as water.

Basal interface, one ice bilayer. Crystal bonds stop at the ice. An interClathrate oxygen with only liquid neighbours is drawn as water.¶

Nucleation frame colored by published CHILL+.

Nucleation frame colored by published CHILL+.¶

GenIce FAU host.

GenIce FAU host.¶

sI oxygen cell drawn with the solvis backend.

sI oxygen cell drawn with the solvis backend.¶

Previous
Ice-likeness along a short nucleation run
Next
Science tutorials
Analytics by Antics provided by TurtleTech ehf

2019-2026, d-SEAMS core team

Made with Sphinx and Shibuya theme.