Documentation détaillée

Guides d'utilisation de SPARC

Ce document regroupe les guides d'utilisation détaillés pour les fonctionnalités principales de SPARC.

1. Interface Web (Frontend)

L'interface web permet d'interagir facilement avec le moteur de simulation SPARC depuis un navigateur.

Comment démarrer une simulation

  1. Rendez-vous sur la page d'accueil de l'interface web (par défaut http://localhost:5000).
  2. Sélectionnez le type de simulation désiré dans le menu déroulant (Homojonction, Hétérojonction, Tandem, etc.).
  3. Remplissez les paramètres physiques requis pour chaque couche de matériau (Épaisseur, Dopage, Mobilité, etc.).
  4. Cliquez sur Lancer la simulation.
  5. Les résultats (courbe J-V, diagramme de bandes, efficacité quantique) s'afficheront en temps réel grâce au streaming WebSocket.

Gestion des configurations

  • Sauvegarde : Vous pouvez télécharger la configuration actuelle au format JSON.
  • Chargement : Vous pouvez uploader un fichier JSON existant pour restaurer une configuration de simulation.

2. Interface en Ligne de Commande Interactive (CLI)

Le CLI interactif (cli_interactif/main.py) est conçu pour les utilisateurs avancés souhaitant un flux de travail rapide sans quitter le terminal.

Lancement

Exécutez la commande suivante depuis la racine du projet :

python -m cli_interactif

Raccourcis Principaux

  • d : Tableau de bord pour voir un résumé global des simulations passées.
  • n : Nouvelle simulation pour configurer une simulation pas-à-pas à l'aide de questionnaires interactifs.
  • r : Résultats pour afficher les courbes J-V en format ASCII directement dans le terminal.
  • c : Comparaison pour comparer côte à côte les métriques clés de plusieurs simulations.
  • o : Optimiseur IA pour lancer des optimisations bayésiennes des paramètres de cellule.

3. Moteur de Simulation Batch

Pour les études paramétriques à grande échelle, SPARC propose un mode Batch (batch_simulations.py).

Utilisation

Créez un fichier de configuration listant les variations de paramètres, puis exécutez :

python batch_simulations.py --config config_sweep.json --output results_folder

Avantages

  • Exécution parallèle optimisée.
  • Sauvegarde automatique des résultats sous forme de fichiers CSV et de graphiques comparatifs.

4. API REST

L'API REST permet d'intégrer le moteur SPARC à des outils externes (ex: scripts Python, Jupyter Notebooks).

  • URL de base : /api
  • Documentation Interactive : Rendez-vous sur /api/docs/ (générée par Swagger/Flasgger) pour tester les endpoints interactifs.
  • Endpoint Principal : POST /api/simulate
    • Accepte un JSON avec la structure de la simulation.
    • Retourne les métriques calculées (Voc, Jsc, FF, Efficacité).

Pour plus de détails, consultez les exemples de requêtes interactives sur la page Swagger.