Installation de python

Il est recommandé d’utiliser Miniconda3 pour installer Python et gérer les dépendances entre les bibliothèques complémentaires à installer.

Miniconda

Les programmes du paquet pySPC requiert l’installation de Python 3 (ou supérieur).

Avertissement

En raison de la rupture de comptabilité avec Python 2, il est impossible d’utiliser les Versions 2.x et antérieures.

La distribution Miniconda3 permet d’installer python 3 et offre un moyen facile d’installer des bibliothèques supplémentaires. Elle permet également de disposer de plusieurs environnements python avec leur configuration propres (Versions majeures/mineures différentes, Versions de bibliothèques différentes), en plus de l’environnement par défaut, grâce à la bibliothèque virtualenv

Avertissement

Il est conseillé d’installer la version 32 bits. La version 64 présente des instabilités lorsque la bibliothèque tierce pyodbc est utilisée

Note

Miniconda3 installe la dernière Version de Python 3 comme environnement par défaut. Miniconda2 installe, quant à lui, la dernière Version de Python 2.

Pour installer Miniconda3, il faut:

  1. Télécharger l’exécutable sur ce site, en veillant a bien sélectionner le bon fichier qui correspond à votre système d’exploitation et à la Version Python que vous souhaitez par défaut.

  2. Exécuter l’exécutable téléchargé

  3. Configurer les variables d’environnement http_proxy et https_proxy si vous êtes sur un réseau particulier, afin de permettre à Miniconda d’accéder aux serveurs contenant les installeurs de bibliothèques et de python.

Avertissement

Ceci peut impacter d’autres programmes. Si vous ne souhaitez pas perturber ces autres programmes, vous pouvez définir cette variable d’environnement lors de l’appel au programme conda

set http_proxy=http://(host):(port) && conda xxxx

Environnements complémentaires

Si vous souhaitez créer un environnement spécifique pour pySPC, évitant ainsi toute interaction incorrecte avec d’autres projets, vous pouvez créer un environnement complémentaire, isolé des environnements existants, en lançant la commande suivante:

conda create -n name python=X

name est le nom de l’environnement ainsi défini, et X la Version de python voulue pour cet environnement. Vous pouvez aussi spécifier une Version particulière d’une bibliothèque lib lors de la construction de l’environnement

conda create -n name python=X lib=Y

Y est la Version de la biliothèque lib voulue. Pour connaître les informations et bibliothèques installées au sein d’un environnement, il suffit de lancer la commande

conda list -n name

Ici, name peut contenir root pour accéder à l’information de l’environnement par défaut. Pour passer d’un environnement préalablement créé, il suffit de lancer la commande

call activate name

name est le nom de l’environnement. Pour retourner dans l’environnement par défaut, il faut lancer la commande

call deactivate name

Avertissement

Si vous créez un environnement spécifique pour ce module, il est nécessaire de modifier le fichier pySPC.bat afin d’y ajouter une commande call activate name avant le lancement de python et une commande call deactivate en fin du bat. Ici, name est à remplacer par le nom de votre environnement dédié.

Bibliothèques tierces

pySPC requiert un certain nombre de Bibliothèques tierces. Les dépendances, nécessitant une compilation, sont à installer préalablement avec Miniconda, par exemple à l’aide du fichier de requirements:

conda install –file requirements.txt

Note

Le fichier requirements.txt est disponible dans le répertoire resources/install/ du projet pySPC.

Si vous souhaitez créer un environnement dédié et installer les bibliothèques tierces en même temps, vous pouvez suivre la commande suivante:

conda env create -f environment.yml

Note

Le fichier environment.yml est disponible dans le répertoire resources/install/ du projet pySPC.

Si vous souhaitez compléter votre installationm en installant une bibliothèque lib, il faut simplement lancer la commande suivante:

conda install lib

Si la bibliothèque lib requiert d’autres bibliothèques, Miniconda se charge de les installer en même temps.

Avertissement

Il est possible que certaines bibliothèques ne soient pas reconnues par Miniconda. C’est notamment le cas de pdfminer3k. Dans ce cas, il faut suivre l’une des procédures décrites dans API de pyspc.