(Updating to match new version of source page)
(Updating to match new version of source page)
 
(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
<languages />
 
<languages />
 +
__FORCETOC__
 +
 
=Siril scripts=
 
=Siril scripts=
  
Line 7: Line 9:
  
 
==Using scripts==
 
==Using scripts==
 +
There are two ways to start a script manually:
 +
* using the '''@''' keyword on the command line, followed by the script name, as explained [[Siril:Commands#Introduction|here]],
 +
* or use the Scripts menu.
 +
 +
The scripts menu only appears if some scripts have been found in the script search directories defined either by default or by the user in the preference menu.
  
There are two ways to start a script manually: using the '''@''' keyword on the command line, followed by the script name, as explained [[Siril:Commands#Introduction|here]], or use the script menu.
+
[[File:Scripts_EN.jpg]]
  
The script menu only appears if some scripts have been found in the script search directories defined either by default or by the user in the program settings.
+
'''If you don't see the Scripts menu (or if you don't see the default scripts in the list):'''
  
[[File:Siril_scripts_menu.png]]
+
Please use the following procedure:
 +
* click on the 'Burger' icon then on 'Preferences'
 +
[[File:Menu-Preferences_EN.jpg]]
 +
* click on the 'Scripts' section
 +
* delete the 2 lines in the field as described below
 +
* click on 'Apply'
 +
* close and restart SiriL
 +
[[File:Preferences-Scripts_EN.jpg]]
  
 
==Getting scripts==
 
==Getting scripts==
 +
* Since release [[Siril:0.9.10|0.9.10]], scripts are provided with the installation.
 +
* Since release [[Siril:0.99.4|0.99.4]], a new command 'convert' allows the execution of universal scripts that are available for DSLR (RAW files) and Astro cameras (FITs files).
 +
 +
 +
'''Default scripts (automatically installed with SiriL):'''
 +
 +
* [https://gitlab.com/free-astro/siril/-/blob/master/scripts/Mono_Preprocessing.ssf Mono_Preprocessing.ssf]: script for monochrome DSLR or Astro camera preprocessing, uses biases, flats and darks, registers and stacks the images. To use it: put your files (RAW or FITs) in the folders named 'lights', 'darks', 'flats' and 'biases' (in the SiriL default working folder), then run the script. When the script ends, you get a monochrome file named result.fit.
 +
* [https://gitlab.com/free-astro/siril/-/blob/master/scripts/OSC_Preprocessing.ssf OSC_Preprocessing.ssf]: same script as above but for One-Shot Color (OSC) DSLR or Astro camera. To use it: put your files (RAW or FITs) in the folders named 'lights', 'darks', 'flats' and 'biases' (in the SiriL default working folder), then run the script. When the script ends, you get a RGB file named result.fit.
 +
* [https://gitlab.com/free-astro/siril/-/blob/master/3rdparty/scripts/en/OSC_Preprocessing_WithDrizzle.ssf OSC_Preprocessing_WithDrizzle.ssf]: same script as above with resize of images by 2x2. Beware, this script takes much more time and disk space. To use it: put your files (RAW or FITs) in the folders named 'lights', 'darks', 'flats' and 'biases' (in the SiriL default working folder), then run the script. When the script ends, you get a RGB file named result.fit.
 +
* [https://gitlab.com/free-astro/siril/-/blob/master/scripts/OSC_Extract_Ha.ssf OSC_Extract_Ha.ssf]: script for OSC DSLR or astro camera preprocessing, for use with Ha filter or dual-band filter. This script extracts the Ha layer of the color image. To use it: put your files (RAW or FITs) in the folders named 'lights', 'darks', 'flats' and 'biases' (in the SiriL default working folder), then run the script. When the script ends, you get a monochrome file named Ha_result.fit.
 +
* [https://gitlab.com/free-astro/siril/-/blob/master/scripts/OSC_Extract_HaOIII.ssf OSC_Extract_HaOIII.ssf]: same script as above, but extracts Ha and OIII layers of the color image. To use it: put your files (RAW or FITs) in the folders named 'lights', 'darks', 'flats' and 'biases' (in the SiriL default working folder), then run the script. When the script ends, you get 2 monochrome files named Ha_result.fit and OIII_result.fit. You can also use the menu 'Image Processing' then 'RGB compositing' and put Ha_result in Red layer and OIII_result in Green and Blue layers to get an HOO image.
 +
 +
 +
'''Other scripts:'''
  
In release [[Siril:0.9.10|0.9.10]], scripts will be provided with the installation. It was already the case only for the Windows installer for [[Siril:0.9.9|0.9.9]]. Here are the scripts that are in the installers:
+
* [https://free-astro.org/images/4/4b/Mono_Preprocessing_WithoutFlat.ssf Mono_Preprocessing_WithoutFlat.ssf]: preprocess monochrome images without bias nor flat. Added 2020/10/17
 +
* [https://free-astro.org/images/7/71/Mono_Preprocessing_WithoutDark.ssf Mono_Preprocessing_WithoutDark.ssf]: preprocess monochrome images without dark. Added 2020/10/17
 +
* [https://free-astro.org/images/9/95/Mono_Preprocessing_WithoutDBF.ssf Mono_Preprocessing_WithoutDBF.ssf]: preprocess monochrome images without dark, bias nor flat. Added 2020/09/01
 +
* [https://free-astro.org/images/e/ea/OSC_Preprocessing_WithoutFlat.ssf OSC_Preprocessing_WithoutFlat.ssf]: preprocess color images without bias nor flat. Added 2020/10/17
 +
* [https://free-astro.org/images/1/1a/OSC_Preprocessing_WithoutDark.ssf OSC_Preprocessing_WithoutDark.ssf]: preprocess color images without dark. Added 2020/10/17
 +
* [https://free-astro.org/images/a/a4/OSC_Preprocessing_WithoutDBF.ssf OSC_Preprocessing_WithoutDBF.ssf]: preprocess color images without dark, bias nor flat. Added 2020/09/01
 +
* [https://free-astro.org/images/d/dd/OSC_Startrail.ssf OSC_Startrail.ssf]: preprocess color images and build a star-trail. Added 2020/09/01.  
  
* [https://gitlab.com/free-astro/siril/raw/master/scripts/DSLR_preprocessing.ssf DSLR_preprocessing.ssf]: script for DSLR color camera preprocessing, Uses bias, flats and darks, registers and stack the images.
 
* [https://gitlab.com/free-astro/siril/raw/master/3rdparty/scripts/en/DSLR_Preprocessing_Drizzle.ssf DSLR_Preprocessing_Drizzle.ssf]
 
* [https://gitlab.com/free-astro/siril/raw/master/3rdparty/scripts/en/DSLR_Preprocessing_NoFlat_NoDark_NoBias.ssf DSLR_Preprocessing_NoFlat_NoDark_NoBias.ssf]
 
* [https://gitlab.com/free-astro/siril/raw/master/3rdparty/scripts/en/DSLR_Preprocessing_NoDark.ssf DSLR_Preprocessing_NoDark.ssf]
 
* [https://gitlab.com/free-astro/siril/raw/master/3rdparty/scripts/en/DSLR_preprocessing_Cosmetic.ssf DSLR_preprocessing_Cosmetic.ssf]
 
* [https://gitlab.com/free-astro/siril/raw/master/3rdparty/scripts/en/DSLR_Preprocessing_NoFlat.ssf DSLR_Preprocessing_NoFlat.ssf]
 
* [https://gitlab.com/free-astro/siril/raw/master/3rdparty/scripts/en/DSLR_preprocessing_Drizzle_Cosmetic.ssf DSLR_preprocessing_Drizzle_Cosmetic.ssf]
 
* [https://gitlab.com/free-astro/siril/raw/master/3rdparty/scripts/en/DSLR_Preprocessing_NoFlat_NoDark.ssf DSLR_Preprocessing_NoFlat_NoDark.ssf]
 
  
 
We encourage users creating their own scripts to publish them and make a link in this page with a basic description of what they do.
 
We encourage users creating their own scripts to publish them and make a link in this page with a basic description of what they do.
 +
 +
We also suggest users to use [https://gitlab.com/free-astro/sirilic Sirilic] to generate scripts or [https://gitlab.com/free-astro/sirilic Sirilot] to provide a more suited way to manage all the files required for such a processing.

Latest revision as of 18:00, 17 October 2020

Other languages:
Ελληνικά • ‎English • ‎français • ‎italiano


Siril scripts

Since its early days, Siril can take user inputs as textual commands, from the command line. Recently, more commands have been added, enabling for a basic automated processing of images. Commands can be stored in a file that we call script, and they are executed one after the other. Some commands can be used in scripts, some cannot, this is indicated in the help of the command line from the graphical user interface of siril.

Since release 0.9.9, Siril can execute scripts from a file. Since 0.9.10, commands can also be taken from a named pipe.

Using scripts

There are two ways to start a script manually:

  • using the @ keyword on the command line, followed by the script name, as explained here,
  • or use the Scripts menu.

The scripts menu only appears if some scripts have been found in the script search directories defined either by default or by the user in the preference menu.

Scripts EN.jpg

If you don't see the Scripts menu (or if you don't see the default scripts in the list):

Please use the following procedure:

  • click on the 'Burger' icon then on 'Preferences'

Menu-Preferences EN.jpg

  • click on the 'Scripts' section
  • delete the 2 lines in the field as described below
  • click on 'Apply'
  • close and restart SiriL

Preferences-Scripts EN.jpg

Getting scripts

  • Since release 0.9.10, scripts are provided with the installation.
  • Since release 0.99.4, a new command 'convert' allows the execution of universal scripts that are available for DSLR (RAW files) and Astro cameras (FITs files).


Default scripts (automatically installed with SiriL):

  • Mono_Preprocessing.ssf: script for monochrome DSLR or Astro camera preprocessing, uses biases, flats and darks, registers and stacks the images. To use it: put your files (RAW or FITs) in the folders named 'lights', 'darks', 'flats' and 'biases' (in the SiriL default working folder), then run the script. When the script ends, you get a monochrome file named result.fit.
  • OSC_Preprocessing.ssf: same script as above but for One-Shot Color (OSC) DSLR or Astro camera. To use it: put your files (RAW or FITs) in the folders named 'lights', 'darks', 'flats' and 'biases' (in the SiriL default working folder), then run the script. When the script ends, you get a RGB file named result.fit.
  • OSC_Preprocessing_WithDrizzle.ssf: same script as above with resize of images by 2x2. Beware, this script takes much more time and disk space. To use it: put your files (RAW or FITs) in the folders named 'lights', 'darks', 'flats' and 'biases' (in the SiriL default working folder), then run the script. When the script ends, you get a RGB file named result.fit.
  • OSC_Extract_Ha.ssf: script for OSC DSLR or astro camera preprocessing, for use with Ha filter or dual-band filter. This script extracts the Ha layer of the color image. To use it: put your files (RAW or FITs) in the folders named 'lights', 'darks', 'flats' and 'biases' (in the SiriL default working folder), then run the script. When the script ends, you get a monochrome file named Ha_result.fit.
  • OSC_Extract_HaOIII.ssf: same script as above, but extracts Ha and OIII layers of the color image. To use it: put your files (RAW or FITs) in the folders named 'lights', 'darks', 'flats' and 'biases' (in the SiriL default working folder), then run the script. When the script ends, you get 2 monochrome files named Ha_result.fit and OIII_result.fit. You can also use the menu 'Image Processing' then 'RGB compositing' and put Ha_result in Red layer and OIII_result in Green and Blue layers to get an HOO image.


Other scripts:


We encourage users creating their own scripts to publish them and make a link in this page with a basic description of what they do.

We also suggest users to use Sirilic to generate scripts or Sirilot to provide a more suited way to manage all the files required for such a processing.