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 |
|
Used in several examples in the documentation and the cookbook |
vtk |
|
For 3D visualization |
joblib |
|
For parallel resolution |
meshio |
|
To load more mesh formats |
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.