Аннотации

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 menu Tools ‣ Astrometry ‣ Image Plate Solver... entry, or using external tools like astrometry.net or ASTAP.

графический интерфейс пользователя для изображения с астрономическим решением

Кнопки для аннотаций

Когда в Siril загружается изображение, имеющее астрономическое решение, вы можете увидеть координаты неба для пикселя под указателем мыши, отображаемым в правом нижнем углу, и становятся доступными кнопки, связанные с аннотациями. Первая кнопка включает или выключает аннотации объектов, вторая — небесную сетку и компас.

Offline annotation catalogues

Siril поставляется с заранее определенным списком каталогов для аннотаций:

  • Каталог Мессье (М)

  • Новый общий каталог (NGC)

  • Индекс-каталог (IC)

  • Каталог тёмных туманностей Линдс (LdN)

  • Каталог Шарплесса (Sh2)

  • Каталог звёзд (3661 ярчайших звёзд)

  • Линии созвездий МАС

  • Названия созвездий МАС (положения получены с этой страницы)

В дополнение могут быть использованы 2 пользовательских каталога:

  • Пользовательский каталог объектов глубокого космоса (DSO)

  • Пользовательский каталог объектов Солнечной системы (SSO)

They are populated with the commands described in the section about searching for a known object.

They are stored in the user settings directory. Their location depends on the operating system:

  • для UNIX-подобных ОС они будут в ~/.config/siril/catalogue

  • на Windows они в %LOCALAPPDATA%\siril\catalogue.

All of the above catalogues can be enabled/disabled for display in the Preferences menu ‣ Astrometry tab.

The two user defined catalogues can also be purged (i.e. deleted) via the appropriate buttons.

Ползунок, расположенный справа, позволяет вам легко перемещаться по списку каталогов.

Управление каталогами

Управление каталогами в Настройки/Астрометрия

There's also a simpler way of accessing this list, as well as the button for displaying/hiding catalog annotations. Right-click on the annotations button in the toolbar and the list will be displayed in a popup window.

Catalogue management in the popup window

Catalogue management in the pop-up window triggered by right-clicking on the annotation button.

These annotation catalogues are used primarily for display purposes. Starting from Siril 1.3, they are also used to locate the center of the image for astrometry tool. If the object is found locally, the resolver will be shown as Local. If not, it will fall back using an online resolver.

Локальный решатель

Object resolved from local annotations catalogues

Online annotation catalogues

You may want to query other databases than the ones already shipped with Siril, described in the offline annotation catalogues section. This works, again, for plated-solved images only.

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.

Командная строка Siril

conesearch [limit_magnitude] [-cat=] [-phot] [-obscode=] [-tag={on|off}] [-log={on|off}] [-trix=] [-out=]
Отображает звёзды из локального каталога по умолчанию для загруженного изображения, имеющего астрономическое решение, вплоть до заданного значения limit_magnitude (для большинства каталогов по умолчанию — 13, за исключением 14.5 для aavso_chart, 20 для solsys и пропущено для pgc).
Альтернативный удалённый каталог можно указать с помощью аргумента -cat=, принимающего значения
- for stars: tycho2, nomad, gaia, localgaia, 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)

Для каталогов, содержащих данные фотометрии, будут сохранены звёзды без информации B-V; их можно исключить, передав аргумент -phot
Вместо каталога можно передать аргумент -trix=, за которым следует число от 0 до 511, для отображения трикселей 3-го уровня, содержащих звёзды, из локальных каталогов (в основном для использования разработчиками)

Ряд каталогов (bsc, gcvs, pgc, exo, aavso_chart, varisum and solsys) показывают названия объектов рядом с маркерами (только графический интерфейс) и выводят их в журнал. Для каталогов с большим количеством объектов, а именно vsx и simbad, эта информация также может отображаться, но, поскольку она может загромождать экран, по умолчанию её показ отключен. Это поведение можно включить / выключить с помощью аргументов -tag=on|off (для показа названий рядом с маркерами) и -log=on|off (для вывода списка объектов в журнал)

Список элементов, присутствующих на изображении, при желании можно сохранить в файле csv, передав аргумент -out=

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

Conesearch UI

Графическая версия команды conesearch

The table below lists all the catalogues that are available, alongside links to the original data.

