molcrafts-molrs
Python bindings for the molrs molecular modeling toolkit.
Install with pip install molcrafts-molrs and import molrs. Full docs:
https://docs.molcrafts.org/molrs/.
Install
pip install molcrafts-molrs
Requires Python 3.12+.
Quick start
import molrs
# SMILES → atomistic graph (class API under molrs.io)
mol = molrs.io.smiles.SmilesIr("CCO").to_atomistic()
# 3D coordinates
from molrs.conformer import Conformer
mol, report = Conformer().generate(mol)
# Force field: typify → pairs → potentials
from molrs.ff.typifier import Mmff94Typifier
from molrs.ff.potential import intramolecular_pairs
from molrs.ff.compile import PotentialCompiler
typifier = Mmff94Typifier()
typed = typifier.typify(mol)
frame = typed.to_frame()
ff = typifier.forcefield() # a copy of exactly the types typify assigned
frame["pairs"] = intramolecular_pairs(frame, ff)
pots = PotentialCompiler(ff).compile(frame)
energy, forces = pots.calc_energy_forces(frame)
assert forces.shape == (frame["atoms"].n_rows, 3)
Package layout
The top level is the subsystems, plus the core data classes a user handles
directly (molrs.Frame is molrs.core.Frame: Frame,
Block, Trajectory, Box, MolGraph, Atomistic, CoarseGrain, the
entity classes, Element, Topology). Everything else has one path, named
after its Rust owner.
| Import | Owns |
|---|---|
molrs.core |
Frame, Block, Trajectory, frame metadata; Box, neighbour search, regions, TriMesh, Trace; MolGraph, Atomistic, CoarseGrain and their live views, Element, Topology; Unit, Quantity, UnitPreset, UnitRegistry |
molrs.core.keys / .schema / .constants |
the column vocabulary, its specifications, and every physical and engine constant |
molrs.io |
Every file reader and writer (structure, trajectory, force-field files, *.mrec, SMILES) as read_<fmt>[_<what>] / write_<fmt>[_<what>] (_str / _bytes in memory); each format's classes in its own submodule: io.pdb, io.xyz, io.gro, io.dcd, io.trr, io.xtc, io.lammps, io.smiles, io.cgsmiles, io.mrec |
molrs.io.mrec |
*.mrec store pieces: streaming SequenceSchema, MrecWriter, MrecReader, ForceFieldSection, section_names, pack_mrec_zip, validation (whole records: molrs.io.read_mrec_frame / write_mrec_frame and partners) |
molrs.ff.* |
forcefield, potential, typifier, charge, ir, params, clpol_scaling |
molrs.optimize |
Lbfgs, OptimizationReport |
molrs.md |
Integrators and the MD driver |
molrs.compute |
One class per molrs::compute type, under its core name (flat): RDF, MSD, correlations, fits, spectra, order, clusters, … |
molrs.conformer |
3D generation |
molrs.perceive |
Rings, aromaticity, SMARTS, reactions |
molrs.builder |
Structure builders, site-graph assembly, Coarsener |
An analysis is configured when it is built and given its data when it
computes: Msd(max_lag) then msd.compute(positions=..., dt=...). The
constructor takes configuration only, every optional setting is None unless
given (all defaults live in the core; Msd.spec() lists them), and
compute takes the data as keyword arguments named after the core input's
fields. A result is a read-only object that the next compute accepts as is —
LinearFit(0.2, 0.8).compute(correlation=msd_result, channel=0).
Kernels take dt in the time unit of your trajectory, and time-valued
results come back in that unit. MSD needs unwrapped coordinates
(Unwrap produces them). VACF is the unbiased (C(\tau)) used for
Green–Kubo D and VDOS.
Development
maturin develop --release
pytest -q
Metadata
Release files for molcrafts-molrs 0.18.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| molcrafts_molrs-0.18.0-cp312-abi3-win_amd64.whl | CPython 3.12 | abi3 | Windows x86-64 | Details |
| molcrafts_molrs-0.18.0-cp312-abi3-pyemscripten_2026_0_wasm32.whl | CPython 3.12 | abi3 | PyEmscripten 2026.0+ WebAssembly | Details |
| molcrafts_molrs-0.18.0-cp312-abi3-manylinux_2_28_aarch64.whl | CPython 3.12 | abi3 | Linux glibc 2.28+ ARM64 | Details |
| molcrafts_molrs-0.18.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.12 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| molcrafts_molrs-0.18.0-cp312-abi3-macosx_11_0_arm64.whl | CPython 3.12 | abi3 | macOS 11.0+ ARM64 | Details |
| molcrafts_molrs-0.18.0-cp312-abi3-macosx_10_12_x86_64.whl | CPython 3.12 | abi3 | macOS 10.12+ x86-64 | Details |
Total release size: 56.0 MB
Release files / molcrafts_molrs-0.18.0-cp312-abi3-win_amd64.whl
| Download URL | molcrafts_molrs-0.18.0-cp312-abi3-win_amd64.whl |
|---|---|
| Size | 11.2 MB |
| Tags | CPython 3.12 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
888293a332061ee6dc477221886eb53f450688f3fc253594da086e74e9833c6c
|
|
BLAKE2b-256 checksum How to use checksums |
6b5b9769ae2034bab7b35144fa6d2acc5192778a13caaae32974d9207418537e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 15, 2026.
Transparency logRelease files / molcrafts_molrs-0.18.0-cp312-abi3-pyemscripten_2026_0_wasm32.whl
| Download URL | molcrafts_molrs-0.18.0-cp312-abi3-pyemscripten_2026_0_wasm32.whl |
|---|---|
| Size | 4.3 MB |
| Tags | CPython 3.12 PyEmscripten 2026.0+ WebAssembly abi3 |
|
SHA-256 checksum How to use checksums |
5cbeb9fd6e7741329a1f6cd2f13185c12e6d4afd1f579a9300ea63d49c8abbc6
|
|
BLAKE2b-256 checksum How to use checksums |
4da89b73674937c4d97c7df623e4258add0df407c454c0fe32fd0365924e867f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 15, 2026.
Transparency logRelease files / molcrafts_molrs-0.18.0-cp312-abi3-manylinux_2_28_aarch64.whl
| Download URL | molcrafts_molrs-0.18.0-cp312-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 9.9 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
b7f74eed12c0cd74de1a78c482084d6997c1d2998fe60649119ba877882feae7
|
|
BLAKE2b-256 checksum How to use checksums |
a991fd8687b876de241acdcf30814e5225d0bb20c2e10eea521572e5a9a582d3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 15, 2026.
Transparency logRelease files / molcrafts_molrs-0.18.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | molcrafts_molrs-0.18.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 10.8 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
7005e0216ce7a0aed37adcbe2b7bc3a10732bc75a77157baf02f3897f45a4daa
|
|
BLAKE2b-256 checksum How to use checksums |
fd564897fc39f9980b5e6194c49447131651500e14bc7ddd66385da4bcbfdd53
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 15, 2026.
Transparency logRelease files / molcrafts_molrs-0.18.0-cp312-abi3-macosx_11_0_arm64.whl
| Download URL | molcrafts_molrs-0.18.0-cp312-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 9.5 MB |
| Tags | CPython 3.12 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
29ae869ef6d0e050f14c18273679312bd4e489a3d29cf4f7e1bfdeb0bfaf6848
|
|
BLAKE2b-256 checksum How to use checksums |
14038629af97189d4042bd31f9ddfc4fe146eb2754597b8f3819fda1be43c1b5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 15, 2026.
Transparency logRelease files / molcrafts_molrs-0.18.0-cp312-abi3-macosx_10_12_x86_64.whl
| Download URL | molcrafts_molrs-0.18.0-cp312-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 10.4 MB |
| Tags | CPython 3.12 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
00ea9b9f8dc5dc85d44c8d4de48e2dad9ef91be14efdbd8ef9582d7f574dfba8
|
|
BLAKE2b-256 checksum How to use checksums |
41e22a2085728fcd8bb744bc78a2bce6d8b680279efc0436b57addcec5dbb2a5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 15, 2026.
Transparency logSecurity for molcrafts-molrs 0.18.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
All 6 files in this release have been uploaded with provenance metadata.
Attestation for molcrafts_molrs-0.18.0-cp312-abi3-win_amd64.whl
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 Oct 15, 2026.
Transparency logA 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.
