inelo/numco

NUMber COmpressor - small library for numeric arrays compression.

NUMCO - NUMber COmpressor

A small compression/decompression library for numerical arrays. Its best suited for large data sets of integers., _(*1)

How it works

Internally this lib creates a delta encoded array and then deflates it using zlib., _(*2)

Delta encoding is one of the most powerfull numeric compression methods out there. Its a simple algorithm that converts values in given array so that each represents a difference from the previous value., _(*3)

Delta encoding example:, _(*4)

[100, 101, 102, 103, 104, 105] converts to [100, 1, 1, 1, 1, 1]

Charts

(the more sequential data the better compression ratio), _(*5)

, _(*6)

Mini DOC

Compression, _(*7)

Numco::compress(array) : string
    expects array of numbers as argument and returns compressed base64 encoded string

Decompression, _(*8)

Numco::decompress(string) : array
    expects compressed base64 encoded string and returns decompressed array of numbers

Composer Installation

$ composer require inelo/numco

Example usage

use Inelo\Numco\Numco;

$numArray = [ 100, 101, 102, ... ];

$compressed = Numco::compress($numArray);
$decompressed = Numco::decompress($compressed);

echo "compressed base64 encoded string : " . $compressed . "\n";
echo "decompressed array : " . var_export($decompressed, true) . "\n";

Running tests

vendor/bin/phpunit tests, _(*9)

Release History

• 1.0.0 Initial release