readcon-db

Mmap-backed CON/convel corpus store (LMDB via Heed), non-SQL selection, xxHash3-128 exact match, and Rust / C / C++ / Python / Fortran bindings.

Part of the readcon ecosystem with readcon-core (Python package readcon):

Crate / package	Role	Docs
readcon-core / `readcon`	CON interchange (parse/write/spec v2–v3). XYZ/PDB/GRO → `ConFrame` via chemfiles (`read_chemfiles*`), not ASE. Optional `to_ase` only for calculators.	Core README, `docs/orgmode/`
readcon-db / `readcon_db` (this repo)	Campaign store: mmap, indexes (natoms, symbols, energy range, forces/velocities/energy flags), multi-reader, dedup. Blobs are CON text decoded with readcon-core.	`docs/design.md`, Sphinx `docs/source/`, `website/`

ASE is not on the critical path for reading CON or XYZ in this stack. ASE .db may appear in CSE timing tables; it is not the recommended store.

Install

cargo add readcon-db
cargo install readcon-db --locked   # CLI
pip install readcon-db             # module readcon_db (PyPI)
# C/C++: FetchContent / meson dependency('readcon-db') / pkg-config
# headers in include/ are shipped; cbindgen is not required

Docs: https://lode-org.github.io/readcon-db/ · API: https://docs.rs/readcon-db · crate: https://crates.io/crates/readcon-db

Quick start (from source)

git clone https://github.com/lode-org/readcon-db
cd readcon-db
cargo test --locked
cargo build --release   # libreadcon_db + CLI readcon-db

Optional LODE sibling checkout (edit core + db together): clone both under the same parent, then create untracked .cargo/config.toml in readcon-db:

[patch.crates-io]
readcon-core = { path = "../readcon-core" }

Python extension from a checkout (python/ + maturin):

pip install maturin
maturin develop --release --features python --manifest-path python/pyproject.toml

use readcon_db::{ConCorpus, Select};
let db = ConCorpus::open("/tmp/corpus")?;
db.append_trajectory_path(1, "run.con")?;
// XYZ in: use readcon-core chemfiles → ConFrame → append (see workflows)
let keys = db.select(
    &Select::new()
        .require_symbol("Cu")
        .require_forces()
        .exact_composition("Cu:2|H:2")
        .fmax_range(0.0, 1.0)
        .energy_range(-50.0, 0.0),
)?;
let h = db.frame_hash(keys[0])?;

./target/release/readcon-db ingest-dir /tmp/corpus /path/to/con_files
./target/release/readcon-db select /tmp/corpus --formula 'Cu:2|H:2' --require-forces \
    --fmax-max 1.0 --energy-min -50 --energy-max 0
./target/release/readcon-db reindex /tmp/corpus
./target/release/readcon-db dedup-export /tmp/corpus --symbol Cu -o subset.xyz  # only if a tool demands XYZ on disk

Foreign trajectories: readcon.read_chemfiles("traj.xyz") → frames → ingest into readcon-db (chemfiles-enabled build), not ase.io.read.

Design

No SQL engine — explicit indexes + in-process intersection, with ASE.db-competitive screening fields (mass, volume, PBC, reserved metadata, charge/magmom; see design matrix).
Decode via readcon-core — CON semantics never fork.
Metadata indexes — finite energy bins; flags for forces, velocities, energy presence.
xxHash3-128 on stored blobs — exact dedup / find_by_hash.
Many readers, one writer (LMDB).

Full ABI table, logo, Sphinx docs, and site: see docs/, website/, assets/logo/, CHANGELOG.md. Fortran module notes: fortran/ReadConDb/.

License

MIT

Cooked SoA tier

Optional RCSO numerics in frames_soa (opt-in cook). CON text in frames stays authoritative. User doc: docs/orgmode/cooked-soa.org.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

readcon_db-0.1.4.tar.gz (429.9 kB view details)

Uploaded Aug 15, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

readcon_db-0.1.4-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (811.3 kB view details)

Uploaded Aug 15, 2026 PyPymanylinux: glibc 2.17+ x86-64

readcon_db-0.1.4-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (793.1 kB view details)

Uploaded Aug 15, 2026 PyPymanylinux: glibc 2.17+ ARM64

readcon_db-0.1.4-cp315-cp315t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (806.1 kB view details)

