Fonction ArgStatistics

Aperçu

La fonction ArgStatistics calcule les arguments des statistiques. Quatre méthodes composent la fonction ArgStatistics : ArgMax, ArgMin, ArgMedian et Duration.

Remarques

Dans ArgStatistics, tous les canaux de raster provenant de chaque raster en entrée se voient attribuer un index de canal incrémentiel de base 0, qui est classé d’abord selon l’index de raster en entrée, comme illustré dans le tableau ci-après, puis selon l’ordre relatif des canaux dans chaque raster en entrée. Par exemple, si le premier raster en entrée (index en entrée 0) possède 2 canaux, b11 et b12, et que le deuxième raster en entrée (index en entrée 1) possède 4 canaux : b21, b22, b23 et b24, l'index de canal ressemble au tableau suivant :

Bande	Index en entrée	Index de bande
b11	0	0
b12	0	1
b21	1	2
b22	1	3
b23	1	4
b24	1	5

Puis, pour chaque pixel, la fonction ArgMax retourne le Band index correspondant à la Pixel value maximale. Par exemple, dans le tableau suivant, la valeur de pixel maximale est de 189, qui est stockée dans Band b21, avec le band index 2. Ainsi, la fonction ArgMax retourne la valeur 2.

Bande	Index de bande	Valeur du pixel
b11	0	33
b12	1	54
b21	2	189
b22	3	145
b23	4	34
b24	5	28

ArgMin est l’argument du minimum, qui retourne Band index pour lequel le pixel donné atteint sa valeur minimale. Par exemple, dans le tableau précédent, la valeur Pixel value minimale est 28, stockée dans le canal Band b24, où Band index est 5. Ainsi, la fonction ArgMin retourne la valeur 5.

La méthode ArgMedian retourne Band index pour lequel le pixel donné atteint la valeur médiane des valeurs provenant de tous les canaux. Envisagez les valeurs provenant de tous les canaux comme un tableau. Une fois le tableau trié par ordre croissant, la médiane est la valeur séparant la moitié inférieure du tableau de la moitié supérieure. Plus précisément, si le tableau trié par ordre croissant contient n valeurs, la médiane est la n^ème (base 0) valeur, où :

i = ( (n-1) / 2 )

Par exemple, le tableau précédent est trié par ordre croissant par valeurs de pixel, comme illustré dans l'exemple suivant : La médiane est 34 et ArgMedian retourne un Band index de 4.

Bande	Index de bande	Valeur du pixel
b24	5	28
b11	0	33
b23	4	34
b12	1	54
b22	3	145
b21	2	189

La méthode Duration trouve les éléments consécutifs les plus longs de la matrice, où chaque élément possède une valeur supérieure ou égale à Min et inférieure ou égale à Max, puis retourne sa longueur. La méthode Duration a besoin des valeurs en entrée Min et Max.

Par exemple, dans le tableau précédent, les éléments consécutifs les plus longs donnés pour Min=34 et Max=189 est [34, 54, 145, 189], la durée est alors 4.

Paramètres

Paramètre	Description
Method (Méthode)	Sélectionnez la méthode de statistiques pour calculer ce qui suit : Arg Max : argument du maximum, qui retourne le Band index pour lequel le pixel donné atteint sa valeur minimale provenant de tous les canaux. Toutes les bandes raster provenant de chaque raster en entrée se voient attribuer un index de canal incrémentiel de base 0, qui est classé d’abord selon l’index de raster en entrée, puis selon l’ordre relatif des bandes dans chaque raster en entrée. Arg Min : argument du minimum, qui retourne le Band index pour lequel le pixel donné atteint sa valeur minimale provenant de tous les canaux. Arg Median : argument de la médiane, qui retourne le Band index pour lequel le pixel donné atteint la valeur médiane des valeurs provenant de tous les canaux. Duration : la méthode Duration trouve les éléments consécutifs les plus longs de la matrice, où chaque élément possède une valeur supérieure ou égale à Min et inférieure ou égale à Max, puis retourne sa longueur.
Undefined Class (Classe non définie)	Constante en entrée qui sera retournée si aucune valeur maximum, minimale ou médiane ne peut être atteinte. Le scénario le plus courant se produit lorsque la valeur maximale ou minimale survient plusieurs fois parmi les valeurs de toutes les bandes. La valeur par défaut du champ de la constante non définie est 100. La classe non définie concerne uniquement les cas dans lesquels la méthode est ArgMax, ArgMin ou ArgMedian.
Min	La valeur minimale que vous définissez est la valeur la plus basse supérieure ou égale au début de la durée. Cette entrée s’applique uniquement dans le cas de la méthode Durée.
Max	La valeur maximale que vous définissez est la valeur la plus haute inférieure ou égale à la fin de la durée. Cette entrée s’applique uniquement dans le cas de la méthode Durée.
Raster en entrée	Raster en entrée sur lequel vous allez exécuter les différents méthodes statistiques.
Index	Il existe deux types d’index dans cette fonction : un index de raster et un index de canal. L'index en entrée assure le suivi de chaque raster en entrée ; à chaque ligne ayant le même index en entrée correspond le même raster. Un raster pouvant avoir plusieurs canaux, plusieurs lignes peuvent être présentes dans le même index de raster. L'index de canal assure le suivi de chaque canal en entrée. Chaque index de canal est unique et ne peut pas avoir de doublons.

Paramètre	Description
Rasters	Rasters en entrée sur lesquels vous allez exécuter les différentes méthodes statistiques.
Method (Méthode)	Sélectionnez la méthode de statistiques pour calculer ce qui suit : Arg Max : argument du maximum, qui retourne le Band index pour lequel le pixel donné atteint sa valeur minimale provenant de tous les canaux. Toutes les bandes raster provenant de chaque raster en entrée se voient attribuer un index de canal incrémentiel de base 0, qui est classé d’abord selon l’index de raster en entrée, puis selon l’ordre relatif des bandes dans chaque raster en entrée. Arg Min : argument du minimum, qui retourne le Band index pour lequel le pixel donné atteint sa valeur minimale provenant de tous les canaux. Arg Median : argument de la médiane, qui retourne le Band index pour lequel le pixel donné atteint la valeur médiane des valeurs provenant de tous les canaux. Duration : la méthode Duration trouve les éléments consécutifs les plus longs de la matrice, où chaque élément possède une valeur supérieure ou égale à Min et inférieure ou égale à Max, puis retourne sa longueur.
Undefined Class (Classe non définie)	Constante en entrée qui sera retournée si aucune valeur maximum, minimale ou médiane ne peut être atteinte. Le scénario le plus courant se produit lorsque la valeur maximale ou minimale survient plusieurs fois parmi les valeurs de toutes les bandes. La valeur par défaut du champ de la constante non définie est 100. La classe non définie concerne uniquement les cas dans lesquels la méthode est ArgMax, ArgMin ou ArgMedian.
Min	La valeur minimale que vous définissez est la valeur la plus basse supérieure ou égale au début de la durée. Cette entrée s’applique uniquement dans le cas de la méthode Durée.
Max	La valeur maximale que vous définissez est la valeur la plus haute inférieure ou égale à la fin de la durée. Cette entrée s’applique uniquement dans le cas de la méthode Durée.
Ignorer NoData dans les calculs	Indique si les valeurs NoData sont ignorées dans le calcul de statistiques. Activé : l’analyse inclut tous les pixels valides dans les rasters en entrée et ignore les pixels NoData. Désactivé : le résultat de l’analyse est NoData si les pixels ne présentent des valeurs NoData dans les rasters en entrée. Il s’agit de l’option par défaut.