adding translation markup
Marked this version for translation
Line 1: Line 1:
<languages />
<languages />
<translate>
<translate>
=Manual page for Siril=
=Manual page for Siril= <!--T:1-->


<!--T:2-->
[[Siril]] is an astronomical image processing free software, see [[Siril|main page]] for more details.
[[Siril]] is an astronomical image processing free software, see [[Siril|main page]] for more details.


==A powerful astronomical image viewer==
==A powerful astronomical image viewer== <!--T:3-->


<!--T:4-->
A Display Mode viewer is used to improve the visibility of an image, but without altering its pixel data in any way.
A Display Mode viewer is used to improve the visibility of an image, but without altering its pixel data in any way.
*Linear: This is the default mode in Siril. Pixels are displayed from the darkest to the brightest in a linear scale.
*Linear: This is the default mode in Siril. Pixels are displayed from the darkest to the brightest in a linear scale.
Line 15: Line 17:
*Histogram: This mode increases the contrast of the image by increasing the dynamic range of intensity given to pixels with the most probable intensity values. It is very valuable to evaluate all the signal contained in the image.
*Histogram: This mode increases the contrast of the image by increasing the dynamic range of intensity given to pixels with the most probable intensity values. It is very valuable to evaluate all the signal contained in the image.


<!--T:5-->
All these modes can also be applied on each layer in an independent way.
All these modes can also be applied on each layer in an independent way.


<!--T:6-->
This video tutorial shows the different modes you can use to display your images.
This video tutorial shows the different modes you can use to display your images.


<!--T:7-->
<html5media width="750">http://free-astro.vinvin.tf/videos/Display.webm</html5media>
<html5media width="750">http://free-astro.vinvin.tf/videos/Display.webm</html5media>


<!--T:8-->
In addition to this, Siril provides different colormap display:
In addition to this, Siril provides different colormap display:
[[File:Siril_colormap.png|600px]]
[[File:Siril_colormap.png|600px]]


==Process your single images==
==Process your single images== <!--T:9-->
===Background extraction===
===Background extraction===


<!--T:10-->
When your image contains  an intense light pollution, it is useful to remove it. Siril provides a "Background Extraction" tool in order to remove the gradient of the sky background. So far, Siril uses a polynomial method where generally 4th degree is a good choice. However, this tool allows you to choose between first and 4th degree.
When your image contains  an intense light pollution, it is useful to remove it. Siril provides a "Background Extraction" tool in order to remove the gradient of the sky background. So far, Siril uses a polynomial method where generally 4th degree is a good choice. However, this tool allows you to choose between first and 4th degree.


<!--T:11-->
[[File:Siril_bkg.png]]
[[File:Siril_bkg.png]]


<!--T:12-->
After extraction you can switch between image and background view in order to check the result. If you are satisfied you can thus apply the correction (subraction or division). The subtraction operation is very different from the simple operation used for the darks and bias/offsets. Indeed, as the level of the background is identical to the one of the image, applying a simple subtraction would result in a image with a lot of black pixels. To avoid any inconvenience, the operation is done with 32bits signed integers and finally converted into native format (16-bits unsigned).
After extraction you can switch between image and background view in order to check the result. If you are satisfied you can thus apply the correction (subraction or division). The subtraction operation is very different from the simple operation used for the darks and bias/offsets. Indeed, as the level of the background is identical to the one of the image, applying a simple subtraction would result in a image with a lot of black pixels. To avoid any inconvenience, the operation is done with 32bits signed integers and finally converted into native format (16-bits unsigned).


<!--T:13-->
Following, respectively, the start image and final image (after background extraction with subtraction and equalization):
Following, respectively, the start image and final image (after background extraction with subtraction and equalization):


<!--T:14-->
[[File:BKG_before.png|600px]]
[[File:BKG_before.png|600px]]


<!--T:15-->
[[File:BKG_after.png|600px]]
[[File:BKG_after.png|600px]]


===Color calibration===
===Color calibration=== <!--T:16-->


<!--T:17-->
The color calibration tool performs a balancing of the colors of a linear RGB deep-sky image. This video tutorial shows how to use the tool. Note that Background Equalization (now called Background Neutralization) has been moved in the calibration box because it is needed before any calibration.
The color calibration tool performs a balancing of the colors of a linear RGB deep-sky image. This video tutorial shows how to use the tool. Note that Background Equalization (now called Background Neutralization) has been moved in the calibration box because it is needed before any calibration.
This tool is in beta mode and should be use with caution.
This tool is in beta mode and should be use with caution.


<!--T:18-->
<html5media width="750">http://free-astro.vinvin.tf/videos/Color_Calibration.webm</html5media>
<html5media width="750">http://free-astro.vinvin.tf/videos/Color_Calibration.webm</html5media>


