Getting Started

This section guides you step-by-step how to decode and encode data on the GPU using the nvCOMP APIs. Before getting started, please review the pre-requisites. Once reviewed, head over to the samples section which showcases various nvCOMP samples.

Note

Throughout this document, the terms “CPU” and “Host” are used synonymously. Similarly, the terms “GPU” and “Device” are synonymous.

Thread Safety

Not all nvCOMP types are thread safe.

Logging

To enable logging, set the NVCOMP_LOG_LEVEL environment variable to an integer:

• 0 for no logging

• 1 for only error messages

• 2 for errors and trace messages

• 3 for errors, traces and hint messages

• 4 for errors, traces, hints and information messages

• 5 for errors, traces, hints, information and API call messages logged for every low-level interface API

• 6 for errors, traces, hints, information and API call and debug messages

By default, log messages will be written to stdout. If the NVCOMP_LOG_FILE environment variable is set to a valid file path, messages will be logged to that file. At present, logging functionality is only limited to errors and API calls.

Samples

The next section documents the samples showing various use cases across two different types APIs available to consume nvCOMP functionality:

• C API samples
  • Compression API
  • Decompression API
  • Batched Compression / Decompression Example - LZ4
• C++ API samples
  • Manager Construction
    • 1) Construction from an nvcomp-compressed buffer
    • 2) Direct construction
      • Checksum support
  • Compression
    • Step 1 Configuration
    • Step 2 Compression
  • Decompression
    • Step 1 Configuration
      • A) configure using a compressed buffer
      • B) configure using a compression config
    • Step 2 Decompression
  • Batched API
  • Bitstream kind
    • BitstreamKind::RAW
    • BitstreamKind::WITH_UNCOMPRESSED_SIZE
  • HLIF Compression / Decompression Examples - LZ4
• Python API samples
  • Basics
    • Import nvComp python module and check versions
    • Zero-copy import host array
    • Zero-copy import device array
    • Convert host array to device array
    • Convert device array to host array
    • Encode single array
    • Decode single array
    • Codec specific options
    • Encode single array with multiple codecs
    • Decoding single arrays of various formats
    • Encoding and decoding with various Bitstream Kinds
    • Batch encoding
    • Batch decoding
    • Batch decoding and encoding various formats
    • Checksum example

Refer to the Installation docs for the sample installation guide using *.deb or *.tar installers. Refer to the sample README for instructions to compile samples from the source.