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'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.

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.

Exemples

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

L'expression suivante :

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

produira un masque d'étoiles.

Ligne de commande Siril

pm "expression" [-rescale [low] [high]]

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

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.