AUTOSTACK 1.0.0 — GUIDE D'UTILISATION
====================================

IMPORTANT : extrayez TOUT le contenu du .zip dans un dossier avant de
lancer AutoStack (voir LIRE_EN_PREMIER.txt). Le lancer depuis l'archive
provoque l'erreur « Failed to load Python DLL ».

AutoStack empile automatiquement vos poses FITS en pilotant Siril.
Vous n'avez rien à installer d'autre que Siril : ni Python, ni
bibliothèque.


AU PREMIER LANCEMENT
--------------------

L'application n'est pas signée numériquement. Windows affichera donc :

    « Windows a protégé votre ordinateur »

Cliquez sur « Informations complémentaires », puis sur « Exécuter quand
même ». C'est normal et sans danger.

Votre antivirus peut également signaler le fichier. C'est un faux
positif courant pour ce type d'application. Vous pouvez vérifier que le
fichier est bien celui que nous avons publié en comparant son empreinte
avec celle du fichier SHA256.txt fourni :

    Get-FileHash -Algorithm SHA256 .\AutoStack_v1.0.0.exe


PRÉ-REQUIS
----------

- Windows 10 ou 11
- Siril 1.4.4 ou plus récent, installé
- Les FITS individuels réunis dans un dossier (une ou plusieurs nuits de la
  même cible, avec les mêmes réglages : pose, gain, filtre)


CE QU'AUTOSTACK FAIT SUR INTERNET
---------------------------------

- Gaia en ligne (case cochée par défaut) : Siril interroge un catalogue
  d'étoiles (VizieR, CDS Strasbourg) pour recaler les poses et calibrer
  les couleurs. Si ce serveur ne répond pas, AutoStack réessaie deux fois,
  puis produit tout de même l'image, sans calibration des couleurs. Il le
  dit clairement dans la fenêtre de fin et dans le rapport : l'image est
  alors moins colorée, ce qui n'est pas un défaut de votre installation.
  Relancez plus tard pour obtenir la calibration.
- Catalogue Gaia local (facultatif, environ 1 Go) : si Siril l'a installé
  sur votre ordinateur (outil Siril_Catalog_Installer, fourni avec Siril),
  AutoStack l'utilise en premier. Il fonctionne sans Internet et évite les
  pannes du serveur en ligne. S'il n'est pas installé, AutoStack passe
  automatiquement par le serveur en ligne. Le rapport indique laquelle des
  deux sources a été utilisée.
- Une fois par jour, AutoStack consulte nightastro.fr pour savoir si une
  nouvelle version existe. Rien de vos images ni de vos dossiers n'est
  envoyé. Sans connexion, rien ne se passe et aucun message n'apparaît.


UTILISATION
-----------

1. Extrayez le dossier reçu (voir plus haut), puis lancez l'exécutable
   qui se trouve dedans.
2. « Choisir un dossier… » : désignez le dossier contenant vos FITS.
3. « Dossier de sortie » : laissez le réglage par défaut, ou choisissez
   un autre emplacement.

   Important : le traitement écrit jusqu'à 16 fois le volume de vos
   FITS. Si vos images sont sur une carte SD ou un disque presque
   plein, choisissez un autre disque ici.

4. « Lancer le traitement ».
5. Suivez la barre de progression, étape par étape.

À la fin :

- le chemin exact des résultats est affiché dans la fenêtre ;
- si un avertissement s'applique (par exemple couleurs non calibrées), il
  apparaît dans un encadré jaune, et dans le rapport ;
- « Ouvrir les résultats » ouvre directement le bon dossier ;
- « Calibrer les couleurs » n'est cliquable que si la calibration des couleurs a échoué (serveur de catalogue) : il la refait après coup ;
- « Envoyer mon retour » ouvre le formulaire de retour dans votre
  navigateur.


FICHIERS PRODUITS
-----------------

Dans le dossier de résultats :

- *_MASTER_LINEAR.fit    le master, resté linéaire, avec le WCS final
                         si l'astrométrie a réussi
- *_COLOR_LINEAR.fit     version calibrée en couleur (PCC)
- *_LIGHTROOM_16bits.tif destiné à votre traitement
- *_PREVIEW.png          pour la prévisualisation et le partage
- rapport.txt            résumé, avec les heures de prise de vue de chaque nuit
- rapport_detaille.txt   détail complet, avec les journaux Siril


SÉCURITÉ DE VOS IMAGES
----------------------

AutoStack ne travaille jamais sur vos fichiers d'origine : il en fait
des copies. L'empreinte SHA-256 de chaque original est calculée avant
le traitement, vérifiée avant la publication des résultats, puis
vérifiée une seconde fois après. Si le moindre original avait changé,
le traitement s'arrêterait en vous le signalant.


LIMITES DE CETTE VERSION
------------------------

- plusieurs nuits possibles pour une même cible, à condition que pose, gain
  et filtre soient identiques ;
- instruments : Seestar S30 Pro, S50 Pro et S50 ; Seestar S30 et DWARF II
  en profil EXPERIMENTAL (écrit d'après un seul jeu de poses, à vérifier) ;
- ciel profond ;
- pas de darks, de flats ni d'offsets ;


EN CAS DE PROBLÈME
------------------

Cliquez sur « Envoyer mon retour ». Le bouton reste accessible même
quand le traitement a échoué — c'est justement dans ce cas que votre
signalement nous est le plus utile.

Joignez si possible :

- rapport_detaille.txt, ou rapport_detaille_echec.txt si le traitement
  s'est arrêté ;
- l'image *_PREVIEW.png si elle a été produite ;
- une courte description de ce qui vous a semblé anormal.

Si le traitement s'est arrêté avant de produire le moindre fichier,
copiez simplement le contenu du journal affiché en bas de la fenêtre.

Formulaire de retour :
https://nightastro.fr/autostack-retour/


ET SI LE RENDU NE VOUS PLAÎT PAS
--------------------------------

AutoStack produit un rendu unique, celui qui sert à voir tout de suite
si la nuit a donné quelque chose. Depuis la 0.9.40 il applique une
saturation légère (+35 %) qui touche surtout la cible et épargne le fond
de ciel. Ce rendu n'est pas réglable : ce n'est pas le métier d'AutoStack.

Pour travailler l'image, ouvrez le fichier *_MASTER_LINEAR.fit dans
Siril. Il est resté linéaire, il contient le WCS si l'astrométrie a
réussi, et vous disposez de tous les outils de Siril pour l'étirement,
la couleur et le bruit. Le TIFF 16 bits convient aussi très bien à
Lightroom ou Photoshop.

Autrement dit : AutoStack empile, Siril traite.

