Сценарии
Siril имеет командную строку в своем графическом интерфейсе пользователя и возможность запускать скрипты, которые являются списком команд, либо из графического интерфейса пользователя, либо из интерфейса командной строки. Как правило, команды, которые изменяют одно изображение, работают с текущим загруженным изображением, поэтому в скриптах требуется использование команды load, а команды, которые работают с последовательностью изображений, принимают имя последовательности в качестве аргумента. Если файлы названы таким образом, что Siril не может их определить как последовательность, поможет команда convert.
Совет
Символ Пробел является разделителем между аргументами. Если вам нужны пробелы внутри аргументов, вы можете использовать кавычки или двойные кавычки, как в командной строке операционной системы.
Команды можно вводить в командной строке в нижней части главного окна Siril. Другой способ — поместить команды в файл и запустить его в виде сценария. Чтобы запустить сценарий из графического интерфейса пользователя, добавьте его в одну из директорий, указанных в Настройках на вкладке Сценарии, или в командной строке Siril, используя символ @ следующим образом:
@file_name
В некоторых командах (preprocess, stack и всех командах сохранения) можно использовать переменные, содержащиеся в заголовках FITS, для формирования имени файла. Формат выражения подробно описан здесь и может быть протестирован с помощью команды parse.
Использование сценариев
Возможны три способа запуска сценария:
из командной строки Siril, используя ключевое слово
@, за которым следует имя сценария в текущем рабочем каталоге,из графического интерфейса пользователя используя меню Сценарии,
из командной строки операционной системы (приложение siril-cli), используя аргумент
-s, за которым следует путь к сценарию (для дополнительной информации см. руководство).
Меню Сценарии появляется только в том случае, если хотя бы один файл сценария был найден в директориях поиска сценариев, определенных либо по умолчанию, либо пользователем в Настройках.
Заполнение списка сценариев
При установке Siril по умолчанию автоматически устанавливается ряд сценариев. Эти встроенные сценарии — официальные сценарии. Они разрабатываются командой разработчиков и будут гарантированно работать: они предназначены для определённых случаев использования.
Добавление директорий пользовательских сценариев
Конечно, вы можете написать свои собственные сценарии и указать Siril, где их найти:
Нажмите на значок Главное меню, а затем на Настройки (или нажмите Ctrl+P).
Нажмите на вкладку :guilabel: "Сценарии".
Скопируйте в новую строку путь к месту хранения ваших сценариев (при необходимости создайте директорию на своем компьютере или укажите на существующую).
Нажмите на значок Обновить чуть ниже.
Нажмите Применить.
У вас может быть столько пользовательских директорий, сколько вы пожелаете, просто добавьте их в список.
Если вы только что добавили новый скрипт в одну из директорий и хотите обновить меню, введите команду reloadscripts в командной строке или откройте раздел и используйте значок Обновить. Это просканирует все директории из списка и найдет в них все файлы с расширением *.ssf.
Предупреждение
Настоятельно рекомендуется не хранить пользовательские скрипты в той же директории, что и встроенные скрипты Siril. В Windows они могут быть удалены при установке новой версии или помешать корректному удалению. В MacOS это сломает пакет и вообще не позволит использовать Siri.
Не волнуйтесь, поскольку список расположений сценариев хранится в вашем конфигурационном файле, вы обязательно их обнаружите при установке более новой версии.
Устранение проблем
По разным причинам меню Сценарии может быть не видно. Это означает, что скрипты не найдены. Если это так, воспользуйтесь следующей процедурой.
Нажмите на значок Главное меню, а затем на Настройки.
Нажмите на вкладку :guilabel: "Сценарии".
Удалите все строки в поле Директории хранения сценариев, как показано на рисунке ниже.
Нажмите Применить.
Закрыть и перезапустить Siril.
Страница настроек сценариев. Сценарии загружаются по путям, указанным в разделе Директории хранения сценариев.
Встроенные сценарии
Все встроенные сценарии требуют соблюдения следующей файловой структуры:
Mono_Preprocessing.ssf: сценарий для предварительной обработки монохромных изображений, полученных с помощью DSLR или астрокамер. Использует кадры тока считывания (biases), кадры плоского поля (flats) и кадры темнового тока (darks), выравнивает и складывает изображения (lights). Чтобы использовать этот сценарий: поместите ваши файлы (RAW или FITs) в директории с именами
lights,darks,flatsиbiases(в текущей рабочей директории Siril), затем запустите сценарий.OSC_Preprocessing.ssf: такой же сценарий, что и выше, но для цветных (One-Shot Color (OSC) DSLR или астрокамер. Чтобы использовать этот сценарий: поместите ваши файлы (RAW или FITS) в директории с именами
lights,darks,flatsиbiases(в текущей рабочей директории Siril), затем запустите сценарий.OSC_Extract_Ha.ssf: сценарий для предварительной обработки изображений, полученных с использованием цветных (OSC) DSLR или астрокамер, при использовании двухполосного или Ha фильтра. Этот скрипт извлекает Ha-слой цветного изображения. Чтобы использовать этот сценарий: поместите ваши файлы (RAW или FITs) в директории с именами
lights,darks,flatsиbiases(в текущей рабочей директории Siril), затем запустите сценарий.OSC_Extract_HaOIII.ssf: такой же сценарий, что и выше, но извлекает из цветного изображения Ha и OIII слои. Чтобы использовать этот сценарий: поместите ваши файлы (RAW или FITs) в директории с именами
lights,darks,flatsиbiases(в текущей рабочей директории Siril), затем запустите сценарий. Вы также можете использовать меню Обработка, затем Совмещение в RGB и поместить результат Ha в красный канал, а результат OIII в зелёный и синий слои, чтобы получить изображение в палитре HOO.Совет
Для владельцев SII или двухполосных SII-OIII фильтров применяются те же сценарии. Фактически, для цветного датчика невозможно увидеть разницу между Ha (656,3 нм) и SII (671,6 нм), оба из которых красные.
RGB_Composition.ssf: Этот сценарий, добавленный в версии 1.2, делает глобальное выравнивание монохромных изображений, кадрирует их до области, общей для всех изображений, и берет первые три изображения для создания цветного изображения. Входные изображения должны быть помещены в отдельную директорию и названы
R.fit(или с настроенным расширением),G.fitиB.fit. В результате будет получен файл с названиемrgb.fit. Обязательно удаляйте директориюprocessперед каждым запуском сценария.
Язык сценариев
В начале работы над скриптами, благодаря вкладу пользователей, скрипты существовали в двух версиях (английской и французской). Когда был выпущен Siril 1.2.0, для простоты обслуживания было решено оставить только английские скрипты. Мы призываем пользователей распространять переводы официальных скриптов в своих сообществах, если они сочтут это необходимым.
Получение дополнительных сценариев
Существует целая куча сценариев, которые не поставляются с установкой Siril. Однако мы создали для них репозиторий на gitlab. Каждый может зарегистрироваться и предложить новые сценарии. Мы примем их в зависимости от их актуальности: используемый язык должен быть английским.
Пожалуйста, используйте этот адрес для просмотра и загрузки сценариев https://gitlab.com/free-astro/siril-scripts.
Предупреждение
Однако имейте в виду, что эти сценарии не обязательно поддерживаются пользователями, которые их загрузили, и могут быть неактуальными. Тем не менее, получайте удовольствие.
Написание собственных сценариев
Файл сценария — это простой текстовый файл с расширением *.ssf.
Написать сценарий несложно. Это последовательность вызовов команд, которые будут выполняться одна за другой. Каждая команда должна быть выполнена без ошибки, в противном случае сценарий остановится. Поэтому настоятельно рекомендуется использовать список команд, чтобы знать синтаксис и количество необходимых параметров. Кроме того, некоторые команды не могут быть использованы в сценариях и обозначены значком 
. Также может быть полезно протестировать каждую строку сценария в командной строке Siril.
Каждый новый сценарий, созданный таким образом, должен быть помещен в папку, указанную пользователем, чтобы Siril мог его найти.