jumeaux-numeriques/README.md

# Jumeaux numériques
<!-- # Digital Twin -->

Un jumeau numérique d'un système technique permet de visualiser son comportement à travers une maquette numérique. Le principal intérêt est de valider un
modèle comportemental d'abords par la simulation (avant mise en oeuvre du jumeau réel) puis expérimentalement (mesure des écarts entre les deux jumeaux).

Ici le jumeau numérique d'un système pluritechnologique va nous servir à programmer le système en simulant (hors ligne) son évolution. Nous pourrons alors
mettre en lien les deux jumeaux et appliquer les règles programmées sur le jumeau réel.

Lors de l'exécution du cycle, tous écarts entre les deux jumeaux seront mesurés afin de corriger le modèle comportemental. Par aileurs, les évènements
numériques impacteront le jumeau réel et les évènements réels impacteront aussi le jumeau numérique.

**Systèmes** :

* Monte-charge ([Maquette A4 Technologie](https://www.a4.fr/wiki/index.php?title=Monte_charge_(BE-MCHA)))
* Portail coulissant ([Maquette A4 Technologie](https://www.a4.fr/wiki/index.php?title=Portail_coulissant_(BE-APORT-COUL)))
* Volet roulant ([Maquette A4 Technologie](https://www.a4.fr/wiki/index.php?title=Volet_roulant))

Systèmes dont le jumeau numérique est cours de développement : 
* Labyrinthe à bille : tutoriel  à destination des enseignants souhaitant découvrir la plateforme UPBGE
* Bras robotisé Poppy Ergo Jr ([Poppy](https://www.poppy-project.org/en/robots/poppy-ergo-jr/))
* Robot haptique ([SET](https://setdidact.com/voie-generale-et-technologique/sciences-de-lingenieur/))
* Cobot souple ([Dossier personnel](https://nuage03.apps.education.fr/index.php/s/PMFdMPWprEZoWiR?path=%2F2022))

![Screenshot](img/screenshot-01.jpg)

## Jumelage numérique

Le jumelage numérique est basé sur la liaison série entre l'ordinateur (port USB) et un microcontrôleur Arduino (Uno ou Mega). Suivant les jumeaux numériques,
le protocole de communication peut être le protocole générique Firmata ou un protocole spécifique.

## Téléchargement

Les binaires (Game Engine Runtime) sont hébergés sur [phroy.org](http://www.phroy.org/cloud/index.php/s/JnDeFXRRqQ9abZc).

## Ressources pédagogiques

Les applications pédagogique se trouvent dans le [dépôt des ressouces pédagogiques du projet Blender-EduTech](https://forge.aeif.fr/blender-edutech/blender-edutech-peda) :
- [Enseignements de la spécialité Sciences de l'Ingénieur](https://forge.aeif.fr/blender-edutech/blender-edutech-peda/-/tree/main/Lycee/programmation_python/si/jumeau_numerique).

## Développement

L'environnement de développement est basé sur : la plateforme de modélisation et d'animation 3D Blender ( https://blender.org ), le langage Python
( https://python.org ) et le moteur de jeu 3D UPBGE ( https://upbge.org ).

Les fichiers sources sont dans le groupe Blender-Edutech de la forge de l'AEIF : https://forge.aeif.fr/blender-edutech/jumeau-numerique .

Les bibliothèques suivantes ne sont pas incluses par défaut dans l'environnement UPBGE : 
- [**Pylint**](https://pylint.pycqa.org) : vérificateur du code Python
- [**pySerial**](https://pyserial.readthedocs.io) : communication sur le port série
- [**pyFirmata**](https://pyfirmata.readthedocs.io) : protocole Firmata (protocole générique de communication entre un logiciel et un microcontrôleur)
- [**Matplotlib**](https://matplotlib.org) : grapheur (visualisation de données)
- [**wxPython**](https://www.wxpython.org/) : interface graphique utilisateur (GUI, utilisé ici pour Windows)
- [**pyQt5**](https://www.riverbankcomputing.com/software/pyqt/) : interface graphique utilisateur (GUI, utilisé ici pour GNU/Linux)

<!-- - [**whell**](https://pyfirmata.readthedocs.io) : format de paquet Python -->

Il faut donc les installer localement (dans UPBGE), les étapes sont :
- **GNU/Linux** : La configuration ici présente est UPBGE installé sur ~ avec Python 3.9 :
	- Aller dans le répertoire local de Python de UPBGE: $ cd ~/UPBGE-0.30-linux-x86_64/3.0/python/bin
	- Télécharger le script ['get-pip.py'](https://bootstrap.pypa.io/get-pip.py) pour installer le gestionnaire de paquet [**Pip**](https://pip.pypa.io)
	- Installer le gestionnaire de paquet Pip : $ ./python3.9 get-pip.py
	-  Installer Pylint : $ ./pip install pylint
	- Installer pySerial : $ ./pip install pyserial
	- Installer pyFirmata : $ ./pip install pyfirmata
    - Installer Matplotlib : $ ./pip install matplotlib
    - Installer PyQt5 : $ ./pip install PyQt5
	<!-- - Installer Pylint : $ ./pip install pylint -t ~/UPBGE-0.30-linux-x86_64/3.0/python/lib/python3.9/site-packages -->
	<!-- - Installer pySerial : $ ./pip install pyserial -t ~/UPBGE-0.30-linux-x86_64/3.0/python/lib/python3.9/site-packages -->
	<!-- - Installer pyFirmata : $ ./pip install pyfirmata -t ~/UPBGE-0.30-linux-x86_64/3.0/python/lib/python3.9/site-packages -->
    <!-- - Installer Matplotlib : $ ./pip install matplotlib -t ~/UPBGE-0.30-linux-x86_64/3.0/python/lib/python3.9/site-packages -->
    <!-- - Installer PyQt5 : $ ./pip install PyQt5 -t ~/UPBGE-0.30-linux-x86_64/3.0/python/lib/python3.9/site-packages -->
	
- **Windows** : La configuration ici présente est UPBGE installé sur le bureau utilisateur (prenom.nom) :
	- Ouvrir un terminal Powershell (éventuellement en passant par Anaconda Navigator)
	- Aller dans le répertoire local de Python de UPBGE: cd C:\Users\prenom.nom\Desktop\UPBGE-0.30-windows-x86_64\3.0\python\bin
	- Télécharger le script ['get-pip.py'](https://bootstrap.pypa.io/get-pip.py) pour installer le gestionnaire de paquet [**Pip**](https://pip.pypa.io)
	- Installer le gestionnaire de paquet Pip : python.exe get-pip.py
	- Aller dans le répertoire 'Scripts' : cd C:\Users\prenom.nom\Desktop\UPBGE-0.30-windows-x86_64\3.0\python\Scripts
	- Installer Pylint : pip.exe install pylint
	- Installer pySerial : pip.exe install pyserial
	- Installer pyFirmata : pip.exe install pyfirmata
    - Installer Matplotlib : pip.exe install matplotlib
    - Installer wxPython : pip.exe install wxpython

<!-- - **Windows** : La configuration ici présente est UPBGE installé sur le bureau utilisateur (prenom.nom) avec la distribution Anaconda installée : -->
<!-- 	- Avec Anaconda Navigator ouvrir un terminal Powershell -->
<!-- 	- Installer Pylint : pip install pylint -t C:\Users\prenom.nom\Desktop\UPBGE-0.30-windows-x86_64\3.0\python\lib\site-packages -->
<!-- 	- Installer pySerial : pip install pyserial -t C:\Users\prenom.nom\Desktop\UPBGE-0.30-windows-x86_64\3.0\python\lib\site-packages -->
<!-- 	- Installer pyFirmata : pip install pyfirmata -t C:\Users\prenom.nom\Desktop\UPBGE-0.30-windows-x86_64\3.0\python\lib\site-packages -->
<!--     - Installer Matplotlib : pip install matplotlib -t C:\Users\prenom.nom\Desktop\UPBGE-0.30-windows-x86_64\3.0\python\lib\site-packages -->
<!--     - Installer wxPython : pip install wxpython -t C:\Users\prenom.nom\Desktop\UPBGE-0.30-windows-x86_64\3.0\python\lib\site-packages -->