Skip to content

szcompressor/QoZ

Repository files navigation

QoZ: Dynamic Quality Metric Oriented Error Bounded Lossy Compression for Scientific Datasets

Introduction

This is the source code of the QoZ data compression introduced in the paper: QoZ: Dynamic Quality Metric Oriented Error Bounded Lossy Compression for Scientific Datasets (IEEE paper link)(arXiv paper link). QoZ can be regarded as an extension of SZ3 (SZ3 Code) which has multiple quality optimization targets and achieves better rate-distortion than SZ3 in most cases.

Dependencies

Please Install the following dependencies:

  • cmake>=3.13
  • gcc>=6.0

3rd party libraries/tools

  • Zstd >= 1.3.5 (https://facebook.github.io/zstd/). Not mandatory to be mannually installed as Zstandard v1.4.5 is included and will be used if libzstd can not be found by pkg-config.

Installation

  • mkdir build && cd build
  • cmake -DCMAKE_INSTALL_PREFIX:PATH=[INSTALL_DIR] ..
  • make
  • make install

Then, you'll find all the executables in [INSTALL_DIR]/bin and header files in [INSTALL_DIR]/include. A Cmake version >= 3.13.0 is needed and we recommend to use gcc version 9.x to compile the code. Before you proceed to the following evaluations, please add the installation path of QoZ to your system path so that you can directly run qoz command in your machine for further evaluations.

Single compression/decompression testing Examples

You can use the executable 'qoz' command to do the compression/decompression. Just run "qoz" command without any argument to check the instructions for its arguments. The qoz executable includes the SZ3.1 compression, but the qoz features are automatically involved. You can add argument "-q 0" to disable them for comparing the compression results with SZ3-based compression (adding -q 0 will make qoz command perform the same as SZ3.1). Notice: Currently the QoZ features only support 2D and 3D input data. QoZ will use SZ 3.1 to compress input data in other dimensions.

Version History

  • QoZ 1.1: Improvements over 1.0.
  • QoZ 1.0: The SC '22 Version.

Bug Report

If you have met any errors or abnormal results when using QoZ, feel free to raise issues or contact me via jliu447@ucr.edu.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published