Correspondance (3D Analyst)

Disponible avec une licence Spatial Analyst.

Disponible avec une licence 3D Analyst.

Synthèse

Crée un raster par correspondance des valeurs d’un autre champ de la table du raster en entrée.

Illustration

Lookup_3d (InRas1, "Category", OutRas)

Utilisation

• Les champs de type numérique (nombre entier ou à virgule flottante) ou chaîne sont 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 de type entier, ses valeurs sont écrites en tant que valeurs dans la table attributaire du raster en sortie. Les autres éléments de la table attributaire du raster en entrée ne sont pas transférés vers la table attributaire du raster en sortie.

  Par exemple, la table attributaire d’un raster en entrée avec un champ numérique Attr1

      Value   Count   Attr1
      1       294     1
      2       345     8
      3       654     3

  Table attributaire en sortie de l’outil Correspondance sur le champ Attr1

      Value   Count
      1       294
      3       654
      8       345

• Si le champ de correspondance est de type chaîne, il apparaît dans la table attributaire du raster en sortie et le champ de valeur est de même type numérique que dans le raster en entrée. Les autres éléments de la table attributaire du raster en entrée ne sont pas transférés vers la table attributaire du raster en sortie.

  Par exemple, la table attributaire d’un raster en entrée avec un champ de 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

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Raster en entrée	Raster en entrée contenant un champ à partir duquel créer un nouveau raster.	Raster Layer
Champ de correspondance	Champ contenant les valeurs souhaitées du nouveau raster. Il peut s’agir d’un champ de type numérique ou chaîne.	Field
Raster en sortie	Raster en sortie dont les valeurs sont déterminées par le champ spécifié du raster en entrée.	Raster Dataset

Python

arcpy.ddd.Lookup(in_raster, lookup_field, out_raster)

Nom	Explication	Type de données
in_raster	Raster en entrée contenant un champ à partir duquel créer un nouveau 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
out_raster	Raster en sortie dont les valeurs sont déterminées par le champ spécifié du raster en entrée.	Raster Dataset

Exemple de code

Exemple 1 d’utilisation de la fonction Lookup (Fenêtre Python)

Cet exemple crée un nouveau raster déterminé par le champ spécifié du raster en entrée.

import arcpy
from arcpy import env  
env.workspace = "C:/data"
arcpy.Lookup_3d("mycity", "land_code", "C:/output/mylandcode.img")

Exemple 2 d’utilisation de la fonction Lookup (script autonome)

Cet exemple crée un nouveau raster déterminé par le champ spécifié du raster en entrée.

# Name: Lookup_3d_Ex_02.py
# Description: Creates a new raster by looking up values found in another 
#     field in the table of the input raster.
# Requirements: 3D Analyst Extension

# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
inRaster = "mycity"
lookupField = "land_code"
outRaster = "C:/output/mylandcode"

# Execute Lookup
arcpy.ddd.Lookup(inRaster, lookupField, outRaster)

Environnements

Validation automatique, Taille de cellule, Méthode de projection de la taille de cellule, Compression, Espace de travail courant, Étendue, 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 3D Analyst ou Spatial Analyst
• Standard: Nécessite 3D Analyst ou Spatial Analyst
• Advanced: Nécessite 3D Analyst ou Spatial Analyst