Aller au contenu principal

Installation

Bienvenue sur la page d'installation du pipeline Astro-Spectro !
Vous avez deux options pour démarrer : via le cloud avec GitHub Codespaces (simple et rapide) ou manuellement sur votre machine locale.

Pour toute explication détaillée, consultez la Guide utilisateur.

Option 1 : Via GitHub Codespaces (Recommandé)​

C'est la méthode la plus simple. Elle ne requiert aucune installation sur votre ordinateur.

  1. Rendez-vous sur le dépôt GitHub du projet.
  2. Cliquez sur le bouton vert < > Code, puis allez dans l'onglet Codespaces.
  3. Cliquez sur Create codespace on main.

L'environnement se préparera automatiquement en quelques minutes, incluant l'installation des dépendances et le téléchargement d'un jeu de données de démarrage.

Option 2 : Installation Locale Manuelle​

Prérequis​

  • Python 3.9+
  • Git
  • (Optionnel) JupyterLab ou Jupyter Notebook pour exécuter les notebooks interactifs

Étape 1 : Cloner le dépôt​

Ouvrez votre terminal et lancez :

git clone https://github.com/PhD-Brown/AstroSpectro.git
cd AstroSpectro

Étape 2 : Créer et activer un environnement virtuel Python​

python -m venv venv
source venv/bin/activate    # Sur Windows : .\venv\Scripts\activate

Étape 3 : Installer les dépendances​

pip install -r requirements.txt

Les dépendances principales incluent :
astropy, specutils, numpy, scikit-learn, xgboost, matplotlib, imbalanced-learn, pandas, seaborn, tqdm, joblib, requests, jupyterlab, notebook, ipywidgets
Pour des fonctionnalités avancées : dé-commentez dans requirements.txt les lignes pour lightgbm, pywavelets, etc.

Étape 4 : Lancer Jupyter (optionnel mais recommandé)​

Pour démarrer l'interface interactive :

jupyter lab
# ou
jupyter notebook

Étape 5 : Premier lancement du pipeline​

Le notebook principal est :
notebooks/00_master_pipeline.ipynb

Pour télécharger vos premiers spectres :
Ouvrez notebooks/01_download_spectra.ipynb et exécutez les cellules pour récupérer un lot d’exemple depuis LAMOST DR5.

💡 En cas de problème
  • Consultez la section FAQ dans la documentation.
  • Ouvrez une issue GitHub pour obtenir de l’aide.

Félicitations, vous êtes prêt à explorer AstroSpectro !