Annotations

Les annotations sont des glyphes affichés au-dessus des images pour indiquer la présence d'objets célestes connus, comme les galaxies, les étoiles brillantes, etc. Elles proviennent de catalogues, mais ne peuvent être affichées que sur des images pour lesquelles nous savons dans quelle partie du ciel elles sont, des images qui ont été résolues par astrométrie et qui contiennent les informations du système de coordonnées mondiales (WCS) dans leur en-tête, donc uniquement des fichiers FITS ou Astro-TIFF.

Vue de l'image complète annotée

La résolution astrométrique peut être effectuée dans Siril dans l'entrée Outils ‣ Astrométrie ‣ Résolution astrométrique..., ou en utilisant des outils externes comme astrometry.net ou ASTAP.

Bouton pour annotations

Lorsqu'une image résolue astrométriquement est chargée dans Siril, vous pouvez voir les coordonnées dans le ciel pour le pixel sous le pointeur de la souris affiché dans le coin inférieur droit et les boutons relatifs aux annotations deviennent disponibles. Le premier bouton active les annotations des objets, le second la grille céleste et la boussole.

Catalogues d'annotations hors ligne

Siril vient avec une liste de catalogue prédéfini pour les annotations :

• Catalogue de Messier (M)

• New General Catalogue (NGC)

• Index Catalogue (IC)

• Lynds Catalogue of Dark Nebulae (LdN)

• Catalogue Sharpless (SHh2)

• Star Catalogue (3661 étoiles les plus brillantes)

En supplément, 2 catalogues utilisateurs peuvent être utilisés :

• Catalogue d'objets du ciel profond de l'utilisateur (DSO)

• Catalogue d'objets du système solaire pour l'utilisateur (SSO)

Elles sont alimentées par les commandes décrites dans la section recherche d'un objet connu.

Ils sont stockés dans le répertoire des paramètres de l'utilisateur. Leur emplacement dépend du système d'exploitation :

• Pour les OS Unix-based ils seront dans ~/.config/siril/catalogue

• sur Windows il sont dans %LOCALAPPDATA%\siril\catalogue.

Tous les catalogues ci-dessus peuvent être activés/désactivés dans le menu Preferences ‣ Astrometrie tab.

Les deux catalogues définis par l'utilisateur peuvent également être purgés (c'est-à-dire supprimés) à l'aide des boutons appropriés.

Un curseur sur le côté droit vous permet de naviguer facilement dans la liste de catalogues.

Gestion des catalogues dans Préférences/Astrométrie

Ces catalogues d'annotations sont utilisés principalement à des fins d'affichage. À partir de Siril 1.3, ils sont également utilisés pour localiser le centre de l'image pour l'outil d'astrométrie. Si l'objet est trouvé localement, le résolveur sera affiché comme Local. Si ce n'est pas le cas, un résolveur en ligne sera utilisé.

Objet résolu à partir des catalogues d'annotations locaux

Catalogues d'annotations en ligne

Vous pouvez interroger d'autres bases de données que celles déjà fournies avec Siril, décrites dans la section catalogues d'annotations hors ligne. Cela ne fonctionne, encore une fois, que pour les images résolues par astrométrie.

Starting from Siril 1.3, this is possible with the command conesearch. This new command replaces and expands capabilities previously provided by nomad and solsys from Siril 1.2.

Ligne de commande Siril

conesearch [limit_magnitude] [-cat=] [-phot] [-obscode=] [-tag={on|off}] [-log={on|off}] [-trix=] [-out=]

Affiche les étoiles du catalogue local par défaut pour l'image chargée résolue, jusqu'à la magnitude limite limite_magnitude fournie (13 par défaut pour la plupart des catalogues, sauf 14.5 pour aavso_chart, 20 pour solsys, et omis pour pgc).

Un autre catalogue en ligne peut être spécifié avec -cat=, prenant les valeurs

- for stars: tycho2, nomad, gaia, ppmxl, bsc, apass, gcvs, vsx, simbad, aavso_chart

- for exoplanets: exo

- for deep-sky: pgc

- for solar system objects: solsys (closest IAU observatory code can be passed with the argument -obscode= for better position accuracy)

Pour les catalogues d'étoiles contenant des données photométriques, les étoiles sans information B-V seront conservées ; elles peuvent être exclues en passant l'option -phot

L'argument -trix= peut être passé à la place d'un catalogue suivi d'un nombre entre 0 et 511 pour tracer les étoiles contenues dans les catalogues locaux trixel de niveau 3 (pour l'usage des développeurs principalement)

Certains catalogues (bsc, gcvs, pgc, exo, aavso_chart, varisum et solsys) affichent également, par défaut, les noms à côté des marqueurs dans l'écran (interface graphique uniquement) et les listent dans le journal. Pour d'autres qui ont un plus grand nombre d'objets, à savoir vsx et simbad, l'information peut aussi être affichée, mais, comme elle risque d'encombrer l'écran, elle n'est pas activée par défaut. Ce comportement peut être activé/désactivé avec les options -tag=on|off pour afficher les noms à côté des marqueurs et -log=on|off pour lister les objets dans le journal de la console

