NetCDF
======

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

About
-----

`NetCDF`_ (Network Common Data Form) is a set of software libraries and machine-independent data formats that support the creation, access, and sharing of array-oriented scientific data. 

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

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

.. code-block:: bash

 module avail netcdf

If you wish to check or use the recipe we followed to compile the NetCDF source code, visit:

https://gitlab.discoverer.bg/vkolev/recipes/-/tree/main/netcdf-c
https://gitlab.discoverer.bg/vkolev/recipes/-/tree/main/netcdf-cxx4
https://gitlab.discoverer.bg/vkolev/recipes/-/tree/main/netcdf-fortran

User-supported versions
.......................

Users are welcome to bring, compile, and use their own builds of NetCDF, but **those builds will not be supported by the Discoverer HPC team.**

Compiler and MPI library affinity
---------------------------------

Compiler affinity
.................

Each version of NetCDF installed in the public software repository is built against four compiler sets: (i) :doc:`oneapi`, (ii) :doc:`nvidia_hpc_sdk`, (iii) :doc:`aocc` , (iv) :doc:`gcc`. The corresponding NetCDF environment module names contain the name of the compiler set employed for building the NetCDF code. Loading the selected module triggers loading the corresponding compiler environment.

MPI library affinity
....................

The name of the adopted MPI library is part of the NetCDF environment module name. Loading the selected module triggers loading the corresponding MPI and compiler environment.

The following MPI libraries are supported by the NetCDF builds installed in the public software repository:

 * :doc:`mpi` 4.x
 * :doc:`mpi` 4.x

.. note:: Intel oneAPI MPI library is not supported. The preliminary tests detected severe run-time problems (like "Segmentation fault") on AMD Zen2 processors.

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

See :doc:`help`

.. _`NetCDF`: https://www.unidata.ucar.edu/software/netcdf/