Module binary_io 

Binary data I/O for OxiPhysics trajectory files.

Provides a compact binary header, frame-level read/write of atomic positions, little-endian byte-conversion helpers, and lossy quantized compression for trajectory data.

Structs

BinaryHeader

Binary file header for an OxiPhysics trajectory file.

Constants

HEADER_SIZE

Byte size of a serialised BinaryHeader.

Functions

compress_positions_quantized

Lossy quantization of positions to i16.

decompress_positions_quantized

Reconstruct positions from quantized i16 data.

f32_from_bytes_le

Decode a f32 value from 4 little-endian bytes.

f32_to_bytes_le

Encode a f32 value as 4 little-endian bytes.

f64_from_bytes_le

Decode a f64 value from 8 little-endian bytes.

f64_to_bytes_le

Encode a f64 value as 8 little-endian bytes.

read_binary_header

Read a BinaryHeader from path.

read_frame_binary

Read one frame of n_atoms atomic positions from an open file.

write_binary_header

Write a BinaryHeader to path, creating or truncating the file.

write_frame_binary

Write one frame of atomic positions to an open file.