ArcMap

Classement

Disponible avec une licence Spatial Analyst.

Résumé

Les valeurs du jeu de rasters en entrée sont classées cellule par cellule, et celle qui est renvoyée est déterminée par la valeur du raster de classement en entrée.

Illustration

Illustration de l'outil Classement
OutRas = Rank(ConstRas, [InRas1, InRas2, InRas3])

Utilisation

  • Dans la liste des rasters en entrée, l'ordre n'a aucune importance. Toutefois, le raster de classement en entrée doit les précéder.

  • Un nombre arbitraire de rasters peut être spécifié dans la liste des rasters en entrée.

  • Lorsqu’un raster multicanal est spécifié comme raster de classement ou valeur constante en entrée (Input rank raster or constant value) (in_rank_raster_or_constant dans Python), seul le premier canal est utilisé dans l’opération. Pour traiter un autre canal, spécifiez le canal souhaité.

  • Lorsqu’un raster multicanal est spécifié comme l’un des rasters en entrée (Input rasters) (in_rasters dans Python), tous les canaux sont utilisés.

    Pour traiter une sélection de canaux à partir d’un raster multicanal, vous pouvez créer en premier un jeu de données raster composé de ces canaux spécifiques à l’aide de l’outil Canaux composites et utilisez le résultat dans la liste des rasters en entrée (Input rasters) (in_rasters dans Python).

  • 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 toutes les valeurs en entrée correspondent à une seule et même valeur pour tout emplacement de cellule, quelle que soit le classement spécifié, la valeur en sortie est égale à cette valeur pour cet emplacement de cellule.

  • Si la valeur de classement est supérieure au nombre de rasters en entrée, la valeur NoData est affectée à chaque emplacement de cellule en sortie.

  • Si un ou plusieurs des rasters en entrée sont à virgule flottante, la sortie est à virgule flottante. Sinon, la sortie est un entier.

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

Syntaxe

Rank(in_rank_raster_or_constant, in_rasters)
ParamètreExplicationType de données
in_rank_raster_or_constant

Raster en entrée qui définit la position de classement à 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
in_rasters
[in_raster,...]

Liste des rasters en entrée.

L'entrée définit la liste d'arguments destinée à identifier la valeur du classement, définie par le premier argument pour chaque emplacement de cellule.

Raster Layer

Valeur renvoyée

NomExplicationType de données
out_raster

Raster en sortie.

Pour chaque cellule dans le raster en sortie, les valeurs des rasters en entrée sont triées en ordre croissant et la valeur du raster de classement en entrée permet de sélectionner celle qui sera la valeur en sortie.

Raster

Exemple de code

Exemple 1 d'utilisation de l'outil Rank (fenêtre Python)

Cet exemple effectue une opération de classement sur plusieurs rasters Grid en entrée et génère le résultat sous la forme d'un raster TIFF.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRank = Rank("cost", ["degs", "negs", "fourgrd"])
outRank.save("C:/sapyexamples/output/outrank.tif")
Exemple 2 d'utilisation de l'outil Rank (script autonome)

Cet exemple effectue une opération de classement sur plusieurs rasters Grid en entrée et génère le résultat sous la forme d'un raster Grid.

# Name: Rank_Ex_02.py
# Description: Returns the value of a set of rasters based on
#              a rank level specified by another raster 
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRankRaster = "cost"
inRaster01 = "degs"
inRaster02 = "negs"
inRaster03 = "fourgrd"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute Rank
outRank = Rank(inRankRaster, [inRaster01, inRaster02, inRaster03])

# Save the output 
outRank.save("C:/sapyexamples/output/outrank")

Environnements

Informations de licence

  • Basic: Requiert Spatial Analyst
  • Standard: Requiert Spatial Analyst
  • Advanced: Requiert Spatial Analyst

Rubriques connexes