3885
Comment:
|
4116
|
Deletions are marked like this. | Additions are marked like this. |
Line 1: | Line 1: |
#rev 2020-09-10 bonaccos |
|
Line 3: | Line 5: |
We provide as many modules as possible that come with the current Debian GNU/Linux stable release. Nevertheless, that might not be enough for your needs since you may want to use the newest version of some module or one that is not part of Debian. Furthermore you might want to use a different version of Python. | We provide some modules that come with the current Debian GNU/Linux stable release, but usually this is because they are dependencies of an installed software. For python we strongly recommend to build own python environments with the desired python versions and modules. |
Line 5: | Line 7: |
The recommended way to install additional python modules is through {{{pip}}}. Unfortunately, {{{pip}}} does not allow users to install modules in the user context. That means that you will first have to install your own version of python in your home. From that moment on, you can install modules through {{{pip}}}. | Our recommended way to install such environments is trough Conda, alternatively via building an environment via `pyenv` is as well possible. Additional module can then either be installed by conda itself or trough `pip`. |
Line 7: | Line 9: |
== Installing your own python environment with Conda == For a detailed overview for conda please follow to the [[Programming/Languages/Conda|Conda documentation]]. |
|
Line 10: | Line 15: |
{{{Pyenv}}} is a collection of tools that allow users to manage different versions of python. In the simplest case you will need it to simply get an installation of python in your user space. Using that custom python installation, you will then be able to install additional modules in a very comfortable way, since you can install them in the "system path" (which is then somewhere within your home). | `Pyenv` is a collection of tools that allow users to manage different versions of python. In the simplest case you will need it to simply get an installation of python in your user space. Using that custom python installation, you will then be able to install additional modules in a very comfortable way, since you can install them in the "system path" (which is then somewhere within your home). |
Line 12: | Line 17: |
Here is a small howto for installing python 2.7.11 in your home: | Documentation on `pyenv` can be found at https://github.com/pyenv/pyenv Here is a small howto for installing python 3.9.1 in your home: |
Line 16: | Line 23: |
curl -L https://raw.githubusercontent.com/yyuu/pyenv-installer/master/bin/pyenv-installer | bash}}} * Add the following three lines to your ~/.bashrc: |
curl https://raw.githubusercontent.com/pyenv/pyenv-installer/master/bin/pyenv-installer -o pyenv-installer }}} Check what the script is doing and then execute it: {{{ bash ./pyenv-installer }}} You can remove the installer file afterwards. * Add the following three lines to your ~/.bash_profile: |
Line 28: | Line 40: |
* Install some python version, e.g. for python 2.7.11: | * Install some python version, e.g. for python 3.9.1: |
Line 30: | Line 42: |
pyenv install 2.7.11 | env PYTHON_CONFIGURE_OPTS="--enable-shared" pyenv install 3.9.1 |
Line 32: | Line 44: |
* If you need to link against the libpython shared library, then you will need to configure python to build the shared libaries: {{{ env PYTHON_CONFIGURE_OPTS="--enable-shared” pyenv install 2.7.11}}} |
Note, that settting of `PYTHON_CONFIGURE_OPTS="--enable-shared"` is needed if you need to link against the libpython shared library. |
Line 39: | Line 48: |
pyenv global 2.7.11}}} | pyenv global 3.9.1}}} |
Line 46: | Line 55: |
|| Website of pyenv || https://github.com/yyuu/pyenv/ || || Website of pyenv installer || https://github.com/yyuu/pyenv-installer || |
|| Website of pyenv || https://github.com/pyenv/pyenv || || Website of pyenv installer || https://github.com/pyenv/pyenv-installer || |
Line 52: | Line 61: |
Once you installed your custom python with the explanations given above, you are ready to install additional or newer modules the easy way. The usage of {{{pip}}} is very easy. The following command installs the module {{{numpy}}} | Once you installed your custom python with the explanations given above, you are ready to install additional or newer modules the easy way. The usage of `pip` is very easy. The following command installs the module `numpy`. |
Line 54: | Line 63: |
pip install numpy}}} | pip install numpy }}} |
Line 57: | Line 67: |
pip install --upgrade numpy}}} | pip install --upgrade numpy }}} |
Line 59: | Line 70: |
For advanced usage of {{{pip}}}, please consult the manuals: http://pip.readthedocs.org/en/latest/ | For advanced usage of `pip`, please consult the manuals: https://pip.pypa.io/en/latest/ |
Line 64: | Line 75: |
Here we provide some shell script snippets for installing frequently asked modules which cannot be installed through {{{pip}}}. These scripts just provide an example installation. You might have to adapt some paths in order to make the module work correctly with the version of python you are using (e.g. if you run your custom python provided through {{{pyenv}}}). | Here we provide some shell script snippets for installing frequently asked modules which cannot be installed through {{{pip}}}. These scripts just provide an example installation. You might have to adapt some paths in order to make the module work correctly with the version of python you are using (e.g. if you run your custom python provided through `pyenv`). |
Python
We provide some modules that come with the current Debian GNU/Linux stable release, but usually this is because they are dependencies of an installed software. For python we strongly recommend to build own python environments with the desired python versions and modules.
Our recommended way to install such environments is trough Conda, alternatively via building an environment via pyenv is as well possible. Additional module can then either be installed by conda itself or trough pip.
Installing your own python environment with Conda
For a detailed overview for conda please follow to the Conda documentation.
Installing your own python versions with pyenv
Pyenv is a collection of tools that allow users to manage different versions of python. In the simplest case you will need it to simply get an installation of python in your user space. Using that custom python installation, you will then be able to install additional modules in a very comfortable way, since you can install them in the "system path" (which is then somewhere within your home).
Documentation on pyenv can be found at https://github.com/pyenv/pyenv
Here is a small howto for installing python 3.9.1 in your home:
- Install pyenv:
curl https://raw.githubusercontent.com/pyenv/pyenv-installer/master/bin/pyenv-installer -o pyenv-installer
Check what the script is doing and then execute it:bash ./pyenv-installer
You can remove the installer file afterwards. - Add the following three lines to your ~/.bash_profile:
export PATH="$HOME/.pyenv/bin:$PATH" eval "$(pyenv init -)" eval "$(pyenv virtualenv-init -)"
- Restart your shell so the path changes take effect:
exec $SHELL
- Install some python version, e.g. for python 3.9.1:
env PYTHON_CONFIGURE_OPTS="--enable-shared" pyenv install 3.9.1 pyenv rehash
Note, that settting of PYTHON_CONFIGURE_OPTS="--enable-shared" is needed if you need to link against the libpython shared library.
- Make sure that this new python version will be used when you run python. You only need to run this command once:
pyenv global 3.9.1
In order to update pyenv run:
pyenv update
Documentation of pyenv
Website of pyenv
Website of pyenv installer
Installation of additional or newer modules with pip
Once you installed your custom python with the explanations given above, you are ready to install additional or newer modules the easy way. The usage of pip is very easy. The following command installs the module numpy.
pip install numpy
while the next command would upgrade an existing installation of numpy
pip install --upgrade numpy
For advanced usage of pip, please consult the manuals: https://pip.pypa.io/en/latest/
Installation of Python modules that are not available in the archives of pip
Here we provide some shell script snippets for installing frequently asked modules which cannot be installed through pip. These scripts just provide an example installation. You might have to adapt some paths in order to make the module work correctly with the version of python you are using (e.g. if you run your custom python provided through pyenv).
nlopt
1 #!/bin/bash
2
3 # Installation script for nlopt library
4
5 VERSION=2.3
6 INSTALLDIR=$HOME/.local
7 BUILDDIR=/scratch/$USER/nlopt
8
9 mkdir -p $BUILDDIR
10 cd $BUILDDIR
11
12 wget "http://ab-initio.mit.edu/nlopt/nlopt-${VERSION}.tar.gz"
13 tar -xvvzkf nlopt-${VERSION}.tar.gz
14 cd nlopt-${VERSION}
15
16 ./configure \
17 --enable-shared \
18 --prefix=$INSTALLDIR \
19 OCT_INSTALL_DIR=$INSTALLDIR/octave/oct \
20 M_INSTALL_DIR=$INSTALLDIR/octave/m/ \
21 MEX_INSTALL_DIR=$INSTALLDIR/mex \
22 GUILE_INSTALL_DIR=$INSTALLDIR/guile
23
24 make
25 make install