Installation for users

Capytaine is available on Windows, MacOS [1] and Linux.

Capytaine requires Python 3.7 or higher. It is compatible with all currently supported version of Python.

On a cloud platform

For a quick try of Capytaine without installing anything on your computer, you can use an online Python-based computing environment such as CoCalc or Google Colab. On such a Jupyter-based environment, Capytaine can be installed by running the following command in a cell:

%pip install capytaine

Then run the following line to check that the latest version of Capytaine has been installed:

import capytaine as cpt; print(cpt.__version__)

You may need to restart the computing environment (kernel) of the notebook for the installation to be effective.

All the core feature of Capytaine are accessible from such a Jupyter-based environment, except for some 3D visualization tools.

As a standalone executable

This is a work in progress. See PR 324 for progress updates.

Installing with pip package manager

Since version 2.0, Capytaine is available as precompiled package on all platform on PyPI, the package registry used by the pip command. After installing a Python interpreter, run the following command line in a terminal to install Capytaine and its dependencies:

python -m pip install capytaine

Then run the following line to check that the latest version of Capytaine has been installed:

python -c 'import capytaine as cpt; print(cpt.__version__)'

You might want to use a virtual environment to install Capytaine independantly of your other Python packages and avoid any risk of dependency conflict.

The package can also be installed by other modern PyPI-based Python package managers, such as PDM or poetry.

Installing with Conda package manager

Capytaine is also available in the Anaconda package repository, that can be accessed with the Anaconda distribution or one of its lightweight counterparts Miniconda and Miniforge.

Note

If you experience very long processing time when installing a package with conda, you might want to install the libmamba solver with ``conda` <https://www.anaconda.com/blog/a-faster-conda-for-a-growing-community>`_ or fully replace ``conda` with Mamba.

Once Conda has been installed, you can install Capytaine from the conda-forge channel. It is recommended to do the installation into a dedicated virtual environment (here arbitrarily named capytaine_env):

conda create --name capytaine_env --channel conda-forge capytaine

Then activate the environment to use it on the command line with:

conda activate capytaine_env

or set it in the project configuration of your IDE (for instance see the documentation of PyCharm, the documentation of VSCode or the documentation of Spyder).

Alternatively, Capytaine can be installed in an existing environment with the following command:

conda install --channel conda-forge capytaine

You can check which version of Capytaine has been installed by running the following command line:

python -c 'import capytaine as cpt; print(cpt.__version__)'

The latest version is currently 2.0.

Optional dependencies

All the required dependencies should be installed automatically when installing with pip or conda. More optional dependencies can be manually installed. They are nice to have but not necessary for Capytaine’s main features.

Name

Example installation command

Usage

matplotlib

conda install matplotlib

Used in several examples in the documentation and the cookbook

vtk

conda install -c conda-forge vtk

For 3D visualization

joblib

conda install joblib

For parallel resolution

meshio

pip install meshio

To load more mesh formats

quadpy

pip install quadpy

For higher order quadratures (experimental)

After creating the Conda environment containing Capytaine, you can add more packages to this environment by activating it with conda activate and then using the conda install or pip install commands. However, it is often more efficient to specify the packages you’d like in your environment from the start when creating it, such as in the following example:

conda create --name capy_and_other_env --channel conda-forge capytaine jupyter matplotlib vtk

With Docker

The following command will create a Docker image based on Ubuntu 22.04 with the version v2.0 of Capytaine:

docker build -t capytaine:v2.0 https://github.com/capytaine/capytaine.git#v2.0

Replace v2.0 by master to download instead the latest development version. Use the following command to open an IPython shell in which Capytaine can be imported:

docker run -it capytaine:v2.0 ipython3

Or the following command to make the current directory accessible from the Docker image and run the file my_script.py from the current directory:

docker run -it -v $(pwd):/home/user capytaine:v2.0 python3 my_scipt.py

Note that graphical displays (matplotlib, vtk, …) might require a complex setup to work from the Docker image.