Disponible avec une licence Spatial Analyst.
Résumé
Crée un nouveau raster par correspondance des valeurs trouvées dans un autre champ de la table du raster en entrée.
Illustration
Utilisation
Les types de champ numérique (entier ou à virgule flottante) ou chaîne sont tous les deux pris en charge. S'il s'agit d'un champ de type entier ou chaîne, la sortie est un raster de type entier. Sinon, le raster en sortie est à virgule flottante.
Si le champ de correspondance est un entier, ses valeurs sont écrites en tant que valeur dans la table attributaire du raster en sortie. Les autres éléments de la table attributaire de raster en entrée ne sont pas transférés vers la table attributaire de raster en sortie.
Par exemple, une table attributaire de raster en entrée avec le champ numérique Attr1
Value Count Attr1 1 294 1 2 345 8 3 654 3
Table attributaire en sortie de Correspondance sur le champ Attr1
Value Count 1 294 3 654 8 345
Si le champ de correspondance est une chaîne, le champ de correspondance apparaît dans la table attributaire du raster en sortie et le champ de valeur est de même type numérique que le raster en entrée. Les autres éléments de la table attributaire de raster en entrée ne sont pas transférés vers la table attributaire de raster en sortie.
Par exemple, imaginez la table attributaire d'un raster en entrée avec le champ de type chaîne Text1
Value Count Attr1 Text1 1 294 1 A 2 6218 8 B 3 28 3 4 3603 9 3
La table attributaire du raster en sortie résultant de l'exécution de l'outil Correspondance sur le champ Text1 serait
Value Count Text1 1 294 A 2 6218 B 3 28 4 3603 3
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
Lookup (in_raster, lookup_field)
Paramètre | Explication | Type de données |
in_raster | Le raster en entrée contenant un champ à partir duquel vous voulez créer un raster. | Raster Layer |
lookup_field | Champ contenant les valeurs souhaitées du nouveau raster. Il peut s'agir d'un champ de type numérique ou chaîne. | Field |
Valeur renvoyée
Nom | Explication | Type de données |
out_raster |
Raster en sortie dont les valeurs sont déterminées par le champ spécifié du raster en entrée. | Raster |
Exemple de code
1er exemple d'utilisation de l'outil Correspondance (fenêtre Python)
Cet exemple crée un raster déterminé par le champ spécifié du raster en entrée.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRaster = Lookup("mycity","land_code")
outRaster.save("C:/sapyexamples/output/mylandcode.img")
2e exemple d'utilisation de l'outil Correspondance (script autonome)
Cet exemple crée un raster déterminé par le champ spécifié du raster en entrée.
# Name: lookup_example02.py
# Description: Creates a new raster by looking up values found in another
# field in the table of the input 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
inRaster = "mycity"
lookupField = "land_code"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Lookup
outRaster = Lookup(inRaster, lookupField)
# Save the output
outRaster.save("C:/sapyexamples/output/mylandcode")
Environnements
Informations de licence
- ArcGIS Desktop Basic: Requiert Spatial Analyst ou 3D Analyst
- ArcGIS Desktop Standard: Requiert Spatial Analyst ou 3D Analyst
- ArcGIS Desktop Advanced: Requiert Spatial Analyst ou 3D Analyst