Pixel Math

L'un des outils les plus puissants de Siril est Pixel Math. Il vous permet de manipuler les pixels des images à l'aide de fonctions mathématiques. De la simple addition ou soustraction à des fonctions plus avancées, comme la MTF, Pixel Math est un outil parfait pour le traitement des images astronomiques.

Cette page a pour but de décrire entièrement l'outil, pour voir des exemples détaillés, veuillez vous référer à l'excellent tutoriel sur le site.

dialogue

La boîte de dialogue Pixel Math est illustrée à l'ouverture

La fenêtre est divisée en 5 parties.

  1. La première, comprenant 3 zones de texte recevant les formules mathématiques. Seule la première est utilisée si vous souhaitez produire une image monochrome. Décochez le bouton Utiliser une seule expression RVB/K pour produire une sortie RVB.

  2. La seconde est la zone des variables avec la sélection des Functions et des Operators. Chaque variable est une image qui doit être chargée au préalable avec le bouton +. Vous pouvez cliquer sur la fonction et/ou l'opérateur souhaité pour le faire apparaître dans la saisie de la formule.

  3. Le troisième, le champ paramètres, permet à l'utilisateur de définir des paramètres séparés par ,. Par exemple, si vous définissez des paramètres avec l'expression factor =0.8, K=0.2, toutes les occurrences de factor et K dans la formule ci-dessus seront remplacées par 0.8 et 0.2 respectivement. La formule Ha * factor + OIII * K sera donc évaluée à Ha * 0.8 + OIII * 0.2.

    dialogue

    Partie paramètres de la boite de dialogue Pixel Math

  4. Le champ output est réservé à la mise à l'échelle de l'image dans une plage donnée et à l'activation ou non de l'option Additionner les temps d'exposition. Cette dernière option permet à l'utilisateur d'additionner ou non les temps d'exposition des images individuelles, en stockant le résultat dans l'en-tête FITS. Il est nécessaire de développer le cadre avant de l'utiliser.

    dialogue

    Partie mise à l'échelle de la boite de dialogue Pixel Math

  5. Enfin, la zone préréglages permet à l'utilisateur de réutiliser des formules précédemment sauvegardées à l'aide du bouton situé à droite des zones de formule. Il est nécessaire de développer le cadre avant de l'utiliser. Double-cliquez sur la formule pour la copier dans la bonne entrée.

    dialogue

    Préréglages Pixel Math

Utilisation

Nom des variables

Par défaut, il est possible de charger 10 images simultanément. Chaque image reçoit un nom de variable commençant par I suivi d'un nombre de 1 à 10. Cependant, si l'image chargée contient le mot-clé FILTER, alors la valeur de ce dernier devient le nom de la variable par défaut. Bien entendu, il est toujours possible de le modifier en double-cliquant dessus.

dialogue

Il est possible de changer le nom de la variable.

Exemples

Prenons une image monochrome de galaxies. Il s'agit d'une image linéaire vue avec le mode d'affichage Auto ajustement.

dialogue

Image d'origine.

L'expression suivante :

iif(Image>med(Image)+3*noise(Image), 1, 0)

produira un masque d'étoiles.

dialogue

Après la formule ci-dessus.

Ligne de commande Siril

pm "expression" [-rescale [low] [high]] [-nosum]
Cette commande évalue l'expression donnée en argument comme dans l'outil PixelMath. L'expression complète doit être entre guillemets et les variables (qui sont des noms d'images, sans extension, situés dans le répertoire de travail dans ce cas) doivent être entourées du symbole $, par exemple "$image1$ * 0.5 + $image2$ * 0.5". Un maximum de 10 images peut être utilisé dans l'expression.
L'image peut être redimensionnée avec l'option -rescale suivie des valeurs low et high dans l'intervalle [0, 1]. Si aucune valeur basse ou haute n'est fournie, les valeurs par défaut sont 0 et 1. Un autre argument optionnel, -nosum, indique à Siril de ne pas additionner les temps d'exposition. Cela a un impact sur les mots-clés FITS tels que LIVETIME et STACKCNT

Fonctions

Il y a deux type de fonctions. Celles qui s'appliquent directement sur les pixels et celles qui s'appliquent sur l'image entière (comme les fonctions statistiques).

Fonction orientée sur les pixels