Uploaded Aug 15, 2026 CPython 3.15tmanylinux: glibc 2.17+ x86-64

readcon_db-0.1.4-cp315-cp315t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (787.5 kB view details)

Uploaded Aug 15, 2026 CPython 3.15tmanylinux: glibc 2.17+ ARM64

readcon_db-0.1.4-cp315-cp315-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (807.3 kB view details)

Uploaded Aug 15, 2026 CPython 3.15manylinux: glibc 2.17+ x86-64

readcon_db-0.1.4-cp315-cp315-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (788.2 kB view details)

Uploaded Aug 15, 2026 CPython 3.15manylinux: glibc 2.17+ ARM64

readcon_db-0.1.4-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (805.6 kB view details)

Uploaded Aug 15, 2026 CPython 3.14tmanylinux: glibc 2.17+ x86-64

readcon_db-0.1.4-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (787.2 kB view details)

Uploaded Aug 15, 2026 CPython 3.14tmanylinux: glibc 2.17+ ARM64

readcon_db-0.1.4-cp314-cp314-win_amd64.whl (720.6 kB view details)

Uploaded Aug 15, 2026 CPython 3.14Windows x86-64

readcon_db-0.1.4-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (806.8 kB view details)

Uploaded Aug 15, 2026 CPython 3.14manylinux: glibc 2.17+ x86-64

readcon_db-0.1.4-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (788.7 kB view details)

Uploaded Aug 15, 2026 CPython 3.14manylinux: glibc 2.17+ ARM64

readcon_db-0.1.4-cp314-cp314-macosx_11_0_arm64.whl (708.5 kB view details)

Uploaded Aug 15, 2026 CPython 3.14macOS 11.0+ ARM64

readcon_db-0.1.4-cp314-cp314-macosx_10_12_x86_64.whl (733.6 kB view details)

Uploaded Aug 15, 2026 CPython 3.14macOS 10.12+ x86-64

readcon_db-0.1.4-cp313-cp313-win_amd64.whl (720.4 kB view details)

Uploaded Aug 15, 2026 CPython 3.13Windows x86-64

readcon_db-0.1.4-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (807.4 kB view details)

Uploaded Aug 15, 2026 CPython 3.13manylinux: glibc 2.17+ x86-64

readcon_db-0.1.4-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (789.3 kB view details)

Uploaded Aug 15, 2026 CPython 3.13manylinux: glibc 2.17+ ARM64

readcon_db-0.1.4-cp313-cp313-macosx_11_0_arm64.whl (708.5 kB view details)

Uploaded Aug 15, 2026 CPython 3.13macOS 11.0+ ARM64

readcon_db-0.1.4-cp313-cp313-macosx_10_12_x86_64.whl (733.7 kB view details)

Uploaded Aug 15, 2026 CPython 3.13macOS 10.12+ x86-64

readcon_db-0.1.4-cp312-cp312-win_amd64.whl (720.7 kB view details)

Uploaded Aug 15, 2026 CPython 3.12Windows x86-64

readcon_db-0.1.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (807.3 kB view details)

Uploaded Aug 15, 2026 CPython 3.12manylinux: glibc 2.17+ x86-64

readcon_db-0.1.4-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (789.6 kB view details)

Uploaded Aug 15, 2026 CPython 3.12manylinux: glibc 2.17+ ARM64

readcon_db-0.1.4-cp312-cp312-macosx_11_0_arm64.whl (708.8 kB view details)

Uploaded Aug 15, 2026 CPython 3.12macOS 11.0+ ARM64

readcon_db-0.1.4-cp312-cp312-macosx_10_12_x86_64.whl (734.2 kB view details)

Uploaded Aug 15, 2026 CPython 3.12macOS 10.12+ x86-64

readcon_db-0.1.4-cp311-cp311-win_amd64.whl (723.6 kB view details)

Uploaded Aug 15, 2026 CPython 3.11Windows x86-64

readcon_db-0.1.4-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (810.1 kB view details)

Uploaded Aug 15, 2026 CPython 3.11manylinux: glibc 2.17+ x86-64

readcon_db-0.1.4-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (792.1 kB view details)

Uploaded Aug 15, 2026 CPython 3.11manylinux: glibc 2.17+ ARM64

