.. _install:
============
Installation
============
From binary packages
====================
Pip
---
Install binary packages from `PyPI `_::
pip3 install openturns
For an installation without administrative privileges the option :code:`--user` can be used.
Note that pip does not install pre-releases unless given the option :code:`--pre`.
Conda
-----
This is relevant to the `Conda `_ userland Python package manager.
As binary dependency packages from the `conda-forge `_
channel are not compatible with ones from the default channel, openturns packages
are not working on top of Anaconda.
Instead, we recommend installing conda from `Miniforge `_
where conda is configured to prioritize packages from conda-forge out of the box.
On Windows just download the matching miniforge exe and follow the instructions,
on Linux you can install it from command-line in one go::
wget https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Linux-x86_64.sh -P /tmp
bash /tmp/Miniforge3-Linux-x86_64.sh -b -p $HOME/miniforge
PATH="$HOME/miniforge/bin:$PATH"
Then it should be ready to install packages::
conda install -y openturns
Note that conda can be slow or fail at resolving complex environments with many packages
so when a full upgrade is needed our advice is to create a new environment from scratch.
Alternatively, you can download the `otconda `_ bundle
containing the library and its modules that allows for an offline installation.
Windows
-------
Download the installer matching your python version and architecture from `GitHub `_
Then just run installer and follow the instructions.
A non-interactive installation is also possible with the command line::
openturns-1.22-py38-x86_64.exe /userlevel=1 /S /FORCE /D=%PREFIX%
macOS
-----
Installation options include pip and conda.
Debian/Ubuntu
-------------
First create an entry in the apt configuration matching your distribution family and codename
if available in one of the following commands::
echo deb https://openturns.github.io/apt/ubuntu noble main | sudo tee /etc/apt/sources.list.d/openturns.list
echo deb https://openturns.github.io/apt/ubuntu jammy main | sudo tee /etc/apt/sources.list.d/openturns.list
echo deb https://openturns.github.io/apt/debian bookworm main | sudo tee /etc/apt/sources.list.d/openturns.list
echo deb https://openturns.github.io/apt/debian bullseye main | sudo tee /etc/apt/sources.list.d/openturns.list
.. note::
Use the bash command `lsb_release -a` in order to determine the codename of your distribution.
Then add the mirror signature, enable apt https support and update the package database::
curl -s https://openturns.github.io/apt/public.key | sudo apt-key add -
sudo apt install apt-transport-https
sudo apt update
At this point the following new packages should be available via the package manager:
.. table::
+----------------------+------------------------------------+
| Package name | Description |
+======================+====================================+
| libopenturns0.x | library |
+----------------------+------------------------------------+
| libopenturns-dev | development package |
+----------------------+------------------------------------+
| python3-openturns | Python module |
+----------------------+------------------------------------+
To install the Python module::
sudo apt install python3-openturns
RPM-based distributions
-----------------------
Add the repository corresponding to your operating system::
curl https://download.opensuse.org/repositories/science:/openturns/CentOS_8/science:openturns.repo -o /etc/yum.repos.d/science-openturns.repo
curl https://download.opensuse.org/repositories/science:/openturns/Fedora_39/science:openturns.repo -o /etc/yum.repos.d/science-openturns.repo
curl https://download.opensuse.org/repositories/science:/openturns/Fedora_40/science:openturns.repo -o /etc/yum.repos.d/science-openturns.repo
curl https://download.opensuse.org/repositories/science:/openturns/15.5/science:openturns.repo -o /etc/zypp/repos.d/science-openturns.repo
curl https://download.opensuse.org/repositories/science:/openturns/Mageia_9/science:openturns.repo -o /etc/yum.repos.d/science-openturns.repo
Import the gpg key corresponding to your operating system::
rpm --import https://download.opensuse.org/repositories/science:/openturns/CentOS_8/repodata/repomd.xml.key
rpm --import https://download.opensuse.org/repositories/science:/openturns/Fedora_39/repodata/repomd.xml.key
rpm --import https://download.opensuse.org/repositories/science:/openturns/Fedora_40/repodata/repomd.xml.key
rpm --import https://download.opensuse.org/repositories/science:/openturns/15.5/repodata/repomd.xml.key
rpm --import https://download.opensuse.org/repositories/science:/openturns/Mageia_9/repodata/repomd.xml.key
The following packages are available:
.. table::
+----------------------+------------------------------------+
| Package name | Description |
+======================+====================================+
| openturns-libs | library |
+----------------------+------------------------------------+
| openturns-devel | development package |
+----------------------+------------------------------------+
| python3-openturns | Python module |
+----------------------+------------------------------------+
To install the Python module::
yum install python3-openturns
Archlinux
---------
Install from `AUR `_::
aurman -S openturns
FreeBSD
-------
Install from `FreshPorts `_::
pkg install openturns
Vcpkg
-----
Install the C++ library from `vcpkg.link `_::
vcpkg install openturns
Development version
===================
From source
-----------
Refer to the :ref:`library_development` section.
Weekly builds
-------------
Weekly built Python binaries are also available with the latest bugfixes and features, use at your own risk::
pip3 install --pre --extra-index-url https://pypi.anaconda.org/openturns-wheels-nightly/simple --upgrade --force-reinstall openturns