Fonction

Cas d'utilisation

Définition

abs

abs ( x )

Valeur absolue de x.

acos

acos ( x )

Arc cosinus de x.

acosh

acosh ( x )

Arc cosinus hyperbolique de x.

asin

asin ( x )

Arc sinus de x.

asinh

asinh ( x )

Arc sinus hyperbolique de x.

atan

atan ( x )

Arc tangente de x.

atan2

atan2 ( y, x )

Arc tangente de y/x.

atanh

atanh ( x )

Arc tangente hyperbolique de x.

ceil

ceil ( x )

Arrondi x à l'entier supérieur.

cos

cos ( x )

Cosinus de x.

cosh

cosh ( x )

Cosinus hyperbolique de x.

e

e

La constante e=2.718282...

exp

exp ( x )

Fonction exponentielle.

fac

fac( x )

Fonction factorielle.

iif

iif( cond, expr_true, expr_false )

Fonction conditionnelle (ou fonction if inline).
Retourne expr_true si cond a une valeur non nulle.
Retourne expr_false si cond est égale à zéro.

floor

floor ( x )

Plus grand entier inférieur ou égal à x.

ln

ln ( x )

Logarithme népérien de x.

log

log ( x )

Logarithme base 10 de x.

log10

log10 ( x )

Logarithme base 10 de x.

log2

log2 ( x )

Logarithme en base 2 de x.

max

max (x,y)

Fonction maximum.

min

min (x,y)

Fonction minimum.

mtf

mtf ( m, x )

Fonction de transfert des demi-tons (MTF) de x pour un paramètre d'équilibre des demi-tons m dans la plage [0, 1].

ncr

ncr ( x, y )

Fonction de combinaisons.

npr

npr ( x, y )

Fonction permutation.

pi

pi

La constante π=3.141592...

pow

pow ( x, y )

Fonction exponentielle.

sign

sign (x)

Sign de x :
\(+1\) si \(x > 0\)
\(−1\) si \(x < 0\)
\(\;0\) si \(x = 0\).

sin

sin (x)

Sinus de x.

sinh

sinh ( x )

Sinus hyperbolique de x.

sqrt

sqrt (x)

Racine carrée de x.

tan

tan ( x )

Tangente de x.

tanh

tanh ( x )

Tangente hyperbolique de x.

trunc

trunc ( x )

Partie entière tronquée de x.

Fonctions statistiques

Fonction

Cas d'utilisation

Définition

adev

adev ( Image )

Déviation moyenne absolue de l'image.

bwmv

bwmv ( Image )

Moyenne pondérée de l'image.

height

height ( Image )

Hauteur en pixels de l'image spécifiée.

mad

mad ( Image )

Écart absolu médian de l'image. L'utilisation de mdev est également possible.

max

max ( Image )

Maximum d'un pixel de l'image.

mean

mean ( Image )

Moyenne de l'image.

med

med ( Image )

Médiane de l'image. L'utilisation de median est également possible.

min

min ( Image )

Minimum d'un pixel de l'image.

noise

noise ( Image )

Estimation du bruit Gaussien dans l'image.

sdev

sdev ( Image )

Déviation standard de l'image.

width

width ( Image )

Largeur en pixel d'une image spécifiée.

Opérateurs

Opérateurs

Opérateur

Cas d'utilisation

Définition

~

~x

Opérateur d'inversion des pixels.

-

-x

Opérateur unaire Moins (changement de signe).

+

+x

Opérateur unaire Plus.

!

!x

Opérateur logique NOT.

^

x ^ y

Opérateur d'exponentielle.

*

x * y

Opérateur de multiplication.

/

x / y

Opérateur de division.

%

x % y

Opérateur modulo.

+

x + y

Opérateur d'addition.

-

x - y

Opérateur de soustraction.

<

x < y

Opérateur relationnel Plus Petit.

<=

x <= y

Opérateur relationnel inférieur ou égal.

>

x > y

Opérateur relationnel Plus Grand.

>=

x >= y

Opérateur relationnel plus grand que ou égal.

==

x == y

Opérateur relationnel Égal À.

!=

x != y

Opérateur relationnel N'est Pas Égal À.

&&

x && y

Opérateur logique AND.

||

x || y

Opérateur logique OR.