QS-01 · Onboarding

Démarrage rapide — 5 minutes

Cinq étapes pour passer du site vierge à la première image livrée. Aucun compte requis pour les fonctionnalités publiques : catalogue, fenêtres d'observation, exports iCal et NINA. Le pilotage hardware (étape 5) suppose la présence d'un agent installé.

Étape 1 — Découvrir l'interface

La page d'accueil est le Mission Control : statut du ciel maintenant (coucher de Soleil, début/fin de nuit astronomique, illumination lunaire), compteur de cibles au-dessus de l'horizon, échelle d'imagerie et champ de vue calculés depuis le C11 + Atik 460EX.

La barre de navigation supérieure donne accès aux 9 vues principales :

Page	Usage
Mission	Dashboard global — statut du ciel et du système
Now	Instant T — quelles cibles sont en transit, ciel temps réel
Sky	Projection polaire du ciel visible
Catalogue	349 cibles M/C/NGC/IC/Sh2 — filtres, tri, fiches détaillées
Ce soir	Cibles imageables cette nuit, score composite
Mois	Calendrier mensuel — nuits propices, phases lunaires
Saison	Vue trimestrielle — campagnes pluri-mois
Campagnes	10 campagnes pré-curatées (Andromède 27h, Orion 19h…)
Scope	Champ de vision et échelle d'imagerie

Étape 2 — Choisir une cible

Trois manières de chercher :

Recherche directe — la barre M31, Orion… en haut de page accepte tout : nom (Andromède), identifiant (M31, NGC 224, C 1733-2), constellation (Cygnus). Renvoie la fiche cible.
Navigation par catalogue — /catalog liste les 349 cibles avec filtres : catalogue (Messier, Caldwell, NGC, IC, Sharpless), type (galaxie, nébuleuse planétaire, amas globulaire, HII, supernova remnant), magnitude, taille, déclinaison. Chaque ligne renvoie à /target/[id].
Cible-du-soir — /tonight ne montre que les cibles imageables cette nuit avec un score composite (altitude max, fenêtre d'observabilité, séparation lunaire, transit méridien). Trié par score.

Exemple — recherchons M31 (galaxie d'Andromède) :

https://nova-obsrouen.pages.dev/target/M31

Étape 3 — Vérifier la fenêtre d'observation

La fiche cible calcule la fenêtre d'observation pour la nuit en cours :

Heure de lever et coucher local — à Rouen, latitude 49,44649° N.
Altitude max et heure du transit méridien — instant où la cible est au plus haut.
Fenêtre utile — intersection de (cible > 30°) ∩ (nuit astronomique) ∩ (séparation lunaire > 30°).
Score composite 0-100 — combine altitude max, durée fenêtre, séparation lunaire, conditions météo (Open-Meteo).
Aperçu spaced × pixel scale — le FOV C11 (15,3' × 12,3') superposé sur l'objet réel.

Code couleur du score :

80-100 — IDÉAL 50-79 — POSSIBLE 0-49 — DÉCONSEILLÉ

Étape 4 — Exporter la planification

Trois formats d'export sont disponibles depuis la fiche cible :

iCal (.ics)

/api/target/M31.ics

Calendrier importable dans Apple Calendar, Google Calendar, Thunderbird. Un évènement = la fenêtre d'observation du soir avec coordonnées en notes.

NINA Target Scheduler

/api/nina.json

JSON au format Target Scheduler N.I.N.A. — importable dans le module Sequence, avec coordonnées J2000, magnitude, taille, contraintes altitude/séparation.

Campagne iCal multi-nuits

/api/campaigns/m31-deep.ics

Calendrier 30+ jours — toutes les nuits avec un score > 70 sur la cible, y compris répartition LRGB et narrowband selon la phase lunaire.

Étape 5 — Lancer une session (préview)

⚠ Disponible uniquement si l'agent est installé

Cette étape suppose que nova-agent tourne sur le mini-PC du télescope cible (voir /docs/agent) et que le mode pilotage est explicitement activé. Sans agent, vous pouvez planifier mais pas exécuter.

Si tout est en place, lancer une session se fait depuis /control ou via POST direct sur l'API :

POST /api/control/command
Authorization: Bearer nva_xxxxxx
Content-Type: application/json

{
  "cmd": "session",
  "target": "M31",
  "filter_plan": [
    { "filter": "L", "subs": 30, "exposure_s": 180 },
    { "filter": "R", "subs": 15, "exposure_s": 180 },
    { "filter": "G", "subs": 15, "exposure_s": 180 },
    { "filter": "B", "subs": 15, "exposure_s": 180 }
  ],
  "max_duration_min": 240,
  "abort_on_clouds": true
}

L'agent récupère la commande au prochain heartbeat (toutes les 30 s), valide les contraintes hard-codées (altitude > 5°, exposure < 1800 s, token valide, mode enabled = true), puis pilote la monture, la caméra et le focuser via la stack ASCOM.

Étape 6 — Récupérer le résultat

À la fin de la session, l'agent poste les résultats sur /api/control/result. Le dashboard /control affiche :

La liste des subs capturés avec leur HFR (focus quality) et leur RMS de guidage.
Le master frame empilé (Siril WBPP) — téléchargeable en FITS calibré.
Un rendu PNG presse-prête (stretch ASINH, white balance LRGB).
Le log complet de session : météo Open-Meteo, transits Lune/Soleil, slews, plate solving, alertes.

Les livrables sont stockés en Cloudflare R2 (à venir v0.5) avec rétention 90 jours par défaut. L'utilisateur peut télécharger ou exporter vers son propre stockage.

Récapitulatif visuel

[1] DÉCOUVRIR  → naviguer le site, lire Mission Control
       ↓
[2] CHOISIR    → catalogue / recherche / tonight
       ↓
[3] VÉRIFIER   → fiche cible, score composite, fenêtre utile
       ↓
[4] EXPORTER   → iCal · NINA Target Scheduler · campagne multi-nuits
       ↓
[5] LANCER     → /control · POST /api/control/command  (agent requis)
       ↓
[6] RÉCUPÉRER  → FITS calibrés · master frame · log session

Cinq erreurs fréquentes du débutant

🚫 Oublier la séparation lunaire

À pleine Lune, une cible large bande (M31, M51) est noyée — préférez les nuits avant le premier quartier ou après le dernier quartier. Le score composite pénalise déjà les nuits illuminées, mais pour le narrowband (Hα, OIII), la Lune est moins critique.

🚫 Sous-estimer le temps de pose nécessaire

M31 « belle » demande typiquement 5 à 8 h de pose totale en LRGB. Une session d'une heure ne suffit pas, sauf pour le test ou la magnitude limite. Planifiez sur plusieurs nuits via les campagnes.

🚫 Imager au mauvais moment de l'année

M42 (nébuleuse d'Orion) est invisible en juin depuis Rouen. La page Saison montre les fenêtres annuelles. Le calendrier /month affiche les meilleures dates de l'année en cours.

🚫 Croire que l'agent va « tout faire »

Sans alignement polaire correct et sans focus initial, aucune automation ne sauve la nuit. Le check-list pré-session reste manuel — voir /docs/workflow.

Suite logique

← PRÉCÉDENT