Module segment 

Segment binary format: encode and decode.

Format (little-endian):

[magic:4][version:1][bits:1][group_len:4][tensor_len:4][frames:4]
[scale_count:4][scales:2*S][data_len:4][data:D]

Magic: 0x43545154 (“TQTC” in LE). Header is 26 bytes before scales.

Structs

SegmentHeader

Decoded segment header.

Constants

HEADER_SIZE

Minimum valid segment size in bytes (header fields + data_len, no scales/data).

MAGIC

Segment magic number: "TQTC" in little-endian.

VERSION

Current segment format version.

Functions

compression_ratio

Compute the compression ratio for a segment: raw f32 bytes / segment bytes.

decode

Decode a segment, returning all frames as f32 values.

decode_single_frame

Decode a single frame by index from a segment.

encode

Encode a segment from metadata, scales, and packed data.

parse_header

Parse only the segment header (no data decoding).