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.