Libaec
======

.. toctree::
   :maxdepth: 1
   :caption: Contents:

About
-----

`Libaec`_ provides fast lossless compression of 1 up to 32 bit wide signed or unsigned integers (samples). It also provides clear license version of `SZIP`_ compressor.


Supported versions
------------------

To check which `Libaec`_ versions and build types are currently supported on Discoverer, execute on the login node:

.. code-block:: bash

 module avail libaec

Loading/Compiler affinity
-------------------------

.. warning:: Currently, we only support builds with LLVM and GCC. We discovered that Libaec's code is faster when it's compiled with the latest version of LLVM instead of using Intel oneAPI. Please note that the NVIDIA HPC SDK produces  slow binaries, and we do not recommend using that Libaec binary builds for production. Furthermore, since Libaec does not provide Fortran bindings, the support for extended compiler affinity becomes pointless.

Currently, each version of Libaec installed in the public software repository is separately built against two compiler collections: (i) :doc:`llvm`, and (ii) :doc:`gcc`. The name of the environmental module hints the provided compiler affinity.

LLVM build (preferred)
......................

.. code:: bash

 module avail libaec/*/*llvm

GNU GCC build (optional)
........................

.. code:: bash

 module avail libaec/*/*gcc

Intel oneAPI build (retired)
............................

.. code:: bash

 module avail libaec/*/*intel

NVIDIA HPC SDK build (retired)
..............................

.. code:: bash

 module avail libaec/*/*nvidia

AMD AOCC build (retired)
........................

.. code:: bash

 module avail libaec/*/*aocc

Getting help
------------

See :doc:`help`

.. _`Libaec`: https://github.com/MathisRosenhauer/libaec
.. _`SZIP`: http://www.compressconsult.com/szip/