Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente Prochaine révision Les deux révisions suivantes | ||
python:anaconda [2020/10/03 17:26] Francesco Beretta [Plugin jupyterlab-github] |
python:anaconda [2022/02/19 15:42] Francesco Beretta [Installation de JupyterLab] |
||
---|---|---|---|
Ligne 16: | Ligne 16: | ||
Cf. [[https://docs.python.org/fr/3/tutorial/venv.html|Environnements virtuels et paquets]]. | Cf. [[https://docs.python.org/fr/3/tutorial/venv.html|Environnements virtuels et paquets]]. | ||
- | Plusieurs outils de gestion d'environnements virtuels existent, construits autour de PIP (cf. documentation officielle de Python). Comme nous pratiquons ici une approche orientée analyse de données (et non développement web ou développement d'applications), nous avons privilégié le gestionnaire de paquets Conda (cf. ci-dessous). De plus, Conda permet d'installer des paquets d'autres langages informatiques, tel R, node.js ou java. Il est donc particulièrement intéressant et fléxible pour notre but. | + | Plusieurs outils de gestion d'environnements virtuels existent, construits autour de PIP (cf. documentation officielle de Python). Comme nous pratiquons ici une approche orientée analyse de données (et non développement web ou développement d'applications), nous avons privilégié le gestionnaire de paquets Conda (cf. ci-dessous), ainsi qu'un édrivé plus performant appelé [[https://mamba.readthedocs.io/en/latest/index.html|Mamba]]. |
+ | |||
+ | Ces deux gestionnaires d'environnements permettent d'installer des paquets d'autres langages informatiques, tel R, node.js ou java. Il est donc particulièrement intéressant et fléxible pour notre but. | ||
Ligne 22: | Ligne 24: | ||
* [[https://www.anaconda.com/what-is-anaconda/|Ce qu'est Anaconda]] – [[https://docs.conda.io/projects/conda/en/latest/index.html|ce qu'est Conda]] | * [[https://www.anaconda.com/what-is-anaconda/|Ce qu'est Anaconda]] – [[https://docs.conda.io/projects/conda/en/latest/index.html|ce qu'est Conda]] | ||
- | * Installer [[https://docs.conda.io/en/latest/miniconda.html|Miniconda]]. Dans le cadre de ce tutoriel, la version de python pouvant être utilisée est la **3.7**. | + | * Installer [[https://docs.conda.io/en/latest/miniconda.html|Miniconda]]. Dans le cadre de ce tutoriel, la version de python de référence est la **3.9**. |
* Quelle différence entre Anaconda et Miniconda ? [[https://www.anaconda.com/download/|Anaconda]] apporte, en plus du gestionnaire d'environnements Python //conda//, une interface graphique complète et différents logiciels. L'environnement risque d'être un peu lourd – pour des petits projets **Miniconda** est préférable. Il n'est pas recommandé, dans le cadre de cet atelier, de créer un environnement avec le logiciel Anaconda, car cela pose problème par la suite. | * Quelle différence entre Anaconda et Miniconda ? [[https://www.anaconda.com/download/|Anaconda]] apporte, en plus du gestionnaire d'environnements Python //conda//, une interface graphique complète et différents logiciels. L'environnement risque d'être un peu lourd – pour des petits projets **Miniconda** est préférable. Il n'est pas recommandé, dans le cadre de cet atelier, de créer un environnement avec le logiciel Anaconda, car cela pose problème par la suite. | ||
* [[https://zestedesavoir.com/tutoriels/1448/installer-un-environnement-de-developpement-python-avec-conda|Tutoriel en français]] concernant l'utilisation de //conda//. | * [[https://zestedesavoir.com/tutoriels/1448/installer-un-environnement-de-developpement-python-avec-conda|Tutoriel en français]] concernant l'utilisation de //conda//. | ||
Ligne 35: | Ligne 37: | ||
* Télécharger [[https://docs.conda.io/en/latest/miniconda.html|Miniconda]] et installer en suivant les instructions de l'installateur. Sous Windows et Linux choisir la version adaptée au système : 32 ou 64 bits. | * Télécharger [[https://docs.conda.io/en/latest/miniconda.html|Miniconda]] et installer en suivant les instructions de l'installateur. Sous Windows et Linux choisir la version adaptée au système : 32 ou 64 bits. | ||
- | ===== Windows et macOS ===== | + | ===== Windows et MacOS ===== |
* Relever l'emplacement d'installation | * Relever l'emplacement d'installation | ||
Ligne 41: | Ligne 43: | ||
* Cocher : **Conda comme installation Python par défaut** | * Cocher : **Conda comme installation Python par défaut** | ||
* **Ne pas cocher**: "Ajouter au PATH" ! | * **Ne pas cocher**: "Ajouter au PATH" ! | ||
- | * [Octobre 2020] L'installateur de Miniconda dans Windows 10 déconseille de l'ajouter au PATH, à cause de problèmes qui pourraient survenir Dans le menu de démarrage Windows (Windows Start menu) sélectionner "Anaconda 64bit". L'ajout au PATH peut provoquer des problèmes. | + | * [Octobre 2020] L'installateur de Miniconda dans Windows 10 déconseille de l'ajouter au PATH, à cause de problèmes qui pourraient survenir. |
+ | * Dans le menu de démarrage Windows (Windows Start menu) sélectionner "Anaconda 64bit". L'ajout au PATH peut provoquer des problèmes. | ||
* Conda n'est pas ajouté au PATH, utiliser le programme //Anaconda prompt// après installation. Si Conda n'est toujours pas visible, voir ci-dessous les Problèmes/bugs | * Conda n'est pas ajouté au PATH, utiliser le programme //Anaconda prompt// après installation. Si Conda n'est toujours pas visible, voir ci-dessous les Problèmes/bugs | ||
Ligne 53: | Ligne 56: | ||
* Vérifier l'installation de Conda en exécutant la commande ci-dessous qui donne la version de conda: <code>conda info</code> | * Vérifier l'installation de Conda en exécutant la commande ci-dessous qui donne la version de conda: <code>conda info</code> | ||
* la liste des paquets installés dans l'environnement de base: <code>conda list</code> | * la liste des paquets installés dans l'environnement de base: <code>conda list</code> | ||
+ | * la liste des environnements disponibles: <code>conda env list</code> | ||
+ | * Au début il n'y aura que l'nevironnement de 'base' | ||
+ | * Attention : n'installer aucun paquet dans l'environnement de base ! Toujours créer un nouvel environnement. | ||
* En cas d'erreur, si par exemple CMD (Windows) / Terminal (MacOS) renvoit le message d'erreur suivant <code>conda: command not found error</code> voir Problèmes / Bugs ci-dessous. | * En cas d'erreur, si par exemple CMD (Windows) / Terminal (MacOS) renvoit le message d'erreur suivant <code>conda: command not found error</code> voir Problèmes / Bugs ci-dessous. | ||
* Exécuter tout d'abord une mise à jour de Conda: <code>conda update conda</code> | * Exécuter tout d'abord une mise à jour de Conda: <code>conda update conda</code> | ||
Ligne 79: | Ligne 85: | ||
- | ====== Installation de JupyterLab et ses plugins ====== | + | ====== Installation de JupyterLab ====== |
+ | |||
+ | |||
+ | ===== Ajout du canal conda-forge ===== | ||
Ligne 85: | Ligne 94: | ||
* Ajouter le canal 'conda-forge' : <code>conda config --add channels conda-forge</code> | * Ajouter le canal 'conda-forge' : <code>conda config --add channels conda-forge</code> | ||
* Vérifier l'ajout du canal <code>conda info</code>: apparait la liste des canaux | * Vérifier l'ajout du canal <code>conda info</code>: apparait la liste des canaux | ||
+ | * Vérifier la liste des canaux prioritaires: <code>conda config --show channels</code> doit donner comme résultat: | ||
+ | <code>channels: | ||
+ | - conda-forge | ||
+ | - defaults | ||
+ | </code> | ||
+ | * Si l'ordre est inversé, effectuer: <code>conda config --set channel_priority strict</code>, puis vérifier l'ordre des canaux avec <code>conda config --show channels</code> 'conda-forge' doit être en premier. | ||
+ | ===== Installation et activation de JupyterLab ===== | ||
* Créer ensuite un environnement contenant Jupyter Lab: conda create --name <envname> python=<version>. | * Créer ensuite un environnement contenant Jupyter Lab: conda create --name <envname> python=<version>. | ||
* Pour **MacOS** exécuter: <code>conda create --name py37_jupyterlab python=3.7 jupyterlab=1.2.7 requests</code> | * Pour **MacOS** exécuter: <code>conda create --name py37_jupyterlab python=3.7 jupyterlab=1.2.7 requests</code> | ||
- | * Pour **Windows** exécuter: <code>conda create --name py37_jupyterlab python=3.7 jupyterlab pywin32 requests</code> | + | * Pour **Windows** système à 32-bit exécuter: <code>conda create --name py37_jupyterlab python=3.7 jupyterlab pywin32 requests</code> |
- | * En cas d'erreur, tenter: <code>conda create --name [nom de dossier] python=3.8 jupyterlab pywin32 jupyterlab-git requests -c conda-forge</code> | ||
* Lorsque l'exécutable demande : installer y/n répondre y = yes | * Lorsque l'exécutable demande : installer y/n répondre y = yes | ||
Ligne 98: | Ligne 113: | ||
* Pour désactiver l'environnement et revenir à l'environnement 'base: <code>conda deactivate</code> | * Pour désactiver l'environnement et revenir à l'environnement 'base: <code>conda deactivate</code> | ||
* Démarrer Juypter Lab : <code>jupyter lab</code> | * Démarrer Juypter Lab : <code>jupyter lab</code> | ||
- | * Pour **arrêter Jupyter Lab**: tabler dans le Terminal ou Prompt où il est actif **alt-C** pour Windows ou **ctrl-C** pour Mac. | + | * Pour **arrêter Jupyter Lab**: taper dans le Terminal ou Prompt où il est actif **alt-C** pour Windows ou **ctrl-C** pour Mac. |
* Si on veut ajouter des nouveau paquets à l'environnement, **arrêter Jupyter Lab** , puis ajouter les paquets à l'environnement actif, dans ce cas //py37_gitlab// puis relancer le Lab. | * Si on veut ajouter des nouveau paquets à l'environnement, **arrêter Jupyter Lab** , puis ajouter les paquets à l'environnement actif, dans ce cas //py37_gitlab// puis relancer le Lab. | ||
* Pour utiliser différents environnements, dédiés à différents projets ou technologies (NLP, etc.) voir les [[python:environnement_conda&#creer_un_nouvel_environnement_atelier_et_l_ajouter_aux_kernels_de_jupyter_lab|instructions sur cette page]] | * Pour utiliser différents environnements, dédiés à différents projets ou technologies (NLP, etc.) voir les [[python:environnement_conda&#creer_un_nouvel_environnement_atelier_et_l_ajouter_aux_kernels_de_jupyter_lab|instructions sur cette page]] | ||
+ | |||
\\ | \\ | ||
+ | -------------- | ||
+ | ====== Utilisateurs avancés – Plugins de JupyterLab ====== | ||
+ | L'installation de ce qui suit n'est pas nécessaire pour les cas d'usage habituels. | ||
+ | |||
+ | \\ | ||
===== Plugin jupyterlab-github ===== | ===== Plugin jupyterlab-github ===== | ||
- | * Pour **arrêter Jupyter Lab**: tabler dans le Terminal ou Prompt où il est actif **alt-C** pour Windows ou **ctrl-C** pour Mac. | + | * Documentation [[https://github.com/jupyterlab/jupyterlab-github|JupyterLab GitHub]]. |
+ | * **Arrêter Jupyter Lab** (dans le Terminal ou Prompt où il est actif taper **alt-C** pour Windows ou **ctrl-C** pour Mac). | ||
* Vérifier qu'on est bien dans l'environnement 'py37_jupyterlab' | * Vérifier qu'on est bien dans l'environnement 'py37_jupyterlab' | ||
* Exécuter: <code>conda install -c conda-forge nodejs</code> | * Exécuter: <code>conda install -c conda-forge nodejs</code> | ||
Ligne 131: | Ligne 153: | ||
Dans le cadre de l'atelier Données FAIR (FAIR Data), nous pouvons par exemple utiliser **atterebf** comme nom d'utilisateur. Une liste de dépôt github s'affiche, sélectionnez **atelier_arhn**, puis **import_csv_xls**, et enfin le carnet jupyter **import_csv.ipynb** (qui est en lecture seule). | Dans le cadre de l'atelier Données FAIR (FAIR Data), nous pouvons par exemple utiliser **atterebf** comme nom d'utilisateur. Une liste de dépôt github s'affiche, sélectionnez **atelier_arhn**, puis **import_csv_xls**, et enfin le carnet jupyter **import_csv.ipynb** (qui est en lecture seule). | ||
- | |||
\\ | \\ | ||
- | -------------- | ||
- | ====== Utilisateurs avancés ====== | ||
- | |||
===== Plugin jupyterlab-git ===== | ===== Plugin jupyterlab-git ===== | ||