FAQ

How do I install the engine?

Install the engine. From a checkout, pixi run build writes ./bbdir/seams. nix build writes ./result/bin/seams.

Where is Python?

PydSEAMSlib. pip install 'pydseamslib==2.14.0'. import pydseams is the Frame package. import pydseamslib is that same package. import dseams is the array module. The compiled extension is pydseams.yoda. pydseams._core and pydseams.cyoda are the same object.

Where is Lua / Fennel?

yodaStruct. require("dseams"). require("yoda") returns that table. The meson project builds dseams_core.so. It does not build a yodaStruct executable. The 1.x command yodaStruct -c is Migrate from 1.x.

Why do CHILL+ and cages disagree?

They answer different questions. CHILL+ versus cages.

What does --graph seeded mean?

It is the default for cages only: mutual k-nearest seeds and the union of each atom’s k nearest. k is 4 unless -k is set. chill and chill-plus map that name onto the cutoff list.

Which --type do I pass?

On a single LAMMPS frame, --type 0 (the default) keeps type 2 when any atom has it, otherwise type 1. Mixed TIP4P dumps here, including input/traj/exampleTraj.lammpstrj, use type 2 for oxygen and type 1 for hydrogen. Single-site dumps use type 1: ice1h.lammpstrj, interface_f0.lammpstrj, and mW_cubic.lammpstrj. Any other mixed dump needs the integer of the species you want; see Ionic-liquid dumps. density-z treats --type 0 as every atom.

How does a sheared dump box work?

The dump stores bound spans plus optional xy, xz, and yz. The edge lengths are recovered from the spans and those tilt factors. See Sheared cells.

Why is chemfiles disabled on nix build?

chemfiles is not in the flake closure. seams --features prints chemfiles: disabled, and .pdb, .gro, and .dcd fail with chemfiles is not in this build. The default pixi lock enables chemfiles.

How do I turn colors off?

Set NO_COLOR to a non-empty value. Set FORCE_COLOR to a non-empty value to force color on.

Does seams walk a trajectory?

Yes. --frame N is the first frame and --last M is the last. Both are 1-based, and --last is inclusive. On a LAMMPS dump, a --last past the end of the file stops at the last frame. --jobs J is the OpenMP worker count for that dump. --jobs 1 is serial. .xyz, .pdb, .gro, .dcd, and .con are read one frame at a time. seams --features prints whether OpenMP is on.

How do I view a classified dump?

frame.to_solvis() needs the solvis extra: pip install 'pydseamslib[solvis]==2.14.0'. The call on ice Ih is on Python Frame. The PydSEAMSlib documentation is the Frame how-to. --per-atom FILE on chill, chill-plus, cages, fingerprint, and ions appends a LAMMPS dump with one extra column. OVITO and VMD open that file.

How do I cite this?

Citation. The preferred citation is the 2020 JCIM paper.