Conda
=====

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

.. important:: We recommend the use of `Intel Distribution for Python`_, part of Intel oneAPI installation, whenever possible. It comes with its own Conda tools and local Conda channel. Refer to `Discoverer Python Project`_ for more details.

Invoking Conda
--------------

To obtain access to the installed Conda tool, load the module ``intel.universe`` in your Slurm batch script:

.. code-block:: bash

 module load intel.universe

Afterwards any execution of ``conda`` from within that script, without specifying the full path to the executable, will invoke the Conda tool provided by Intel Distribution for Python (Intel oneAPI).

Local Conda channel
-------------------

By default, Intel Distribution for Python installs and maintains (through updates) local Conda channel. The exact location of that channel is:

.. code-block:: bash

 /opt/software/intel/oneapi/conda_channel

.. warning:: On Discoverer HPC users should use Conda to create local environment installations ONLY within their :doc:`scratchfolder`. Do not store the Python virtual environments under :doc:`homefolder` since they occupy large amount of disk space!

To install a virtual environment with Conda on Discoverer HPC, based on the local channel, follow the example:

.. code-block:: bash

 mkdir -p /discofs/${USER}/jupyter_test_env_numpy
 conda install -y -c /opt/software/intel/oneapi/conda_channel -p /discofs/${USER}/jupyter_test_env_numpy jupyterlab seaborn

Display the channels
--------------------

To display the channels available to Conda, run:

.. code-block:: bash

 module load intel.universe
 conda config --show channels

The expected result of that command line execution is:

.. code-block:: bash

 channels:
   - /opt/intel/oneapi/conda_channel
   - intel
   - defaults

(mind the listed local channel).

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

See :doc:`help`

.. _`Intel Distribution for Python`: https://www.intel.com/content/www/us/en/developer/tools/oneapi/distribution-for-python.html
.. _`Discoverer Python Project`: https://py.discoverer.bg/