Доступные каталоги

Каталог

-cat=

Литература

Local

Omitted

using local star catalogues

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

Каталоги ярких звёзд

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

Архив экзопланет

exo

https://exoplanetarchive.ipac.caltech.edu

AAVSO VSP

aavso_chart

https://app.aavso.org/vsp/

IMCCE Solar system skybot

solsys

https://vo.imcce.fr/webservices/skybot/?conesearch

The following queries are brought to you thanks to:

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).

Совет

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.

Дополнительные каталоги

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.

Командная строка Siril

show [-clear] [{ -list=file.csv | [name] RA Dec }] [-nolog] [-notag]
На основании экваториальных координат показывает точку на загруженном изображении, имеющем астрономическое решение, используя временный каталог с пользовательскими аннотациями. Аргумент -clear сначала очищает этот каталог и может использоваться отдельно.
С помощью аргумента -list= можно передать несколько точек, используя файл в формате CSV, содержащий по крайней мере столбцы с данными о прямом восхождении и склонении. Если указанный файл так же также содержит столбец с названием, эти названия будут использованы как метки на изображении и отображены в журнале, если только не отключены с помощью опций -notag и -nolog.

Это доступно только через графический интерфейс Siril

These catalogues may be any csv (comma-separated) file, respecting the following rules:

  • строки с комментариями, если необходимы, должны начинаться со знака #

  • a line should be present at the top with the column names, comma separated

  • at least ra and dec columns should be provided, in decimal degrees.

  • the columns can be written in no particular order

  • other columns can be passed:

    • name (str)

    • diameter (double), the object diameter in arcmin

    • mag (double), the object magnitude

    • type (str), which will be appended between () after the name in the Console

Other columns than those listed above may be passed but they will not be used.

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.

Show UI

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:

Show UI single point

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

Совет

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

Совет

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

Список известных пользовательских каталогов:

Sometimes, users create their own catalogues, we can try to link them here to help everybody.

Предупреждение

Contrarily to the instructions discussed in the linked topic, it is not recommended to replace the user-DSO catalogue with such files. The usage is discouraged as some of them could be particularly big and would slow down tremendously every annotation redraw.

Поиск известного объекта

If you know a specific object is somewhere in the image (if not, see the search for an unknown object section), it is possible to add it to annotations.

Deep-sky objects

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 UI

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.

Пользовательские объекты глубокого космоса

Объекты дальнего космоса из пользовательского и предопределенных каталогов

Examples of valid input (not case sensitive):

  • HD 86574 или HD86574 оба запроса подходят для этой звезды

Объекты Солнечной системы

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.

Примеры допустимых поисковых запросов (регистр не имеет значения):

  • c:67p или c:C/2017 T2 являются допустимыми формами запроса для комет

  • a:1 и a:ceres допустимы для (1) Цереры

  • a:2000 BY4 действителен для 103516 2000 BY4

  • p:4 or p:mars are both valid for Mars

  • dp:Pluto is valid for Pluto

  • s:Moon or s:Io is valid for natural satellites.

Предупреждение

Images that do not have a DATE-OBS header key cannot be annotated for SSOs. Images that do not have observer location information (SITELAT, SITELONG and SITEELEV header keys) will still be annotated, but assuming a geocentric observer position, i.e. as if observing from center of the Earth. Depending on objects distance wrt. Earth, this may result in positions being slightly offset from their real positions.

Solar Sytem Result

Результат процесса поиска в Солнечной системе

Command catsearch

The same feature is accessible through the command catsearch:

Командная строка Siril

catsearch name
Ищет объект по названию (name) и добавляет его в каталог пользовательских аннотаций. В первую очередь поиск производится в каталоге аннотаций. Если объект не найден, то делается запрос к удалённому серверу SIMBAD.
Объектом может быть тело Солнечной системы. В этом случае перед названием объекта необходим префикс 'a:' для астероида, 'p:' для планеты, 'c:' для кометы, 'dp:' для карликовой планеты или 's:' для естественного спутника. Поиск выполняется для даты и местоположению Земли, указанным в заголовке файла, с помощью сервиса Miriade от Института небесной механики и вычисления эфемерид (IMCCE)

Поиск неизвестного объекта

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 the PSF entry.

This will open the PSF window, and if it is 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 does not 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).