1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161
|
.. _install:
============
Installation
============
From binary packages
====================
Pip
---
Install binary packages from `PyPI <https://pypi.org/project/openturns/>`_::
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 <http://conda.pydata.org/>`_ userland Python package manager.
As binary dependency packages from the `conda-forge <https://conda-forge.org>`_
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 <https://github.com/conda-forge/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 <https://github.com/openturns/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 <https://github.com/openturns/build/releases>`_
Then just run installer and follow the instructions.
A non-interactive installation is also possible with the command line::
openturns-1.26-py312-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 plucky main | sudo tee /etc/apt/sources.list.d/openturns.list
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
echo deb https://openturns.github.io/apt/debian trixie 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/Fedora_42/science:openturns.repo -o /etc/yum.repos.d/science-openturns.repo
curl https://download.opensuse.org/repositories/science:/openturns/Fedora_43/science:openturns.repo -o /etc/yum.repos.d/science-openturns.repo
curl https://download.opensuse.org/repositories/science:/openturns/16.0/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/Fedora_42/repodata/repomd.xml.key
rpm --import https://download.opensuse.org/repositories/science:/openturns/Fedora_43/repodata/repomd.xml.key
rpm --import https://download.opensuse.org/repositories/science:/openturns/16.0/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 <https://aur.archlinux.org/packages/openturns/>`_::
aurman -S openturns
FreeBSD
-------
Install from `FreshPorts <https://www.freshports.org/math/openturns/>`_::
pkg install openturns
Vcpkg
-----
Install the C++ library from `vcpkg.link <https://vcpkg.link/ports/openturns>`_::
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
|