Using-Fidle/Linux-installation-with-pip.md

@@ -5,52 +5,113 @@ This installation procedure is for **Linux**  \
 
 **Note:** If you have a **GPU card**, things can be more complicated than this simplified procedure. We advise you to consult the documentation mentioned above.
 
-## First of all, you need Python !
+## 1 - First of all, you need Python !
 
 A version of python 3.6 to 3.9 is required. 
 
-If python is not available on your system, you can install the version proposed by your Linux distribution or (if you are a bit of a gambler) by compiling a version proposed on [python.org](https://www.python.org/downloads/source/)
-
 For example, under Debian :
 
 ```
 apt-get install python3 python3-dev python3-pip python3-venv
 ```
+## 2 - A folder to contain them all
+
+The idea is to put everything in the same folder, for example `fidle-tp`
+
+```
+$ mkdir ~/fidle-tp
+$ cd ~/fidle-tp
+```
+## 3 - A python environment, just for us !
 
-## Create your pip virtual env
+The idea is to create a virtual python environment, in order not to "pollute" your system.  
+This virtual environment will be contained in a sub folder (fidle-env).  
 
-The idea is to create a virtual python environment, in order not to "pollute" your system. This virtual environment will be contained in a folder (fidle-env). The easiest way is to create this folder next to the one containing the Fidle notebooks :
+Pour créer un environnement virtuel "fidle-en"...  
+et activer celui-ci :
 ```plaintext
-<working directory>
-     ├── fidle                 Contains notebooks
-     ├── fidle-datasets        Contains datasets
-     └── fidle-env             Virtual environment
+$ python -m venv --system-site-packages fidle-env
+$ source ./fidle-env/bin/activate
 ```
-To create your virtual env from your working directory, get a shell and go into your working directory :
+
+We can now install all the necessary modules in our python environment :
+
 ```plaintext
-cd <working directory>
-python -m venv --system-site-packages fidle-env
+$ pip install --upgrade tensorflow==2.9 Scikit-image Scikit-learn     \
+                        Matplotlib plotly barviz Pandas Pandoc pyyaml \
+                        Jupyterlab fidle
 ```
 
-This will create a folder `fidle-env` which hosts your environment.
+It will take a little while, but should go very well :-)
 
-## Install Tensorflow and additionnal packages
+## 4 - Install notebooks et datasets 
 
-Still from your working directory, activate your environment, by running :
+Now all that remains is to install the notebooks and datasets :-)  
+Nous allons faire cela avec la commande `fid` de Fidle.
 
-```plaintext
-source fidle-env/bin/activate
+Toujours depuis notre dossier `fidle-tp`
+```
+$ fid install --quiet
 ```
 
-...and then, install Tensorflow, and fidle requested packages :
+## 5 - Installation check
 
+The tree structure is normally as follows:
 ```plaintext
-pip install --upgrade pip
-pip install --upgrade tensorflow
-pip install Scikit-image Scikit-learn Matplotlib Pandas Pandoc pyyaml Jupyterlab
+ fidle-tp
+     ├── fidle                 Contains notebooks
+     ├── fidle-datasets        Contains datasets
+     └── fidle-env             Virtual environment
 ```
 
-It will take a little while, but should go very well :-)
+From a terminal, go to the `fidle-tp` folder,  
+activate the `fidle-env` environment and do a `fid check`.
+
+```
+$ cd (...)/fidle-tp
+$ source ./fidle-env/bin/activate
+$ fid check
+```
+
+You should have something like :  
+(version numbers may vary)
+
+```
+==========================================================
+fid - Your favorite Fidle admin command :-)    (v2.0b38)
+==========================================================
+
+Notebooks and datasets can only be found if they are in/near the explored folder.
+Explored directory is : /home/dupont/fidle-tp
+
+Datasets dir found :
+
+    /home/dupont/fidle-tp/datasets-fidle                 (Datasets Fidle / 1.5b2)
+    The environment variable FIDLE_DATASETS_DIR is :     undefined
+
+Notebooks dir found :
+
+    /home/dupont/fidle-tp/fidle                          (Notebooks Fidle / 2.1b6)
+
+Check environment :
+
+    Fidle module         : Ok         (2.0b38)
+    tensorflow           : Ok         (2.9.0)
+    tensorflow.keras     : Ok         (2.9.0)
+    numpy                : Ok         (1.23.3)
+    sklearn              : Ok         (1.1.2)
+    skimage              : Ok         (0.19.3)
+    matplotlib           : Ok         (3.6.0)
+    plotly               : Ok         (5.10.0)
+    pandas               : Ok         (1.5.0)
+    jupyterlab           : Ok         (3.4.8)
+    pytorch              : Not found
+    torchvision          : Not found
+```
 
+**Note:**  
+- You can reinstall notebooks or datasets with the `fid install-notebooks` and `fid install-datasets` commands
+- You can also locate the datasets-fidle folder anywhere you want.  
+In this case, you must specify the location of this folder with the environment variable `FIDLE_DATASETS_DIR`
 
 [Back to the install procedure](Using%20Fidle/install%20fidle#linux-users)
\ No newline at end of file