readcon-db

mmap CON corpus

LMDB via Heed. Indexes, xxHash3 exact match, and bindings for Rust, C, C++, Python, and Fortran.

readcon-db#

Rare-event codes already checkpoint frames in the plain-text structure format (CON). This crate keeps thousands of those frames in one memory-mapped tree: ingest CON text, filter without loading every atom, decode a hit with readcon-core.

Ask questions and report bugs on the GitHub issue tracker. Report a security problem by email instead, as SECURITY.md in the repository describes.

Getting started · Tutorial: Your first corpus · How-to — corpus I/O by language · Architecture · FAQ

cargo add readcon-db
pip install readcon-db

Important

New here? Getting started then Tutorial: Your first corpus

Many writers / HPC shards? Campaign ops runbook

Language API? How-to — corpus I/O by language · Rust API

Tutorial: Your first corpus

Ingest three files, filter them by element and energy, and find a repeated trajectory.

Tutorial: Your first corpus
How-to by language

The same open / ingest / select path in Rust, Python, C, and Fortran.

How-to — corpus I/O by language
Architecture

mmap, SWMR, secondary indexes, xxHash3, hourglass ABI.

Architecture
Campaign ops

Shards, drain, join, compact. One writer per LMDB env.

Campaign ops runbook

Site map#