Skip to main content

compression:apply zfp

Version: 0.0.0

Description​

Compressing input data using one of zfp compression algorithm modes.

Inputs​

InputNameExpected type(s)Description
Pin 0
Required
dataInfield, fields_containerfield or fields container to be compressed
Pin 1
Required
modestring, charzfp mode: fixed-rate ('r'), fixed-precision ('p'), fixed-accuracy ('a')
Pin 2
Required
mode_parameterint32, doublemode-corresponding parameter: rate (double) / precision (int) / accuracy (double)
Pin 3dimint32dimension (1D/2D/3D) for data organization before the compression (int; default: 2)
Pin 4orderint32xyz dimensions order, where x (row) corresponds to number of elementary data, y (col) - number of time steps, z - number of components (applicable only for 3d data) : 0=xyz, 1=yxz (int; default: 0)
Pin 5double_absthresholddoubleDouble positive small value. All the values smaller than max(small value, max(vi) * relative threshold) are considered as zero values, (default value: 1.0e-18).
Pin 6double_relthresholddoubleDouble relative threshold. Values smaller than (v1 - v2) < max(small value, v1 * relativeTol) are considered identical (default value: 1.0e-10).

Outputs​

OutputNameExpected type(s)Description
Pin 0compress_speeddoublethe output entity is a double, containing compression speed of the input data: for ElementalNodal location - [elements/sec], for Nodal location - [nodes/sec]
Pin 1compress_ratiodoublethe output entity is a double, containing compression rate = initial/compressed
Pin 2dataOutcustom_type_fields_containerthe output entity is a 'custom type field container'; each output field containing compressed results corresponding to one component data (ie. input vector field/fc contains 3 components will give 3 output fields), this is not the case when input pin3 is set to 3, all components will be compressed into one field.

Configurations​

NameExpected type(s)Default valueDescription
mutexboolfalseIf this option is set to true, the shared memory is prevented from being simultaneously accessed by multiple threads.
num_threadsint320Number of threads to use to run in parallel
run_in_parallelbooltrueLoops are allowed to run in parallel if the value of this config is set to true.
use_cudaboolfalseIf this option is set to true, zfp fixed-rate parallel (de)compression will use CUDA.

Scripting​

Category: compression

Plugin: core

Scripting name: apply_zfp

Full name: compression.apply_zfp

Internal name: zfp

License: None

Changelog​

  • Version 0.0.0: Initial release.