La liste des éléments présents dans l'image peut éventuellement être sauvegardée dans un fichier csv en passant l'argument -out=

This command is accessible from the graphical interface via the Tools ‣ Astrometry ‣ Annotate....

Graphical version of the conesearch command

Le tableau ci-dessous répertorie tous les catalogues disponibles, ainsi que les liens vers les données originales.

Tableau des catalogues disponibles

Catalogue	-cat=	Référence
Local	Omis	catalogues d'étoiles locaux
Tycho2	tycho2	https://cdsarc.cds.unistra.fr/viz-bin/cat/I/297
Nomad	nomad	https://cdsarc.cds.unistra.fr/viz-bin/cat/I/297
GAIA DR3	gaia	https://cdsarc.cds.unistra.fr/viz-bin/cat/I/355
PPMXL	ppmxl	https://cdsarc.cds.unistra.fr/viz-bin/cat/I/317
Catalogue Bright Stars	bsc	https://cdsarc.cds.unistra.fr/viz-bin/cat/V/50
APASS DR9	apass	https://cdsarc.cds.unistra.fr/viz-bin/cat/II/336
GCVS	gcvs	https://cdsarc.cds.unistra.fr/viz-bin/cat/B/gcvs
VSX	vsx	https://cdsarc.cds.unistra.fr/viz-bin/cat/B/vsx
SIMBAD	simbad	https://simbad.cds.unistra.fr/simbad/sim-tap/
PGC/HYPERLEDA	pgc	https://cdsarc.cds.unistra.fr/viz-bin/cat/VII/237
Archives des exoplanètes	exo	https://exoplanetarchive.ipac.caltech.edu
AAVSO VSP	aavso_chart	https://app.aavso.org/vsp/
skybot Système solaire IMCCE	solsys	https://vo.imcce.fr/webservices/skybot/?conesearch

Les requêtes suivantes vous sont fournies grâce à :

