Siril image annotations (documentation for version 1.2)
Annotations are glyphs displayed on top of images to depict the presence of known sky objects, like
galaxies, bright stars and so on. They come from catalogues but can only be displayed on images for
which we know which part of the sky they represent, images that have been plate solved and
contain the world coordinate system (WCS) information in their header, so only FITS or Astro-TIFF
files. Plate solving, can be done within Siril in the
Image Information menu,
Image Plate Solver... entry, or using external tools like astrometry.net
When a plate solved image is loaded in Siril, you can see the sky coordinates for the pixel under the mouse pointer displayed at the bottom right corner and the buttons related to annotations become available. The first button activates object annotations, the second the celestial grid and the compass.
Types of catalogues #
Siril comes with a predefined list of catalogues for annotations:
- Messier catalogue (M)
- New General Catalogue (NGC)
- Index Catalogue (IC)
- Lynds Catalogue of Dark Nebulae (LdN)
- Sharpless Catalogue (Sh2)
- Star Catalogue (3661 of the brightest stars)
In addition, 2 user defined catalogues can be used:
- User Deep Sky Objects Catalogue
- User Solar System Objects Catalogue
Catalogue management #
Both these catalogues can be enabled/disabled for display in the
A slider on the right side, allows you to easily navigate across the catalogue list.
The two user defined catalogues can also be purged (ie deleted) via the appropriate buttons.
The user catalogues (DSO, SSO or extra catalogues) are stored in the user settings directory and can be easily modified.
Their location depends on the operating system:
- for Unix-based OS they will be in
- on Windows they are in
The position of the compass on the image can be adjusted from the preferences too.
These annotation catalogues are for display purposes only. They are not used in astrometry or photometry tools, contrary to the star catalogues like NOMAD, which can now be installed locally too.
Searching for a new object #
When the name of an object in the image is known (if not, see the “The inverse search” section), it is possible to add it to annotations:
- with the image loaded and plate solved, type
<CTRL> <SHIFT> </>or
Searchin the pop-up menu (right click).
A small search dialog will appear. In it, object names can be entered, then pressing
<ENTER> will send an online
request to SIMBAD (for a star of Deep Sky Object) 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.
From Siril version 1.2, we can now search for solar system objects too, using the
service. This is done by
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. Since they are moving objects, they can be
added several times, and the request is done for the date of observation of the currently loaded
image. The date is associated to the name in the user Solar System Catalogue.
The items of this catalogue are displayed in YELLOW.
Examples of valid inputs (not case sensitive):
HD86574are both valid for this star
c:C/2017 T2are valid forms for comets
a:ceresare both valid for (1) Ceres
a:2000 BY4is valid for 103516 2000 BY4
Filling a Solar System user Catalogue: which SSO is in this field? #
As previously said, solar system objects are moving, so, in order to get them displayed in a plate solved image, Siril has to request a particular online server of the IMCCE (SkyBoT ). To answer the question Is there any solar system object in my image?, a special function gives (and show) you the answer:
- with the image loaded and plate solved, right click/
Solar System Objects, or in the command line you can use the
It displays in RED all the Solar System objects in the field of view (if any, of course).
Additional information is available in the console (such as the magnitude, RA and Dec).
These red annotations will be erased as soon as the
Show Objects names button is toggled.
However, you may want to save any particular item in the User Solar System Objects Catalogue.
It can be done by using the
Search command for a solar system object as previously described.
This way, the saved item is diplayed in YELLOW.
The inverse search: what is this object? #
Especially useful for photometry works, it is possible to identify a star or other objects in the
image by drawing a selection around them, right clicking to bring up the context menu, and selecting
PSF entry. This will open the PSF window, and if it’s a star it will display the Gaussian fit
parameters, but it will also display a Web link at the bottom left of the window: opening it will
bring you to the SIMBAD page
for the coordinates of
the object and in many cases will give you the name of the object. SIMBAD doesn’t have all known
objects, but the coordinates from the page can still be used as a starting point to look for the
object in other online catalogues, for example
Gaia DR3 (VizieR)
Extra catalogues #
Sometimes, users create their own catalogues, we can try to link them here to help everybody. They are user catalogues, so installing them requires either replacing the current user catalogue, or by manually merging their lines into a new file.
List of known user catalogues: