Skip to main content

lammps-md-tools

Small, dependency-light command-line tools for working with LAMMPS data/trajectory files.

This project is intentionally tiny:

  • minimal dependencies
  • deterministic behavior (good for automation/agents)
  • clear input/output contracts

Install / run

Using uvx (from Astral's uv):

uvx --from lammps-md-tools lammps-fix-box --help

Install into an environment

python -m pip install -U lammps-md-tools

Commands

lammps-fix-box

Rewrite the box bounds in a LAMMPS data file to match a cubic box length L.

Typical use case: tools that convert XYZ -> LAMMPS data may leave default bounds (e.g. 0..100 Å) that do not match the actual packing box.

# rewrite bounds to 0..L and wrap atoms into the box
lammps-fix-box --in input.data --out output.boxfix.data --L 60.69 --wrap

# use a different origin (origin..origin+L)
lammps-fix-box --in input.data --out output.data --L 60.69 --origin -30.345

What it does

  • Rewrites header lines like xlo xhi, ylo yhi, zlo zhi to origin..origin+L.
  • If a xy xz yz tilt line is present, it is rewritten to 0 0 0 xy xz yz.
  • If --wrap is passed, wraps x y z coordinates into [lo, hi).

Assumptions / limitations

  • Assumes a common LAMMPS data layout with an Atoms section containing at least: atom-ID atom-type x y z [extra...]
  • It does not try to interpret/repair bonds, angles, velocities, etc.

Development

Build (wheel + sdist):

python -m pip install -U build
python -m build

License

MIT (see LICENSE).

Metadata

Release files for lammps-md-tools 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lammps-md-tools 0.1.0
File Size Uploaded Provenance Actions
lammps_md_tools-0.1.0.tar.gz 4.4 kB With provenance Details for lammps_md_tools-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for lammps-md-tools 0.1.0
File Interpreter ABI Platform Actions
lammps_md_tools-0.1.0-py3-none-any.whl Python 3 none any Details for lammps_md_tools-0.1.0-py3-none-any.whl

Total release size: 9.9 kB

Release files / lammps_md_tools-0.1.0.tar.gz

Download URL lammps_md_tools-0.1.0.tar.gz
Size 4.4 kB
Tags Source
SHA-256 checksum
How to use checksums
ff84c29f27e4c59cb017e3630ae9e04a270f2e425c0b582fe3b1a720908a5c39
BLAKE2b-256 checksum
How to use checksums
c7f19af0b8a125eed909b61b08c986350d2e6af1eeab28303e03ffc884ec4949
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 14, 2026.

Transparency log

Release files / lammps_md_tools-0.1.0-py3-none-any.whl

Download URL lammps_md_tools-0.1.0-py3-none-any.whl
Size 5.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a33bf7cf865ba57eb25979bc659dd5e55bb6abedebdfc0da3aa51ca13d773a9f
BLAKE2b-256 checksum
How to use checksums
a7c495ef52399c5f1715be92ee10087103f3a12df9762c281b75f27d6dfb99ea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 14, 2026.

Transparency log

Security for lammps-md-tools 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for lammps_md_tools-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 14, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page