Examples

Nine runnable Python scripts live in examples/; each is self-contained, writes its session under a temporary directory, and prints what it does. MATLAB equivalents of the core operations are shown in the MATLAB guide and exercised by matlab/test_mef3io.m.

Script	Shows
01_write_and_read.py	Writing float data (NaN = gap, precision inference), whole-channel and windowed reads, read_raw
02_int32_primitive.py	The primitive path: int32 counts + conversion factor, validity mask, bit-exact round trip
03_appending.py	In-segment append, reopening a session, gaps, forced new segments, rejected conflicts
04_segment_map.py	Reader.segments() / toc(): locating data across day-long gaps, targeted windowed reads
05_annotations.py	Records at session and channel level; Note/SyLg/EDFA with durations
06_encryption.py	Two-level passwords and what each level unlocks
07_legacy_mef_tools_style.py	from mef3io import MefReader, MefWriter as a mef_tools drop-in
08_legacy_compatibility.py	Legacy-vs-new write/read timing and value comparison (needs mef3io[test] + scipy/tqdm)
09_encryption_replicability.py	The full encryption matrix: both writers × plain/encrypted × both readers, plus L1/L2/wrong-password probes (needs mef3io[test])

The numbers produced by 08/09 (and the MATLAB/Python twins benchmarks/bindings_benchmark.py + matlab/benchmark_mef3io.m) are aggregated in Performance & legacy comparison.