================================================================================
    GUIDE D INSTALLATION - VISUALISEUR DE SPECTRES HIP 25281
================================================================================

Ce guide explique comment installer et utiliser le Visualiseur de Spectres
pour l analyse de binaires spectroscopiques sur un nouveau PC Windows.

================================================================================
PREREQUIS
================================================================================

1. PYTHON 3.9 ou superieur (recommande: Python 3.10 ou plus recent)
   - Telecharger depuis: https://www.python.org/downloads/
   - IMPORTANT: Lors de l installation, cocher Add Python to PATH

2. SYSTEME D EXPLOITATION
   - Windows 10 ou Windows 11
   - 4 GB de RAM minimum (8 GB recommande)

================================================================================
ETAPE 1: INSTALLER PYTHON
================================================================================

1. Telecharger Python depuis https://www.python.org/downloads/
2. Executer l installateur
3. COCHER Add Python to PATH (tres important!)
4. Cliquer sur Install Now
5. Attendre la fin de l installation

Pour verifier l installation:
- Ouvrir l invite de commandes (cmd)
- Taper: python --version
- Vous devriez voir: Python 3.x.x

================================================================================
ETAPE 2: COPIER LES FICHIERS DU PROGRAMME
================================================================================

1. Copier le dossier SpectralAnalyzer complet vers le nouvel ordinateur
   - Emplacement recommande: D:\SpectralAnalyzer
   - Vous pouvez aussi le mettre sur C:\ ou ailleurs

2. Structure du dossier:
   SpectralAnalyzer/
   ├── viewer_spectres_3d.py          (Programme principal)
   ├── requirements.txt                (Liste des dependances)
   ├── Lancer_Visualiseur_Spectres.bat (Raccourci de lancement)
   ├── create_desktop_shortcut.ps1    (Script pour creer le raccourci)
   ├── PROFIL_FIXE_COMP1.txt          (Profil fixe pour la methode 1)
   └── data/
       └── examples/                   (Vos fichiers FITS)

================================================================================
ETAPE 3: INSTALLER LES DEPENDANCES PYTHON
================================================================================

1. Ouvrir l invite de commandes (cmd) en tant qu administrateur:
   - Appuyer sur Windows + X
   - Choisir Invite de commandes (admin) ou Windows PowerShell (admin)

2. Naviguer vers le dossier SpectralAnalyzer:
   cd D:\SpectralAnalyzer
   (adapter le chemin selon votre installation)

3. Installer les dependances:
   python -m pip install -r requirements.txt

   Cela installera automatiquement:
   - numpy      (calculs numeriques)
   - scipy      (ajustements et optimisation)
   - matplotlib (graphiques)
   - astropy    (lecture des fichiers FITS)
   - pandas     (manipulation de donnees)

4. Attendre la fin de l installation (peut prendre 5-10 minutes)

================================================================================
ETAPE 4: CREER LE RACCOURCI SUR LE BUREAU
================================================================================

Methode 1 (automatique):
1. Dans l invite de commandes, taper:
   powershell -ExecutionPolicy Bypass -File create_desktop_shortcut.ps1
2. Un raccourci sera cree sur votre bureau

Methode 2 (manuelle):
1. Double-cliquer sur Lancer_Visualiseur_Spectres.bat
2. Clic droit sur le fichier .bat
3. Choisir Creer un raccourci
4. Deplacer le raccourci sur le bureau

================================================================================
ETAPE 5: LANCER LE PROGRAMME
================================================================================

1. Double-cliquer sur le raccourci sur le bureau
   OU
   Double-cliquer sur Lancer_Visualiseur_Spectres.bat

2. Le Visualiseur de Spectres s ouvre

================================================================================
UTILISATION DU PROGRAMME
================================================================================

ONGLET CHARGEMENT:

1. Choisir la methode d ajustement:
   - Profil fixe + profil variable: 
     La composante 1 (la plus profonde) a un profil identique pour tous 
     les spectres. Plus physique pour l etoile primaire.
   
   - Deux profils variables:
     Les deux composantes ont des profils qui peuvent varier d un spectre 
     a l autre. Plus flexible mais moins de contraintes physiques.

2. Charger les spectres:
   - Cliquer sur Selectionner un repertoire pour charger tous les .fits
     d un dossier
   OU
   - Cliquer sur Selectionner des fichiers FITS pour choisir des fichiers
     specifiques

3. Lancer l analyse:
   - Cliquer sur AJUSTER TOUS LES SPECTRES
   - Une barre de progression s affiche
   - Attendre la fin du traitement

ONGLET VISUALISATION:

- Navigation avec les boutons PRECEDENT et SUIVANT
- Le graphe montre:
  * Spectre observe (noir)
  * Ajustement global (rouge)
  * Composante 1 - raie la plus profonde (bleu pointille)
  * Composante 2 - raie la moins profonde (vert pointille)
  * Residus (en bas)

- Les vitesses radiales V1 et V2 sont affichees dans la legende

================================================================================
RESULTATS GENERES
================================================================================

Le programme cree automatiquement deux fichiers de sortie:

- V1.txt : Vitesses radiales de la composante 1 (la plus profonde)
- V2.txt : Vitesses radiales de la composante 2 (la moins profonde)

Format des fichiers:
  Colonne 1: JD-HEL (Date julienne heliocentrique)
  Colonne 2: Vitesse radiale (km/s)

Ces fichiers peuvent etre importes dans Excel, Origin, ou tout autre logiciel
d analyse pour tracer les courbes de vitesse radiale.

================================================================================
DEPANNAGE
================================================================================

PROBLEME: Python n est pas reconnu en tant que commande...
SOLUTION: Python n est pas dans le PATH. Reinstaller Python en cochant
          Add Python to PATH

PROBLEME: ModuleNotFoundError: No module named numpy (ou autre module)
SOLUTION: Installer les dependances avec:
          python -m pip install -r requirements.txt

PROBLEME: Le programme se ferme immediatement
SOLUTION: Ouvrir une invite de commandes dans le dossier SpectralAnalyzer,
          puis taper: python viewer_spectres_3d.py
          Vous verrez les messages d erreur eventuels

PROBLEME: Permission denied ou erreur d acces
SOLUTION: Executer l invite de commandes en tant qu administrateur

PROBLEME: Les graphiques ne s affichent pas
SOLUTION: Verifier que matplotlib est bien installe:
          python -m pip install matplotlib --upgrade

================================================================================
CONFIGURATION SYSTEME RECOMMANDEE
================================================================================

MINIMUM:
- Processeur: Dual-core 2.0 GHz
- RAM: 4 GB
- Espace disque: 2 GB (pour Python + dependances + donnees)
- Ecran: 1366x768

RECOMMANDE:
- Processeur: Quad-core 2.5 GHz ou superieur
- RAM: 8 GB ou plus
- Espace disque: 5 GB
- Ecran: 1920x1080 ou superieur

================================================================================
VERSIONS TESTEES
================================================================================

Le programme a ete developpe et teste avec:
- Python 3.14.0
- numpy 2.3.4
- scipy 1.16.2
- matplotlib 3.10.7
- astropy 7.1.1

Mais fonctionne avec des versions plus anciennes (voir requirements.txt)

================================================================================
