Adding `floatpack` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add floatpack

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

floatpack = "0.1.0"

The floatpack library will be automatically available globally. Read the floatpack library documentation.

Back to the crate overview.

Readme

floatpack

Bitpacking with SIMD for Decimal from the rust_decimal crate.

In a nutshell

The algorithm:

Each Decimal value is serialized into its components (= 4 x u32)
The resulting 4 component streams are individually compressed by storing their cumulative difference (XOR)
The 4 compressed component streams are then bit-packed

The idea is that this should get good compression rates with little computational complexity, especially for contiguous data. In timeseries data, usually:

one datapoint only differs slightly from the next one in the series and
you have a lot of datapoints

This represents a highly specific use-case. If you are not dealing with timeseries data other compression algorithms are probably more suitable.

Usage example

use floatpack::{pack, unpack};
use rust_decimal_macros::*;

let values = vec![dec!(1.0), dec!(2.0), dec!(3.0)];
assert_eq!(values, unpack(&pack(&values[..])));

Adding floatpack library as a dependency

Adding `floatpack` library as a dependency