jumeaux-numeriques/README.md

# Digital Twin

Un jumeau numérique d'un système technique permet de simuler sa programmation en Python par la visualisation de son comportement sur une maquette numérique.

Systèmes :
* Monte-charge
* Portail coulissant
* Volet roulant

![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.

## Documents pédagogiques

Les applications pédagogique se trouvent dans le [dépôt des documents pédagogiques du projet Blender-EduTech](https://gitlab.com/blender-edutech/blender-edutech-oer-french) .

## 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 bibliothèques suivantes ne sont pas incluses par défaut dans l'environnement UPBGE : 
- **pylint** : vérificateur du code Python
- **pyserial** : communication sur le port série
- **pyFirmata** : protocole Firmata (protocole générique de communication entre logiciel et microcontrôleur)

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
	- Installer le gestionnaire de paquet pip : $ ./python3.9 -m ensurepip --default-pip
	- Installer pylint : $ ./pip install pylint -t ~/UPBGE-0.30-linux-x86_64/3.0/python/lib/python3.9/site-packages
	- Installer serial : $ ./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

- **Windows** : La configuration ici présente est UPBGE installé sur le bureau utilisateur (philippe.roy) avec la distribution Anaconda installée :
	- Avec Anaconda Navigator ouvrir un terminal Powershell
	- Installer pylint : pip install pylint -t C:\Users\philippe.roy\Desktop\UPBGE-0.30-windows-x86_64\3.0\python\lib\site-packages
	- Installer serial : pip install pyserial -t C:\Users\philippe.roy\Desktop\UPBGE-0.30-windows-x86_64\3.0\python\lib\site-packages
	- Installer serial : pip install pyfirmata -t C:\Users\philippe.roy\Desktop\UPBGE-0.30-windows-x86_64\3.0\python\lib\site-packages