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:
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.
Exécuter l’exécutable téléchargé
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
où 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
où 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
où 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.