========================================================
README - Mesure de permittivité relative par condensateur
========================================================

Ce projet contient 3 programmes :
  - mesure_capacite.ino         : programme Arduino pour l'acquisition des mesures
  - enregistrement_capacite.ipynb : programme Python pour l'enregistrement des données
  - calcul_permittivite.ipynb   : programme Python pour le calcul de la permittivité

--------------------------------------------------------
LOGICIELS NÉCESSAIRES
--------------------------------------------------------

- Arduino IDE (https://www.arduino.cc/en/software)
- Python 3 avec Jupyter Notebook (recommandé : Anaconda, https://www.anaconda.com)
- Bibliothèques Python requises :
    * pyserial   -> pip install pyserial
    * pandas     -> pip install pandas
    * matplotlib -> pip install matplotlib
    (tkinter est inclus par défaut avec Python)

--------------------------------------------------------
MATÉRIEL NÉCESSAIRE
--------------------------------------------------------

- Une carte Arduino Uno
- Un écran LCD 16x2 (connecté aux pins 4, 5, 6, 7, 8, 9)
- Un condensateur de référence de 25 pF connecté entre les pins A0 et A2
- Le condensateur à mesurer connecté en parallèle du condensateur de référence
- Un câble USB pour relier l'Arduino à l'ordinateur

--------------------------------------------------------
ÉTAPE 1 : Téléverser le programme Arduino
--------------------------------------------------------

1. Ouvrir mesure_capacite.ino dans l'Arduino IDE
2. Connecter la carte Arduino à l'ordinateur via USB
3. Vérifier le port série utilisé dans l'Arduino IDE (Outils > Port)
   ATTENTION : le port n'est pas forcément COM5. Il peut varier selon
   l'ordinateur (ex: COM3, COM7 sur Windows). Sur Mac/Linux il aura
   une forme différente (ex: /dev/ttyUSB0 ou /dev/cu.usbmodem...).
   Notez bien le port affiché, vous en aurez besoin à l'étape 2.
4. Téléverser le programme sur la carte (bouton "Téléverser")
5. L'Arduino commence immédiatement à envoyer des mesures.

--------------------------------------------------------
ÉTAPE 2 : Enregistrer les mesures (enregistrement_capacite.ipynb)
--------------------------------------------------------

1. Ouvrir enregistrement_capacite.ipynb dans Jupyter Notebook
2. Dans la cellule 3, vérifier que le port est correct :
      PORT = "COM5"
   Remplacer "COM5" par le port identifié à l'étape 1 si nécessaire.
3. Exécuter toutes les cellules dans l'ordre (Cellule > Exécuter tout)
4. Un explorateur de fichiers s'ouvre : choisir le dossier où enregistrer les mesures
5. Le programme enregistre automatiquement 100 mesures dans un fichier
   texte au nom horodaté (ex: mesures_2026-05-17_10-30-00.txt), puis s'arrête.

IMPORTANT : Pour chaque nouvelle série de mesures, il faut re-téléverser
le programme Arduino afin de réinitialiser le port série, puis relancer
enregistrement_capacite.ipynb depuis le début.

Effectuer une mesure avec le matériau ET une mesure avec uniquement l'air
pour la même épaisseur. Pour l'incertitude de répétabilité, effectuer
plusieurs mesures de chaque type.

--------------------------------------------------------
ÉTAPE 3 : Calculer la permittivité (calcul_permittivite.ipynb)
--------------------------------------------------------

1. Ouvrir calcul_permittivite.ipynb dans Jupyter Notebook
2. Exécuter toutes les cellules dans l'ordre
3. Le programme demande successivement de choisir :
      - Le fichier de mesure avec le matériau
      - Le fichier de mesure avec l'air
      - Plusieurs fichiers pour le calcul de l'incertitude de répétabilité
        (matériau puis air), en répondant "oui" ou "non" aux invites
4. Le résultat final affiché est de la forme :
      Permittivité relative du matériau étudié : X.XXXX ± X.XXXX

--------------------------------------------------------
REMARQUES
--------------------------------------------------------

- Le port COM5 est celui utilisé lors du développement de ce projet.
  Il est possible qu'il soit différent sur un autre ordinateur.
  Toujours vérifier dans l'Arduino IDE avant de lancer l'enregistrement.

- Ces programmes ont été développés et testés sous Windows uniquement.
  Un fonctionnement sous Mac ou Linux n'est pas garanti, notamment
  concernant l'interface graphique tkinter et le nom du port série.

- L'incertitude calculée ne prend pas en compte l'incertitude sur la
  valeur de la capacité de référence (25 pF), qui est une valeur donné 
  par le fabricant. Elle constitue la principale limite
  de ce montage.
