Skip to content

Commit

Permalink
updated readme
Browse files Browse the repository at this point in the history
  • Loading branch information
willGuimont committed Aug 20, 2022
1 parent 2ad4c18 commit c49f849
Showing 1 changed file with 30 additions and 20 deletions.
50 changes: 30 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,11 @@
# Laboratoires des cours GLO-4001 et GLO-7021

# Laboratoires
**À distance:**: Seul ou en équipe. Matériel requis: ordinateur.

Cours GLO-4001 et GLO-7021. En équipe de deux ou plus. Matériel requis: un ordinateur portable
**En présentiel:** En équipe de deux ou plus. Matériel requis: un ordinateur portable
par équipe (pour la connexion wifi), une plate-forme robotique par équipe.

Le responsable des laboratoires est Maxime Vaidis (maxime.vaidis[email protected]).
Le responsable des laboratoires est William Guimont-Martin (william.guimont-martin[email protected]).

<!-- markdown-toc start - Don't edit this section. Run M-x markdown-toc-generate-toc again -->
**Table des matières**
Expand All @@ -29,7 +30,14 @@ Le responsable des laboratoires est Maxime Vaidis ([email protected]).
## Introduction

Cette série de laboratoires vous fera expérimenter certains aspects vus dans le
cours de robotique mobile. Nous disposons de vraies plate-formes robotiques
cours de robotique mobile.

À distance, nous avons un simulateur permettant d'expérimenter avec des robots virtuel. Un simulateur
de robotique est un outil extrêmement pratique pour, entre autres,
tester des algorithmes, expérimenter dans différents environments,
entraîner des modèles d'apprentissage automatique et valider son code.

En présentiel, nous disposons de vraies plate-formes robotiques
*Kobuki* de la compagnie iClebo. Toutes les plate-formes disposent d'un
ordinateur de bord *Kangaroo*, une paire de capteurs infra-rouge, une caméra
*Kinect* et un IMU intégré. Ce plus, certaines plate-formes sont équipées avec un
Expand All @@ -53,7 +61,9 @@ exécution et du texte. Voici un exemple de *jupyter notebook* à l'oeuvre.

## Machine virtuelle et simulateur

Il est aussi possible d'un simulateur plutôt que la base `kobuki`. Pour ce faire, veuillez télécharger la machine virtuelle disponible à [cette adresse](http://www2.ift.ulaval.ca/~pgiguere/download/glo4001-v2.zip).
Il est aussi possible d'un simulateur plutôt que la base `kobuki`.
Pour ce faire, veuillez télécharger la machine virtuelle
disponible à [cette adresse](http://www2.ift.ulaval.ca/~pgiguere/download/glo4001-v2.zip).

Les instructions pour mettre en marche le simulateur se trouvent dans le laboratoire 0.

Expand All @@ -71,9 +81,7 @@ généraliser à d'autres distributions (et peut-être même MacOS).

Grâce à la ligne de commande, nous allons créer un `virtualenv` python qui
contient les logiciels nécessaires pour faire les laboratoires. Assurez-vous
d'abord d'avoir les paquets suivants.

Pour Ubuntu 20.04 et plus:
d'abord d'avoir les paquets suivants:

```bash
$ sudo apt install python3-pip python3-venv python3-testresources
Expand All @@ -82,16 +90,18 @@ $ sudo apt install python3-pip python3-venv python3-testresources
Ensuite, créez un environnement virtuel avec la commande suivante.

```
$ python3 -m venv <NOM_DU_VENV>
$ python3 -m venv venv
```

Activez l'environment avec:

```
$ source <NOM_DU_VENV>/bin/activate
$ source venv/bin/activate
```

Si l'activation a réussi, vous verrez `<NOM_DU_VENV>` à la gauche de votre invite de commande.
Vous devrez activer l'environnement avant de débuter chaque laboratoire.

Si l'activation a réussi, vous verrez `(venv)` à la gauche de votre invite de commande.

#### Acquisition du code des laboratoires

Expand Down Expand Up @@ -122,10 +132,11 @@ partir de l'intérieur du repo `glo4001`.
$ jupyter notebook
```

Avec un peu de chance, votre navigateur web devrait ouvrir un nouvel onglet pointant sur le notebook *jupyter*. Bien joué! Maintenant, vous pouvez ouvrir le fichier `Laboratoire 0.ipynb` et vous
connecter à votre robot.
Avec un peu de chance, votre navigateur web devrait ouvrir un nouvel onglet pointant sur le notebook *jupyter*.
Bien joué! Maintenant, vous pouvez ouvrir le fichier `Laboratoire 0.ipynb` et vous connecter à votre robot.

Si vous obtenez une erreur comme quoi jupyter n'est pas une commande, ouvrez le fichier `.bashrc` avec `gedit ~/.bashrc`. Ensuit, ajoutez-y la ligne suivante à la toute fin:
Si vous obtenez une erreur comme quoi jupyter n'est pas une commande,
ouvrez le fichier `.bashrc` avec `gedit ~/.bashrc`. Ensuit, ajoutez-y la ligne suivante à la toute fin:

```
export PATH=$PATH:/home/student/.local/bin
Expand All @@ -134,26 +145,26 @@ export PATH=$PATH:/home/student/.local/bin
Si vous obtenez une erreur de connexion au kernel, essayez la commande suivante:

```bash
pip3 isntall -I notebook
pip3 install -I notebook
```

### Windows

#### Installation de anaconda

Visitez [ce site](https://www.continuum.io/downloads) pour télécharger la
distribution anaconda. Anaconda contient python ainsi qu'un série de librairies
utilisées dans les laboratoires. Assurez vous de vous procurer la version *Python 3.5*.
distribution anaconda. Anaconda contient python ainsi qu'une série de librairies
utilisées dans les laboratoires. Assurez-vous de vous procurer la version *Python 3.5 ou plus*.

Installez anaconda, en conservant les options d'installation par défaut, qui sont

- Installation locale (single user)
- Ajout de anaconda au *PATH*
- Sélection de anaconda comme python 3.5 par défaut
- Sélection de anaconda comme python par défaut

#### Téléchargement du code du cours

Visitez ensuite [cette adresse](https://github.com/davidlandry93/glo4001) et téléchargez
Visitez ensuite [cette adresse](https://github.com/norlab-ulaval/glo4001) et téléchargez
le code du cours. En appuyant sur le bouton *clone or download*, vous pourrez télécharger
une version `.zip` de repo. Faites l'extraction du code du cours à un endroit approprié.

Expand All @@ -176,7 +187,6 @@ Depuis la *anaconda prompt*, allez dans le dossier contenant le code du cours, p
```
jupyter notebook
```


## Lancer un laboratoire

Expand Down

0 comments on commit c49f849

Please sign in to comment.