TONGUE_KEVIN_JN_python/README.md

# Jumeaux Numériques - Application Interactive

Application Streamlit pour l'enseignement des jumeaux numériques, filtres de Kalman et contrôle optimal.

## Fonctionnalités

- **Introduction** : Concepts de base des jumeaux numériques
- **Filtre de Kalman** : Implémentation interactive pour systèmes 1D et multi-DDL
- **Contrôle PID** : Simulateur de contrôle pour différents types de systèmes
- **TP Robot Souple** : Pilotage d'un robot flexible avec estimation d'état
- **Exercices** : Exercices structurés basés sur le polycopié
- **Simulateur intégré** : Jumeau numérique complet avec assimilation de données

## Installation

```bash
pip install -r requirements.txt
```

## Déploiement

### Local
```bash
streamlit run app.py
```

### Streamlit Cloud
1. Créer un dépôt GitHub avec les fichiers
2. Se connecter à [share.streamlit.io](https://share.streamlit.io)
3. Sélectionner le dépôt et le fichier `app.py`
4. Déployer

## Architecture

```
jumeaux_numeriques_app/
├── app.py                      # Application principale
├── src/
│   ├── introduction/           # Module introduction
│   ├── kalman/                 # Module Kalman
│   ├── pid/                    # Module PID
│   ├── robot/                  # Module robot souple
│   ├── exercises/              # Module exercices
│   └── simulator/              # Module simulateur
├── assets/                     # Images et ressources
├── requirements.txt            # Dépendances
└── README.md                   # Documentation
```

## Utilisation

L'application est organisée en sections navigables via la barre latérale. Chaque section contient :
- Partie théorique avec explications
- Partie pratique avec simulations interactives
- Améliorations proposées par rapport aux rapports étudiants

## Améliorations implémentées

- Validation statistique des filtres
- Contrôle adaptatif
- Réduction de modèle
- Optimisations numériques
- Interface pédagogique améliorée