readcon_db-0.1.4-cp311-cp311-macosx_11_0_arm64.whl (711.0 kB view details)

Uploaded Aug 15, 2026 CPython 3.11macOS 11.0+ ARM64

readcon_db-0.1.4-cp311-cp311-macosx_10_12_x86_64.whl (736.4 kB view details)

Uploaded Aug 15, 2026 CPython 3.11macOS 10.12+ x86-64

readcon_db-0.1.4-cp310-cp310-win_amd64.whl (723.6 kB view details)

Uploaded Aug 15, 2026 CPython 3.10Windows x86-64

readcon_db-0.1.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (810.1 kB view details)

Uploaded Aug 15, 2026 CPython 3.10manylinux: glibc 2.17+ x86-64

readcon_db-0.1.4-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (792.4 kB view details)

Uploaded Aug 15, 2026 CPython 3.10manylinux: glibc 2.17+ ARM64

readcon_db-0.1.4-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (813.1 kB view details)

Uploaded Aug 15, 2026 CPython 3.9manylinux: glibc 2.17+ x86-64

readcon_db-0.1.4-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (795.8 kB view details)

Uploaded Aug 15, 2026 CPython 3.9manylinux: glibc 2.17+ ARM64

File details

Details for the file readcon_db-0.1.4.tar.gz.

File metadata

Download URL: readcon_db-0.1.4.tar.gz
Upload date: Aug 15, 2026
Size: 429.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for readcon_db-0.1.4.tar.gz
Algorithm	Hash digest
SHA256	`9ac6935d80444f135357b3b4dcbff97fcedb1f9235bb72e5fdc72eda2e38cf55`
MD5	`91354ad992f53945ecbc0a04a02fa199`
BLAKE2b-256	`6f34d152b717a853bfdff77c6128d4ce626c59704ecf7106c170fc699a6a1626`

Algorithm	Hash digest
SHA256	`50c865a01df1a0f22860c3429c764c53b97a18d982427bd2cba69abfa973cd7c`
MD5	`7aacf7470cfc410d25502df08e422a8f`
BLAKE2b-256	`960902156d0ae8738744942c8a49e70037fd8016536fceef693738d7c60b7a11`

Algorithm	Hash digest
SHA256	`76e5719ddc552bb626f0a99d2e6234a9acb2571eebc9b7e78842c6b6865dcc0a`
MD5	`8d7f9471187d583d5979d3b157a60eae`
BLAKE2b-256	`7ed972b659bc6fe2f6522e0f33b9bf14578f4dcf482beb9fa532bfc53ec2ccc8`

Algorithm	Hash digest
SHA256	`a957af341ddca64fcd7e4cd4e44b59845a6d31fe38aedef24d1049db99c2b6ad`
MD5	`63d4e94b39321b3a785ab78af464bac0`
BLAKE2b-256	`96e0a12c22245bd383f1370c661b1a93049d8e6527909a6abb99465bdab3202d`

Algorithm	Hash digest
SHA256	`3d4f302f169ebf2ffe54be3140c3543cb0fa64013ffd161e44b4f856483dfbb7`
MD5	`85d24ce5702e31b194c4d0e09d3e57bc`
BLAKE2b-256	`9966f773a614ecfb467097bf310d725af2e1b62ad8b5e5a729d30b0b67a784f0`

Algorithm	Hash digest
SHA256	`392064f8cb8478a7eb46637d86ff78994d94b62eb9fd952a1b65e4104a0b630a`
MD5	`2f128bd0a1e2d96e6272ea2ecbae37ee`
BLAKE2b-256	`c1fa4c26c695c86a134e226eee24deebbf37ffd607496e7f8b9fcac3ed4964e0`

Algorithm	Hash digest
SHA256	`b70ffb82253ae523211ba1e66bd2ef627f722120e3e53c70d72fa1e7fc4df859`
MD5	`8b6990c59c5f8d589c51d5b2d6a92914`
BLAKE2b-256	`a0fee574555593a1adc98e000b27fb47d4de62259aa24f9f8772e6a185dbd67f`

Algorithm	Hash digest
SHA256	`3634496ddab6a29d9ef5c9d62a25b0871273e2b05f0f74b419d1e44f62236740`
MD5	`3eb5236592d20aab15fa3cff92381218`
BLAKE2b-256	`005a274932f9c15f331e359dc66c6b6093b15cfaf1c1363a62ce3b01459b9c15`

