TroubleshootingΒΆ

symptom

cause

fix

A command and a trajectory file are required / exit 2

The command, the file, or both were omitted

seams read input/traj/ice1h.lammpstrj

unknown command: NAME / exit 2

NAME is not a command

seams --help. chill_plus is chill-plus. ovito_chill_plus is ovito-chill+

bad --pair-types (want I,J) / exit 2

The value is not two integers separated by a comma

seams rdf input/traj/il_tiny.lammpstrj --pair-types 1,2

nop 0, exit 0

The type filter kept no atoms, or the frame is empty

--type 2 on mixed TIP4P (exampleTraj.lammpstrj). --type 1 on single-site dumps (ice1h.lammpstrj, mW_cubic.lammpstrj). Another species needs its integer (Ionic-liquid dumps). --strict-input makes an empty frame exit 2

Neighbours miss a pair across a sheared face

Bound spans were used as the edge lengths

The tilt factors in the dump are enough. The engine recovers H (Sheared cells)

chemfiles: disabled, then chemfiles is not in this build

This binary has no chemfiles. The suffix in the message is pdb, gro, or dcd

pixi run build (the default lock enables chemfiles). The nix flake leaves chemfiles out (Nix flake)

segfault in mmCIFFormat::read with conda-forge chemfiles 0.10.4

That release writes label_seq_id . and omits label_entity_id

Use the pixi or Meson build. It rejects that library and builds tag 0.10.4 with cmake/patches/chemfiles-0.10.4-mmcif.patch. A library you linked yourself needs that patch (Install the engine)

readcon-core is not in this build; CON input needs it

seams --features shows readcon-core: disabled. The nix flake does not include it

A Meson build that finds readcon-core reads .con. -Dwith_readcon=disabled leaves the reader out

--jobs stays serial

OpenMP is off, or the file is not a LAMMPS dump

seams --features. --jobs is the OpenMP worker count on a LAMMPS dump range. --jobs 1 is serial. .xyz, .pdb, .gro, .dcd, and .con are one frame at a time

ModuleNotFoundError: pydseams

The Python package is PydSEAMSlib

pip install 'pydseamslib==2.14.0' (PydSEAMSlib)

Looking for yodaStruct -c lua_inputs/config.yml

That command is the 1.x driver

seams in this repository. Lua is require("dseams") from yodaStruct. See Migrate from 1.x

seams: command not found

The binary is not on PATH

After pixi run build or meson compile -C bbdir it is ./bbdir/seams. nix build writes ./result/bin/seams. pixi run install or meson install installs it

module 'dseams' not found / require("dseams") fails

Lua cannot see dseams.lua and dseams_core.so

Build yodaStruct with meson. Set LUA_PATH to lua/?.lua and LUA_CPATH to the directory that holds dseams_core.so. require("yoda") returns the same table

Two commands on the bundled frames:

seams read input/traj/ice1h.lammpstrj
seams rdf input/traj/il_tiny.lammpstrj --pair-types 1,2

When you file an issue, include seams --version, seams --features, the command line, and a minimal dump.