• Vizier (par l'intermédiaire du CDS Vizier TAP query service)

• Simbad (par l'intermédiaire du CDS Simbad TAP query service)

• IMCCE (par l'intermédiaire de son service skybot conesearch)

• Archives de la NASA sur les exoplanètes (via son service de recherche TAP)

For solar system object queries, you may pass an additional parameter -obscode=, the 3-symbol code for an IAU observatory close by to your observing location. This will improve annotations accuracy. Please note that results may still slightly differ from those obtained by making a direct ephemerides query for a specific object, which uses the exact observing location (if present in the FITS header).

Astuce

A preferred observatory code may be set in the Astrometry tab in the Preferences dialog. If set, this will be used for the Solar System Objects GUI tool and will also be used in the conesearch command unless the -obscode= argument is provided.

These additional annotations will be displayed in RED, to differentiate them from offline annotations, shown in GREEN. These annotations will be erased as soon as the Show Objects names button is toggled.

Catalogues supplémentaires

You may want to display your own user catalogues. This can be done with the command show. This command can also be used to display, for instance, csv files created with the feature to find comparison stars.

Ligne de commande Siril

show [-clear] [{ -list=file.csv | [name] RA Dec }] [-nolog] [-notag]

Affiche un point sur l'image chargée et résolue en utilisant le catalogue temporaire d'annotations de l'utilisateur, basé sur ses coordonnées équatoriales. L'option -clear efface d'abord ce catalogue et peut être utilisée seule.

Plusieurs points peuvent être transmis en utilisant un fichier CSV avec l'option -list= contenant au moins les colonnes ra et dec. Si le fichier transmis contient également un nom de colonne, les noms seront utilisés comme balises dans l'image et listés dans la console, à moins qu'ils ne soient désactivés avec les options -notag et -nolog.

Cette fonction n'est disponible qu'à partir de l'interface graphique de Siril

Ces catalogues peuvent être des fichiers csv (séparés par des virgules), respectant les règles suivantes :

• les lignes de commentaires, s'il y en a, doivent commencer par un signe #

• une ligne doit être présente en haut avec les noms des colonnes, séparés par des virgules

• au moins les colonnes ra et dec doivent être fournies, en degrés décimaux.

• les colonnes peuvent être rédigées sans ordre particulier

• d'autres colonnes peuvent être fournies (en anglais) :

  • name (str), pour le nom

  • diameter (double), le diamètre de l'objet en arcmin

  • mag (double), la magnitude de l'objet

  • type (str), qui sera ajouté entre () après le nom dans la Console

D'autres colonnes que celles énumérées ci-dessus peuvent être transmises, mais elles ne seront pas utilisées.

This command is accessible from the graphical interface via the Tools ‣ Astrometry ‣ Annotate.... You can either load a *.csv file containing several lines of comma-separated ra, dec coordinates in Import CSV, or a single point in the Single Coordinates tab.

Graphical version of the show command

In the case of a single point, you can save the result in the Deep Sky user catalogue by clicking on the save button as shown in the illustration bellow:

It is possible to show only one single point and to save it in the Deep Sky user catalogue.

Astuce

The save button will only work if the field Display Name is filled.

Astuce

You can select a star or object and obtain its coordinates using the Get coordinates from selection button.

Liste des catalogues d'utilisateurs connus :

Parfois, les utilisateurs créent leurs propres catalogues, nous pouvons essayer de mettre un lien ici pour aider tout le monde.

• Étoiles variables, extraites de GCVS 5.1, discuté ici en français, (lien).

Avertissement

Contrairement aux instructions discutées dans le sujet lié, il n'est pas recommandé de remplacer le catalogue Ciel Profond utilisateur par de tels fichiers. Leur utilisation est déconseillée car certains d'entre eux peuvent être particulièrement volumineux et ralentiraient considérablement chaque affichage d'annotation.

Recherche d'un objet connu

Si vous savez qu'un objet spécifique se trouve quelque part dans l'image (sinon, voir la section recherche d'un objet inconnu), il est possible de l'ajouter aux annotations.

Objets du ciel profond

Load a plate resolved image and type Ctrl+Shift+/ or Tools ‣ Astrometry ‣ Annotate... then go to the Search Object tab of the dialog box.

A search dialog box is available, as illustrated below, in which object names can be entered.

Search Object dialog

Pressing Enter or Apply will first search for this name the existing annotation catalogues in case it already exists under another name. If not it will send an online request to SIMBAD to get the coordinates of an object with such a name. If found, and not already in any catalogue, the object will be added to the Deep Sky user catalogue.

The items of this catalogue are displayed in ORANGE while the objects from the predefined catalogues are displayed in GREEN.

Objets du ciel profond à partir de catalogues d'utilisateurs et de catalogues prédéfinis

Exemples d'entrées valides (non sensible à la case) :

• HD 86574 ou HD86574 sont tout deux valide pour cette étoile

Objets du système solaire

From Siril version 1.2, objects from the solar system can also be searched for, using the Miriade ephemcc service. This is done in the same manner as for Deep Sky Objects, but prefixing the name of the object to be searched by some keyword representing the type of object: a: for asteroids, c: for comets, p: for planets, dp: for dwarf planets and s: for natural satellites. If you query an image taken from a close enough date and time (same night) than another image already annotated with SSOs, their cached positions will be used and corrected by each object velocity as returned by the ephemerids. The items of this catalogue are displayed in YELLOW.

Exemples d'entrées valide (non sensible à la case) :

• c:67p ou c:C/2017 T2 sont une forme valide pour les comètes

• a:1 et a:ceres sont tous deux valides pour (1) Ceres

• a:2000 BY4 est valide pour 103516 2000 BY4

• p:4 or p:mars sont tous les deux valides pour Mars

• dp:Pluto est valide pour Pluton

• s:Moon ou s:Io est valide pour les satellites naturels.

Avertissement

Les images qui n'ont pas de clé d'en-tête DATE-OBS ne peuvent pas être annotées pour les objets du système solaire. Les images qui n'ont pas d'informations sur la position de l'observateur (clés d'en-tête SITELAT, SITELONG et SITEELEV) seront tout de même annotées, mais en supposant une position géocentrique de l'observateur, c'est-à-dire comme s'il observait depuis le centre de la Terre. En fonction de la distance des objets par rapport à la Terre, les positions peuvent être légèrement décalées par rapport à leur position réelle.

Résultat d'un processus de recherche dans le système solaire

Commande catsearch

The same feature is accessible through the command catsearch:

Ligne de commande Siril

catsearch name

Recherche un objet par nom et l'ajoute au catalogue d'annotations de l'utilisateur. L'objet est d'abord recherché dans les catalogues d'annotations, s'il n'est pas trouvé, une demande est faite à SIMBAD.

L'objet peut être un objet du système solaire, auquel cas un préfixe, "a :" pour astéroïde, "p :" pour planète, "c :" pour comète, "dp :" pour planète naine ou "s :" pour satellite naturel, doit précéder le nom de l'objet. La recherche est effectuée pour la date, l'heure et le lieu d'observation figurant dans l'en-tête de l'image, à l'aide du service Miriade de l'IMCCE

Recherche d'un objet inconnu

Particulièrement utile pour les travaux de photométrie, il est possible d'identifier une étoile ou d'autres objets dans l'image en dessinant une sélection autour d'eux, en faisant un clic droit pour faire apparaître le menu contextuel, et en sélectionnant l'entrée PSF.

La fenêtre PSF s'ouvre et, s'il s'agit d'une étoile, elle affiche les paramètres de l'ajustement gaussien, mais aussi un lien Web en bas à gauche de la fenêtre. En l'ouvrant, vous accéderez à la page SIMBAD pour les coordonnées de l'objet et, dans de nombreux cas, vous obtiendrez le nom de l'objet.

SIMBAD ne contient pas tous les objets connus, mais les coordonnées de la page peuvent être utilisées comme point de départ pour rechercher l'objet dans d'autres catalogues en ligne, par exemple Gaia DR3 (VizieR).