diff --git a/README.md b/README.md index e7a0179eb020c0816c52cacb27d58f42694e452e..fc9aafc4e24cbd6c5217a3fb955d4f608ef410f5 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,8 @@ + + # Tutoriel - ANF TDM 2022 Python Geoparsing + Supports pour l'atelier [Librairies Python et Services Web pour la reconnaissance d’entités nommées et la résolution de toponymes](https://anf-tdm-2022.sciencesconf.org/resource/page/id/11) de la formation CNRS [ANF TDM 2022](https://anf-tdm-2022.sciencesconf.org). @@ -27,7 +30,14 @@ Nous expérimenterons et comparerons ces librairies au travers deux études de c Vous pouvez exécuter le notebook à distance en utilisant [](http://colab.research.google.com/) ou [](https://mybinder.org/v2/git/https%3A%2F%2Fgitlab.liris.cnrs.fr%2Flmoncla%2Ftutoriel-anf-tdm-2022-python-geoparsing.git/HEAD?labpath=Tutoriel-geoparsing.ipynb). Sinon, pour exécuter ce tutoriel depuis un environnement local sur votre ordinateur, vous pouvez suivre les instructions ci-dessous. +## Installer conda +[Conda](https://conda.io/projects/conda/en/latest/index.html) est un système de gestion de paquets et d'environnement open source. Il installe, exécute et met à jour rapidement les paquets et leurs dépendances. +Nous l'utiliserons pour gérer l'environnement python et toutes les bibliothèques python nécessaires pour les tutoriels. +Il existe plusieurs façons d'installer conda sur votre ordinateur : +1. [Anaconda distribution](https://www.anaconda.com/products/distribution): fournit des applications, de nombreux paquets de science des données et d'apprentissage automatique sont déjà installés. +2. [Miniconda](https://docs.conda.io/en/latest/miniconda.html): une installation minimale pour conda, sans application graphique +3. [Miniforge](https://github.com/conda-forge/miniforge): une autre installation minimale pour conda, sans application graphique (recommandée pour les puces Mac ARM M1 ou M2 (Apple Silicon)) ## Configurer un environnement conda @@ -43,10 +53,16 @@ git clone https://gitlab.liris.cnrs.fr/lmoncla/tutoriel-anf-tdm-2022-python-geop #### Méthode 1 -* Créer un nouvel environnement nommé `tdm-geoparsing-py39` avec toutes les dépendances nécessaire en utilisant le fichier de configuration `environment.yml` : +* Uilisateurs MacOS/Linux : Créer un nouvel environnement nommé `tdm-geoparsing-py39` avec toutes les dépendances nécessaire en utilisant le fichier de configuration `environment-osx-linux.yml` : + +```bash +conda env create -f environment-osx-linux.yml +``` + +* Uilisateurs Windows : Créer un nouvel environnement nommé `tdm-geoparsing-py39` avec toutes les dépendances nécessaire en utilisant le fichier de configuration `environment-win64.yml` : ```bash -conda env create -f environment.yml +conda env create -f environment-win64.yml ``` * Activer l'environnement @@ -70,6 +86,12 @@ conda create -n tdm-geoparsing-py39 python=3.9 conda activate tdm-geoparsing-py39 ``` +* Installer le paquet `fiona` avec conda (évite une erreur lors de l'installation de cette dépendence avec `pip`) + +```bash +conda install fiona==1.8.21 +``` + * Installer les dépendances avec `pip` ```bash