sadcompressor 0.1.1

Streamed Array Data compressor

sadcompressor

sadcompressor is a compact archival format and Python library for streamed time-series data (mainly NumPy arrays). It stores frames with delta updates, optional prediction, and quantization-based compression.

Quick Start

import numpy as np
import sadcompressor as sad

filename = "example.sad"

# Create archive
with sad.SADWriter(filename, prec_nbits=20, prec_maxexp=8) as writer:
    writer["x"] = np.array([1.0, 2.0, 3.0], dtype=np.float32)
    writer.next_key(0.1)
    writer["x"] = np.array([1.1, 2.1, 3.1], dtype=np.float32)

# Read archive sequentially
with sad.SADReader(filename) as reader:
    while not reader.next_key():
        print(f"t={reader.t:.3f}", reader["x"])