Module session 

Session recording for entropy collection research.

Records timestamped entropy samples from one or more sources, storing raw bytes, CSV metrics, and session metadata. Designed for offline analysis of how entropy sources behave under different conditions.

Storage Format

Each session is a directory containing:

• session.json — metadata (sources, timing, machine info, tags)
• samples.csv — per-sample metrics (raw + conditioned entropy stats)
• raw.bin — concatenated raw bytes
• raw_index.csv — byte offset index into raw.bin
• conditioned.bin — concatenated conditioned bytes
• conditioned_index.csv — byte offset index into conditioned.bin

Structs

MachineInfo

Machine information captured at session start.

SessionConfig

Configuration for a recording session.

SessionMeta

Session metadata written to session.json at the end of recording.

SessionSourceAnalysis

Compact analysis summary for a single source, embedded in session metadata.

SessionWriter

Handles incremental file I/O for a recording session.

Functions

detect_machine_info

Detect machine information (best-effort).