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.

La boîte de dialogue Pixel Math est illustrée à l'ouverture
La fenêtre est divisée en 5 parties.
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.
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.
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'expressionfactor =0.8, K=0.2
, toutes les occurrences defactor
etK
dans la formule ci-dessus seront remplacées par 0.8 et 0.2 respectivement. La formuleHa * factor + OIII * K
sera donc évaluée àHa * 0.8 + OIII * 0.2
.Partie paramètres de la boite de dialogue Pixel Math
La partie sortie est réservé à la mise à l'échelle de l'image dans un intervalle donné. Il est nécessaire de développer la partie avant de l'utiliser.
Partie mise à l'échelle de la boite de dialogue Pixel Math
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.
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.

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.

Image d'origine.
L'expression suivante :
iif(Image>med(Image)+3*noise(Image), 1, 0)
produira un masque d'étoiles.

Après la formule ci-dessus.
Ligne de commande Siril
pm "expression" [-rescale [low] [high]]
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 |
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. |
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é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. |