AstroTools : manuel utilisateur
Version du manuel : 0.8.0, 6.11.2026, pour AstroTools 0.8.0 (incréments 1, 2-1, 2-2, mini corrections, 3.1, 3.2, 3.3, 4.1 et 4.2 avec les corrections de leurs recettes).
Langue : français. La traduction anglaise se fera en un seul bloc à la fin de la V1.
Ce manuel explique comment se servir d'AstroTools. Il ne répète pas les spécifications (docs/increments/) : il dit quoi faire, où cliquer et ce qu'on doit voir. Un chapitre s'ajoute ou se complète à la fin de chaque incrément validé.
Ce que fait AstroTools aujourd'hui
AstroTools accompagne une séance d'imagerie astro. Dans sa version 0.8.0, il sait :
- décrire ton matériel (tubes, réducteurs et Barlow, caméras, oculaires, filtres, montures) et l'assembler en configurations ;
- faire les calculs de base d'une configuration (focale, F/D, échantillonnage, champ, effet du seeing et du guidage, visuel) ;
- interroger deux logiciels du réseau, Pegasus Unity et NINA (plugin Advanced API), pour lister leurs appareils et leurs valeurs ;
- te laisser choisir et décrire les champs à enregistrer (nom, unité, valeurs valides, dépendances), et les retrouver vite grâce à la sélection des champs ;
- enregistrer ces champs toute la nuit à intervalle régulier, en traversant les coupures de source, et tracer la séance dans un graphique à quatre cadrans ;
- enregistrer chaque image prise par NINA (sans en perdre pendant une coupure) et tous ses événements, les suivre dans une console filtrable, et tracer les images dans un second graphique ;
- retrouver le FITS de chaque pose LIGHT sur le disque ou le réseau et en montrer la vignette, dans une grille, avec un clic pour l'ouvrir en grand ;
- construire tes propres graphiques à la souris (dispositions, courbes sur deux axes, une courbe par filtre), en fonction du temps ou d'un autre champ (nuages de points, par exemple le HFR en fonction de la température), et en suivre jusqu'à quatre en direct pendant la nuit ;
- montrer les réponses brutes des logiciels, et les rejouer avec un simulateur quand le matériel n'est pas branché.
AstroTools ne pilote rien : il ne fait que lire. Tu démarres toi-même Unity, NINA et ton matériel.
Pressé ? Le guide de démarrage rapide mène en deux pages de l'installation à une première nuit avec NINA.
Contact : astrotools@michelfabre.ch
Sommaire
| Chapitre | Pour… |
|---|---|
| Démarrage rapide | une première nuit avec NINA, en deux pages, avec une fiche pour noter tes remarques |
| 1. Installation et premier démarrage | installer AstroTools depuis le zip, le lancer, le mettre à jour, le désinstaller |
| 2. La fenêtre principale | vues, pages, menus, thèmes, langue, barre d'état |
| 3. Le matériel | saisir ton matériel et tes configurations |
| 4. Les calculs | lire les résultats d'une configuration |
| 5. Les sources : principes | ce qu'est une source, un appareil, un champ ; ce qu'il faut savoir avant de commencer |
| 6. Source Pegasus Unity | brancher Uranus, UPBv3… par Unity |
| 7. Source NINA | brancher NINA (caméra, guidage, images…) |
| 8. Les champs | choisir, nommer et régler les champs à enregistrer |
| 9. La sélection des champs | retrouver vite un champ parmi des centaines (ET / OU) |
| 10. Réponses brutes et simulateur | voir ce que répond un logiciel ; travailler sans matériel |
| 11. La console et le journal | suivre ce que fait AstroTools, retrouver une erreur |
| 12. Tes fichiers | ce qu'AstroTools écrit sur ton PC, config.ini, sauvegarde |
| 13. Dépannage | les messages courants et quoi faire |
| 14. L'acquisition et les graphiques | enregistrer une nuit, les images et les événements de NINA, suivre les sources, tracer la séance, voir les vignettes des poses, les fichiers produits |
| 15. Les graphiques configurables | construire tes graphiques (page Plots), les lancer pendant la nuit, les styles, où sont les fichiers |
Conventions
- Gras : un bouton, un menu ou un libellé tel qu'il apparaît à l'écran. Fichier > Ouvrir le dossier des données veut dire : menu Fichier, puis la ligne Ouvrir le dossier des données.
Police fixe: un nom de fichier, une valeur à taper ou un identifiant.%LocalAppData%\AstroTools\: le dossier de tes données (chapitre 12). Pour l'ouvrir : Fichier > Ouvrir le dossier des données.- Les captures d'écran sont en thème Jour, en français. Elles servent à se repérer : en cas d'écart, le texte fait foi (liste et règles : Captures.md).
Pour les relecteurs
Le manuel est écrit à partir des spécifications et des plans de tests validés. Si l'écran ne correspond pas au manuel, c'est l'écran qui fait foi : signale l'écart (chapitre et paragraphe, ce que tu vois, une capture).