L'outil évalue le nombre d'occurrences des valeurs de raster en entrée pour chaque emplacement et les classe sur une échelle ordinale : à savoir, le plus populaire, le deuxième plus populaire, etc. Il retourne la valeur de la n-ième valeur plus populaire spécifiée, définie par la valeur du raster de popularité.
Dans la liste des rasters en entrée, l'ordre n'a aucune importance. Toutefois, le raster définissant la position de popularité doit précéder ces rasters.
Un nombre arbitraire de rasters peut être spécifié dans la liste des rasters en entrée.
Si les valeurs en entrée sont les mêmes pour tout emplacement de cellule, quelle que soit la popularité spécifiée, la valeur en sortie est la même que l'entrée pour cet emplacement de cellule.
Si un emplacement de cellule contient la valeur NoData dans l'un quelconque des rasters en entrée, l'emplacement se voit attribuer la valeur NoData pour la sortie.
Si aucune valeur individuelle n’est trouvée comme nième valeur la plus populaire, la valeur NoData est affectée à l’emplacement dans le raster en sortie. Cette situation survient lorsque toutes les valeurs de raster en entrée à un emplacement sont différentes ou lorsque deux valeurs de raster en entrée ou plus ont le même nombre d'occurrences et que ce nombre correspond à la n-ième valeur la plus populaire. Retourner l'une des valeurs de raster en entrée, telle que la première valeur détectée dans le processus d'analyse, serait trompeur. Vous ne sauriez pas si la valeur est véritablement la nième valeur la plus populaire.
Si la valeur de popularité est supérieure au nombre de rasters en entrée, la valeur NoData est affectée à chaque emplacement de cellule dans la sortie.
Si la valeur 0 est spécifiée comme valeur de popularité, la valeur en sortie est NoData.
Un niveau de popularité de 1 correspond à la valeur de majorité, similaire à l'option Majorité de l'outil Statistiques de cellule.
Si un ou plusieurs des rasters en entrée sont à virgule flottante, la sortie est à virgule flottante. Sinon, la sortie est un entier.
Si le paramètre Traiter comme multicanal n’est pas sélectionné (process_as_multiband défini sur SINGLE_BAND dans Python), seul le premier canal d’un Raster de popularité ou valeur constante en entrée multicanal (in_popularity_raster_or_constant dans Python) est utilisé. Chaque canal d’un Raster en entrée multicanal (in_rasters dans Python) est traité séparément en tant que raster monocanal.
Si le paramètre Traiter comme multicanal est coché (process_as_multiband défini sur MULTI_BAND dans Python), chaque raster multicanal en entrée est traité comme un raster multicanal.
Le nombre de canaux dans la sortie dépend du paramètre Input popularity raster or constant value (Raster de popularité ou valeur constante en entrée). Si le raster de popularité est un canal unique, le nombre de canaux du raster en sortie est identique au nombre maximal de canaux de tous les rasters multicanaux des rasters en entrée. Si le raster de popularité est multicanal, le raster en sortie comporte le même nombre de canaux que le raster de popularité.
Si l’un des rasters en entrée est un raster comportant un nombre de canaux inférieur à celui du raster en sortie, les canaux manquants sont interprétés comme remplis de valeurs NoData. Si la valeur de cellule du raster de popularité extrait la valeur un du canal manquant, le raster en sortie reçoit la valeur NoData. Si l’un des rasters en entrée est une constante, il est interprété en tant que raster multicanal, dans lequel les valeurs de cellule de tous les canaux sont identiques à la constante et possèdent le même nombre de canaux que le raster en sortie.
Dans ArcPy, si les toutes les entrées sont des rasters multidimensionnels comportant le même nombre de variables, l’outil effectue l’opération pour toutes les tranches dotées de la même valeur de dimension ; la sortie obtenue est un raster multidimensionnel. Les variables des entrées doivent avoir les mêmes dimensions ou des dimensions communes.
Si toutes les entrées sont des rasters multidimensionnels possèdent une variable mais ont des noms différents, définissez l’environnement de géotraitement matchMultidimensionalVariable sur False pour effectuer l’opération.
Dans ArcPy, si une ou plusieurs entrées correspondent à un raster multidimensionnel et qu’une autre entrée est une constante, l’outil effectue l’opération pour toutes les tranches de toutes les variables à l’aide de la valeur constante et la sortie est un raster multidimensionnel.
Pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil, reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst.
