redst4r / newpfd-rs

NewPFD compression/decompression of integers in Rust

NewPFD-rs

Rust library implementing the NewPFD integer compression/decompression algorithm.

Performance

It's currently lacking optimization for speed, but it's decently fast. We perform this on geometrically distributed integers (Geo(lambda=0.01)) to force encoding exceptions in the NewPFD-block.

• Encoding: 90ms/ 1M integers
• Decoding: 16ms/ 1M integers

See benchmarks for details.

Examples

For more examples, see the rust-docs.

// Encode some data using NewPFD
use newpfd::newpfd_bitvec::{encode, decode};
let data = vec![10_u64,12,10,1,1,2,3];
let blocksize = 32; // needs to be a mutliple of 32

// encode
let (compressed_data, _) = encode(data.iter().cloned(), blocksize);
// compressed_data is a `bitvec::BitVec` (similar to a Vec<bool>)

// decode
let (decompressed_data, bits_processed) = decode(&compressed_data, data.len(), blocksize);
assert_eq!(data, decompressed_data);
assert_eq!(compressed_data.len(), bits_processed); // the entire bitstream was consumed