newpfd 0.4.0

NewPFD integer compression/decompression
Documentation

NewPFD-rs

Rust library implementing the NewPFD integer compression/decompression algorithm. It's currently lacking optimization for speed, but it's decently fast:

  • Encoding: 150ms/ 1M integers
  • Decoding: 20ms/ 1M integers

See benchmarks for details.

Fibonacci encoding/decoding is up to speed with other rust implementations, e.g. fibonnaci_codec crate (which I took some code from):

  • Fibonacci encoding: 182ms/ 1M integers (fibonnaci_codec: 170ms)
  • Fibonacci encoding: 160ms/ 1M integers (fibonnaci_codec: 140ms)

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