Algorithm	Hash digest
SHA256	`11f25b3511fb2e4a057bc2630018f0131bf5d7d662e752997a12f3aae2fcaf78`
MD5	`e9eadb8ea35e89906604bc58c2412bf1`
BLAKE2b-256	`d9ad0318f9f5314025deff0598bae0da2c47446983d43629915a0e00a47adb89`

Algorithm	Hash digest
SHA256	`9cf6ed515b0629006b0579e334748dafc07d503e892d7df0719fb3dfe379445d`
MD5	`08bdc399b68ae86623b34922762bf140`
BLAKE2b-256	`e3d2af6462461fb99f7223cd6d85f96de50fb6a4aa9524db3ba08fd428a9a9e5`

Algorithm	Hash digest
SHA256	`50f9d460a20bbf9c058363538411ef0fad4f3eb6ff6c8f9758b129f687f33d6f`
MD5	`698d6f05edf2b247deddfe8d1ea791d4`
BLAKE2b-256	`478a6cc3ee988b049d1f0690955b1a0b8748f65f115e24145f6420008662aa19`

Algorithm	Hash digest
SHA256	`2bb96b697ad03cef5bc0a615b847e64c1d1bfc0667dc2a12b7e45eb9c3a4a3c2`
MD5	`efcc5711f8e817fee2fe6421d44f973f`
BLAKE2b-256	`31439d318c38d2bbd1d196a731596f642b7695c32efbe40260306777c4d9af69`

Algorithm	Hash digest
SHA256	`c5e3c38de9810c050cb51dd608f8b929d65f26220eca7c932a899b555eec9166`
MD5	`12d304047e724eac698e4cd85b85c74c`
BLAKE2b-256	`feae2285a8e24bc97f81b06e84e3f692ef14187d871b502ecccdc08c09c05246`

Algorithm	Hash digest
SHA256	`dc6d843fa1dc2e1e030b0fabaf5a142b1c649033ef13adffc2a33cc410863947`
MD5	`d8c6ebd8059993452528c9e001ed3328`
BLAKE2b-256	`fb11381ec370a87520911742176c9115550cb60f3b526d0be3b679767b81bb82`

Algorithm	Hash digest
SHA256	`b5f67c8dd352dc53ce526d408e40d70dd02af87efdc6130b8e70732429063bf1`
MD5	`a732a21e5af796206c29b2eb82ab60cd`
BLAKE2b-256	`e9662e18f198e158024f6755b7c060d9298df862f459f9c45947499fdf0712f8`

Algorithm	Hash digest
SHA256	`4b3871fde22e60e510fbad7d926e8e22e2fdb78a2687092a02106cacc236d136`
MD5	`0bcdb0ec5f420ee37954d2ab017ad659`
BLAKE2b-256	`56c834b576f12b88a58a254578cbef5dab104884843ec193b8583d0b72abc4af`

Algorithm	Hash digest
SHA256	`8786cc441104e0695d4e0dcbfa2ba564d806c9f0f00efbbba7f90b3ab264b991`
MD5	`ff441cd5a5cb3adb82bfed3af541b444`
BLAKE2b-256	`2d26069bfa9509e91d2745a7c16489337ca999b25c9a63f3e909b970fdeb3929`

Algorithm	Hash digest
SHA256	`4e70ece6c64978299538862c15bd16bcf1fa8c87f1dcee41e3504562e3cdc957`
MD5	`ed8eac437889499e2ae4e8e33b788d6a`
BLAKE2b-256	`45d409c46063d7aef4465d28b622b5898bf378a62bd4ec0bc49cb6f34c7f9918`

Algorithm	Hash digest
SHA256	`e22625d9dbb99e58ffbf3b63a2510297d7e5ceb582809420f329d5aa36e10565`
MD5	`7a7ca706394a5daa5b336fb5131d48cc`
BLAKE2b-256	`afb7cc3e62c7dcdb1784f3e90c27bbbc53b61f02cf82aae388c3ae8db637a4c2`

Algorithm	Hash digest
SHA256	`23c09a3ce1c1f1cf3d7b90b125f3122c83968e921e9aa98475e9a63d33704124`
MD5	`015312bb7cfb806ede076c2a200128a9`
BLAKE2b-256	`f67d4c9becb1a3dd05dcd18dc6436e63be90ab9be8ce9db3a3d332d96c3dacef`

