eon.concorpus

Store path-based con blobs in a readcon-db corpus.

readcon still parses every frame. The corpus is a second copy: one trajectory per distinct path plus blob, next to the run when config.ini is at most eight directories up, otherwise beside the con file. A missing readcon_db install leaves the con file as the only copy.

A dynamics movie can also ingest each directory of a simulation tree and read those frames back with one read-only get_frame_texts call. The .con files remain the store.

Module Contents

Functions

traj_id	FNV-1a 64 over the absolute path, a NUL, and the con text.
corpus_dir	Directory of the LMDB corpus for this con path.
mirror_con_text	Insert one con blob. Identical path-and-text pairs are stored once.
store_frame_text	Store one con blob. Returns (traj_id, 0) for a single frame.
load_frame_text	Frame text for a key in this corpus, or None when it is absent.
stored_frame_text	Frame text for this path’s current blob, or None when the corpus has no copy.
mirror_con_path	Insert the con file’s current bytes.
directories_with_con	Directories under tree that directly contain .con or .convel.
frame_texts_for_paths	Ingest tree and return frame 0 text for each path, in order.

Data

logger

API

eon.concorpus.logger

‘getLogger(…)’

eon.concorpus.traj_id(path: str, text: str) → int

FNV-1a 64 over the absolute path, a NUL, and the con text.

eon.concorpus.corpus_dir(con_path: pathlib.Path) → pathlib.Path

Directory of the LMDB corpus for this con path.

eon.concorpus.mirror_con_text(path, text: str) → None

Insert one con blob. Identical path-and-text pairs are stored once.

eon.concorpus.store_frame_text(path, text: str) → tuple[int, int] | None

Store one con blob. Returns (traj_id, 0) for a single frame.

The corpus takes the con text only. A barrier is not an argument. A mode is not an argument either: it rides in the saddle frame as the displacements section.

eon.concorpus.load_frame_text(directory: pathlib.Path, traj: int, frame_idx: int) → str | None

Frame text for a key in this corpus, or None when it is absent.

eon.concorpus.stored_frame_text(path) → str | None

Frame text for this path’s current blob, or None when the corpus has no copy.

eon.concorpus.mirror_con_path(path) → None

Insert the con file’s current bytes.

eon.concorpus.directories_with_con(tree: pathlib.Path) → list[pathlib.Path]

Directories under tree that directly contain .con or .convel.

eon.concorpus.frame_texts_for_paths(tree, con_paths, corpus_cls=None) → list[str]

Ingest tree and return frame 0 text for each path, in order.

corpus_cls defaults to readcon_db.ConCorpus. Tests pass a stand-in with the same constructor, ingest_directory, and get_frame_texts.