Skip to content

Commit

Permalink
aarch64 python.rst
Browse files Browse the repository at this point in the history
  • Loading branch information
ptheywood committed Mar 18, 2024
1 parent 9de599d commit d169eab
Showing 1 changed file with 20 additions and 6 deletions.
26 changes: 20 additions & 6 deletions software/applications/python.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,17 +5,29 @@ Python

`Python <https://www.python.org/>`__ is an interpreted, interactive, object-oriented programming language with dynamic typing.

Python 3.6 is available by default on Bede, as ``python3``, however, consider using :ref:`Conda <software-applications-conda>` for your python dependency management.
.. tabs::

Conda is a cross-platform package and environment management system, which can provide alternate python versions than distributed centrally, and is more-suitable for managing packages which include non-python dependencies.
.. tab:: ppc64le

Python 2 is also available, but is no longer an officially supported version of python.
If you are still using python 2, upgrade to python 3 as soon as possible.
Python ``3.6`` is available by default, as ``python3``, however, consider using :ref:`Conda <software-applications-conda>` for your python dependency management.

Conda is a cross-platform package and environment management system, which can provide alternate python versions than distributed centrally, and is more-suitable for managing packages which include non-python dependencies.

On the ``ppc64le`` nodes/partitions Python 2 is also available, but is no longer an officially supported version of python.
If you are still using python 2, upgrade to python 3 as soon as possible.

.. tab:: aarch64

Python ``3.9`` is available by default on ``aarch64`` nodes, as ``python3`` and ``python``.
Alternate versions of Python can be installed via :ref:`Conda <software-applications-conda>`

Conda is a cross-platform package and environment management system, which can provide alternate python versions than distributed centrally, and is more-suitable for managing packages which include non-python dependencies.

Python 2 is not available on the ``aarch64`` nodes/partitions in Bede.

If you wish to use non-conda python, you should use `virtual environments <https://docs.python.org/3/library/venv.html>`__ to isolate your python environment(s) from the system-wide environment.
This will allow you to install your own python dependencies via pip.


For instance, to create and install `sphinx` (the python package used to create this documentation) into a python environment in your home directory:

.. code-block:: bash
Expand All @@ -31,7 +43,7 @@ For instance, to create and install `sphinx` (the python package used to create
# Use pip to install sphinx into the environment
python3 -m pip install sphinx
.. note::
.. warning::

Python virtual environments can become large if large python packages such as TensorFlow are installed.
Consider placing your python virtual environments in your project directories to avoid filling your home directory.
Expand All @@ -52,4 +64,6 @@ I.e. to delete a python virtual environment located at ``~/.venvs/sphinx``
rm -r ~/.venvs/sphinx/
Python packages may install architecture dependent binaries, so you should use a separate virtual environments for ``ppc64le`` and ``aarch64`` nodes/partitions.

For further information on please see the `Python Online Documentation <https://docs.python.org/3/index.html>`__.

0 comments on commit d169eab

Please sign in to comment.