Algorithm	Hash digest
SHA256	`2af99d20aff86a433435496b3ee4e65c6a3e7a910be6ff501fba993a68ecdf2d`
MD5	`80c69189fa097dac4e34a80a29d36a20`
BLAKE2b-256	`2cbc8719b846412e969718cb32b1127a1374245cd3978afbdf8259fdf255efa4`

readcon-db 0.1.4

readcon-db

Install

Quick start (from source)

Design

License

Cooked SoA tier

Project links

Key dates

1 maintainer

GitHub Statistics

License

Requires

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Algorithm	Hash digest
SHA256	`469d7672689b774c53f942101c529f5d709d92376e7ab21644b7434b1440e49b`
MD5	`b38ea7c26aec4ea99056881f7b8b78fe`
BLAKE2b-256	`fef6f0267592a11201e786771383a59cb54677e5a2c21227fa581c5e00998377`

Algorithm	Hash digest
SHA256	`3b15a4da3385438c14cc6e4966ea9dec85e63cefe7618bbe2f5659990d4580b0`
MD5	`7ee16d8d616676efb5e43701f5628e79`
BLAKE2b-256	`6c2ba61bb7172dc8e3fbd645688c8d2f248d0f5dd24f70c345dce8baa3f09d74`

Algorithm	Hash digest
SHA256	`18e857cb911e5541a20af03a6984fb68e6b4b34cd9d4a0b0440fef5bd19faaa2`
MD5	`60a60c3b9c9da28b2c58aa52881fb60c`
BLAKE2b-256	`15397eb48a737c8c75351b5d8225daf7cc1f3929de5df237e7c3715f79175cc9`

Algorithm	Hash digest
SHA256	`dd430745827da7dfaeb6e297c45b5a66e43ec29dd1b4f244a02bf7fc400fb323`
MD5	`80e46de67a6fb76813fc9ae139ec9460`
BLAKE2b-256	`37ef4d6c8077255a855214a4b1bc49c01b49d20aaf0bb40e6205b10903442153`

Algorithm	Hash digest
SHA256	`877aac1b2f28506f63ccfd87ab169003f8a32b65630ff94743f025c956f9ed34`
MD5	`3d8011d05d52be4be23a0428830d1a47`
BLAKE2b-256	`060ba00ccca5bf3bfbeedefb629baf1b4684677963bb8fd29d3d05e386e872e4`

Algorithm	Hash digest
SHA256	`70440f1e0a20e9f6273c0203a8e7f9dd32029483707ed16472948003049b8d39`
MD5	`409073570bab5e0ecf6ae57c308371be`
BLAKE2b-256	`05c24297ee16dc965e30b508fe579f90a37d2f92cae4d804a7606ad9b659659d`

Algorithm	Hash digest
SHA256	`56d2c9688a17e0c1ad43803350e3bbf7e024ac6e6372c7972500ef28bbf83b41`
MD5	`7713f76d93b8420955fe9e3cbbed7203`
BLAKE2b-256	`f653041b80683be7fdab3b8309e93daea412d5d1ce944a45d2f82a2b6650add9`

Algorithm	Hash digest
SHA256	`463ab108ca2c7638b31a2678769dbe092ce9bd138450f934ced062ea39b8f5aa`
MD5	`acd6e363c737dd9280d9b2e8ffa3ca16`
BLAKE2b-256	`23a31b2a515506f886f496a6646a3ae825d8585f9086294283eaa1cecfcca7cd`

Algorithm	Hash digest
SHA256	`0577b09f532023b5299e1fc0f5af09cbc34ea09537c7fa3678062c9599a5174e`
MD5	`18b730cae4932950aedb576201ff15f1`
BLAKE2b-256	`6b7749b51aeae047d7eaab78dcaccaea8b1b99d9651ff081491667dfd705e423`

Algorithm	Hash digest
SHA256	`0883f3d940a5a89a6a0bb9d6439594f6bb0657bbde853ec6a459b964fbac57ea`
MD5	`41c93ea589b3f4319440961e2cc28b16`
BLAKE2b-256	`731ed9c6f4199eac1b76d49d88ec010ef9a6ebdbf6c63fb47068a32565405449`