===Reducing green tint in processed images===
===Reducing green tint in processed images=== <!--T:19-->


<!--T:20-->
This video tutorial shows how to remove the green tint in processed images using the graphical user interface. This function can also be accessed from the command line, with the [[Siril:Commands#rmgreen|<tt>rmgreen</tt> command]].
This video tutorial shows how to remove the green tint in processed images using the graphical user interface. This function can also be accessed from the command line, with the [[Siril:Commands#rmgreen|<tt>rmgreen</tt> command]].


<!--T:21-->
<html5media width="750">http://free-astro.vinvin.tf/videos/RemoveGreen.webm</html5media>
<html5media width="750">http://free-astro.vinvin.tf/videos/RemoveGreen.webm</html5media>


===Fast Fourier Transform (FFT)===
===Fast Fourier Transform (FFT)=== <!--T:22-->
A FFT algorithm is integrated to Siril in order to provide you a tool to evaluate fixed pattern noise of an image. You can thus remove the frequency pattern of the noise in the modulus file and save the result. Modulus and phase are saved in different files so you can compute the inverse transformation to retrieve the corrected image.  
A FFT algorithm is integrated to Siril in order to provide you a tool to evaluate fixed pattern noise of an image. You can thus remove the frequency pattern of the noise in the modulus file and save the result. Modulus and phase are saved in different files so you can compute the inverse transformation to retrieve the corrected image.  


<!--T:23-->
<html5media width="750">http://free-astro.vinvin.tf/videos/FFT.webm</html5media>
<html5media width="750">http://free-astro.vinvin.tf/videos/FFT.webm</html5media>


==RGB Compositing==
==RGB Compositing== <!--T:24-->
A new channel synthesis tool is provided in Siril. This tool allows you to mix and align up to 7 channels plus one for Luminance. The tool handles the binning, just make sure to not crop the picture before: the bin1x1 must ALWAYS be loaded first and the bin2x2 pictures must be four times as small (divided by a factor of two in each dimension).
A new channel synthesis tool is provided in Siril. This tool allows you to mix and align up to 7 channels plus one for Luminance. The tool handles the binning, just make sure to not crop the picture before: the bin1x1 must ALWAYS be loaded first and the bin2x2 pictures must be four times as small (divided by a factor of two in each dimension).


<!--T:25-->
The first video shows a mixing between L, R, G and B channels with same size and no alignments needed: the L channel is given by an H-alpha processed image.  
The first video shows a mixing between L, R, G and B channels with same size and no alignments needed: the L channel is given by an H-alpha processed image.  
This second video shows mixing between images with different binning. The alignment is also required.  
This second video shows mixing between images with different binning. The alignment is also required.  


<!--T:26-->
After mixing, save your result and process it as you want.
After mixing, save your result and process it as you want.


<!--T:27-->
<html5media width="750">http://free-astro.vinvin.tf/videos/RGB_compositing.webm</html5media>
<html5media width="750">http://free-astro.vinvin.tf/videos/RGB_compositing.webm</html5media>


<!--T:28-->
<html5media width="750">http://free-astro.vinvin.tf/videos/RGB_compositing2.webm</html5media>
<html5media width="750">http://free-astro.vinvin.tf/videos/RGB_compositing2.webm</html5media>


==Tutorial for a complete sequence processing==
==Tutorial for a complete sequence processing== <!--T:29-->


<!--T:30-->
An illustrated tutorial has been compiled to describe the usual processing steps, starting from RAW DSLR images to stacking.
An illustrated tutorial has been compiled to describe the usual processing steps, starting from RAW DSLR images to stacking.


<!--T:31-->
* [[Siril:Tutorial_import|Convert your images in the FITS format Siril uses (image import)]]
* [[Siril:Tutorial_import|Convert your images in the FITS format Siril uses (image import)]]
* [[Siril:Tutorial_sequence|Work on a sequence of converted images]]
* [[Siril:Tutorial_sequence|Work on a sequence of converted images]]
Line 79: Line 102:
* [[Siril:Tutorial_stacking|Stacking]]
* [[Siril:Tutorial_stacking|Stacking]]


<!--T:32-->
A video tutorial is also available to describe the usual planetary processing.
A video tutorial is also available to describe the usual planetary processing.


<!--T:33-->
<html5media width="750">http://free-astro.vinvin.tf/videos/mars_processing.webm</html5media>
<html5media width="750">http://free-astro.vinvin.tf/videos/mars_processing.webm</html5media>


==Astrometry==
==Astrometry== <!--T:34-->


<!--T:35-->
Siril provides a few astrometry tools.
Siril provides a few astrometry tools.


<!--T:36-->
In particular, the PSF function that uses the [https://en.wikipedia.org/wiki/Levenberg%E2%80%93Marquardt_algorithm Levenberg–Marquardt algorithm] for minimization. See the  
In particular, the PSF function that uses the [https://en.wikipedia.org/wiki/Levenberg%E2%80%93Marquardt_algorithm Levenberg–Marquardt algorithm] for minimization. See the  
[[Siril:PSF|dedicated page]] for a video tutorial.
[[Siril:PSF|dedicated page]] for a video tutorial.


</translate>
</translate>

Revision as of 13:56, 14 October 2014

Manual page for Siril

Siril is an astronomical image processing free software, see main page for more details.

A powerful astronomical image viewer

A Display Mode viewer is used to improve the visibility of an image, but without altering its pixel data in any way.

  • Linear: This is the default mode in Siril. Pixels are displayed from the darkest to the brightest in a linear scale.
  • Logarithm: Same than linear instead that here the scale is logarithmic. The operation emphase simultenaously information in faint and bright levels of the image.
  • Square root: This transformation, takes the square root of each pixels. The result is close to the logarithm mode.
  • Squared: Same than before but using the squared of each pixels.
  • Asinh: The inverse hyperbolic sine is the most commonly used, it reproduces the perceptual ability of the human eye, which can accommodate to perceive dramatically different levels of brightness simultaneously. Asinh is close to the logarithm mode but has a better behavior around zero.
  • Histogram: This mode increases the contrast of the image by increasing the dynamic range of intensity given to pixels with the most probable intensity values. It is very valuable to evaluate all the signal contained in the image.

All these modes can also be applied on each layer in an independent way.

This video tutorial shows the different modes you can use to display your images.

<html5media width="750">http://free-astro.vinvin.tf/videos/Display.webm</html5media>

In addition to this, Siril provides different colormap display:

Process your single images

Background extraction

When your image contains an intense light pollution, it is useful to remove it. Siril provides a "Background Extraction" tool in order to remove the gradient of the sky background. So far, Siril uses a polynomial method where generally 4th degree is a good choice. However, this tool allows you to choose between first and 4th degree.

After extraction you can switch between image and background view in order to check the result. If you are satisfied you can thus apply the correction (subraction or division). The subtraction operation is very different from the simple operation used for the darks and bias/offsets. Indeed, as the level of the background is identical to the one of the image, applying a simple subtraction would result in a image with a lot of black pixels. To avoid any inconvenience, the operation is done with 32bits signed integers and finally converted into native format (16-bits unsigned).

Following, respectively, the start image and final image (after background extraction with subtraction and equalization):

Color calibration

The color calibration tool performs a balancing of the colors of a linear RGB deep-sky image. This video tutorial shows how to use the tool. Note that Background Equalization (now called Background Neutralization) has been moved in the calibration box because it is needed before any calibration. This tool is in beta mode and should be use with caution.

<html5media width="750">http://free-astro.vinvin.tf/videos/Color_Calibration.webm</html5media>

Reducing green tint in processed images

This video tutorial shows how to remove the green tint in processed images using the graphical user interface. This function can also be accessed from the command line, with the rmgreen command.

<html5media width="750">http://free-astro.vinvin.tf/videos/RemoveGreen.webm</html5media>

Fast Fourier Transform (FFT)

A FFT algorithm is integrated to Siril in order to provide you a tool to evaluate fixed pattern noise of an image. You can thus remove the frequency pattern of the noise in the modulus file and save the result. Modulus and phase are saved in different files so you can compute the inverse transformation to retrieve the corrected image.

<html5media width="750">http://free-astro.vinvin.tf/videos/FFT.webm</html5media>

RGB Compositing

A new channel synthesis tool is provided in Siril. This tool allows you to mix and align up to 7 channels plus one for Luminance. The tool handles the binning, just make sure to not crop the picture before: the bin1x1 must ALWAYS be loaded first and the bin2x2 pictures must be four times as small (divided by a factor of two in each dimension).

The first video shows a mixing between L, R, G and B channels with same size and no alignments needed: the L channel is given by an H-alpha processed image. This second video shows mixing between images with different binning. The alignment is also required.

After mixing, save your result and process it as you want.

<html5media width="750">http://free-astro.vinvin.tf/videos/RGB_compositing.webm</html5media>

<html5media width="750">http://free-astro.vinvin.tf/videos/RGB_compositing2.webm</html5media>

Tutorial for a complete sequence processing

An illustrated tutorial has been compiled to describe the usual processing steps, starting from RAW DSLR images to stacking.

A video tutorial is also available to describe the usual planetary processing.

<html5media width="750">http://free-astro.vinvin.tf/videos/mars_processing.webm</html5media>

Astrometry

Siril provides a few astrometry tools.

In particular, the PSF function that uses the Levenberg–Marquardt algorithm for minimization. See the dedicated page for a video tutorial.