Popularité (Outils Spatial Analyst)

Résumé

Détermine cellule par cellule dans une liste d’arguments la valeur possédant un niveau de popularité donné. Le niveau de popularité particulier (le nombre d'occurrences de chaque valeur) est spécifié par le premier argument.

Illustration

OutRas = Popularity(ValRas, [InRas1, InRas2, InRas3])

Utilisation

• The tool evaluates the number of occurrences of the input raster values for each location and ranks them on an ordinal scale—c’est-à-dire le plus populaire, le deuxième plus populaire, et ainsi de suite. 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 Cell Statistics (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 Process as multiband (Traiter comme multibande) n’est pas sélectionné (process_as_multiband défini sur SINGLE_BAND dans Python), seule la première bande d’un élément Input popularity raster or constant value (Raster de popularité ou valeur constante en entrée multibande) (in_popularity_raster_or_constant dans Python) est utilisée. Chaque bande d’un élément Input rasters (Rasters en entrée) multibande (in_rasters dans Python) est traité séparément en tant que raster monobande.

• Si le paramètre Process as multiband (Traiter comme multibande) est sélectionné (process_as_multiband est défini sur MULTI_BAND dans Python), chaque raster multibande en entrée est traité comme un raster multibande.

  Le nombre de bandes 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 éléments Input Rasters (Rasters en entrée) est un raster comportant un nombre de bandes inférieur à celui du raster en sortie, les bandes manquantes sont interprétées comme renseignées 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.

• Si toutes les entrées correspondent à des données raster multidimensionnelles avec le même nombre de variables, l’outil effectue l’opération pour toutes les tranches qui possèdent la même valeur de dimension. La sortie est un raster multidimensionnel au format CRF. Les variables des entrées doivent posséder au moins une dimension en commun et une valeur dimensionnelle en commun à traiter par cet outil, sinon, une erreur se produit.

  Si toutes les entrées comportent une variable, mais ont des noms différents, désactivez l’environnement de géotraitement Apparier la variable multidimensionnelle (définissez arcpy.env.matchMultidimensionalVariable = False dans Python) avant d’effectuer l’opération.

  Si l’une des entrées ou plusieurs d’entre elles correspondent à un raster multidimensionnel et que les autres entrées sont des constantes, l’outil procède à l’opération pour toutes les tranches de toutes les variables en utilisant la valeur constante, la sortie étant un raster multidimensionnel.

• Reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil.

Paramètres

• Dialog
• Python

Etiqueter	Explication	Type de données
Raster de popularité ou valeur constante en entrée	Raster en entrée qui définit la position de popularité à renvoyer. Un nombre peut être utilisé comme entrée. Toutefois, la taille de cellule et l'étendue doivent être définies en premier dans l'environnement.	Raster Layer; Constant
Rasters en entrée	Liste de rasters en entrée utilisée pour évaluer la popularité des valeurs pour chaque emplacement de cellule.	Raster Layer
Process as multiband (Traiter comme multicanal) (Facultatif)	Indique comment les bandes des rasters multibandes en entrée seront traitées. Activé—Chaque entrée de raster multibande sera traitée comme un raster multibande. L’opération est réalisée sur chaque bande depuis une entrée en utilisant le numéro de bande correspondant des autres entrées. Décoché—Chaque bande d’une entrée de raster multibandes sera traitée séparément comme un raster monobande. Il s’agit de l’option par défaut.	Boolean

Valeur de retour

Etiqueter	Explication	Type de données
Raster en sortie	Raster en sortie. Chaque cellule du raster en sortie représente la valeur du même emplacement dans les rasters en entrée correspondant à la valeur de popularité en entrée.	Raster

Environnements

Validation automatique, Taille de cellule, Cell Size Projection Method (Méthode de projection de la taille de cellule), Compression, Espace de travail courant, Etendue, Transformations géographiques, Masque, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Espace de travail temporaire, Raster de capture, Taille de tuile

Informations de licence

• Basic: Nécessite Spatial Analyst
• Standard: Nécessite Spatial Analyst
• Advanced: Nécessite Spatial Analyst

Rubriques connexes

• Vue d’ensemble du jeu d’outils Local
• Rechercher un outil de géotraitement
• Rechercher la valeur à partir d’une liste en entrée répondant à un critère spécifié
• Classement