Exposition de surface—Aide | ArcGIS for Desktop

Récapitulatif
Illustration
Utilisation
Syntaxe
Exemple de code
Environnements
Informations de licence

Récapitulatif

Crée des entités surfaciques qui représentent les mesures d'exposition découlant d'une surface du jeu de données TIN, de MNT ou LAS.

Illustration

Utilisation

L'exposition représente l'orientation horizontale d'une surface et est définie en unités de degrés. Une valeur de code représentant la direction cardinale ou ordinale de sa pente est attribuée à chaque facette de la surface. Les surfaces contiguës portant le même code sont combinées en une seule entité. Le jeu de classification par défaut est défini comme suit :

Code	Direction de pente	Plage d'angle de pente
-1	Plat standard	Pas de pente
1	Nord	0° – 22.5°
2	Nord-Est	22.5° – 67.5°
3	Est	67.5° – 112.5°
4	Sud-Est	112.5° – 157.5°
5	Sud	157.5° – 202.5°
6	Sud-Ouest	202.5° – 247.5°
7	Ouest	247.5° – 292.5°
8	Nord-Ouest	292.5° – 337.5°
9	Nord	337.5° – 360°

Il est possible de spécifier des définitions de classe personnalisées via une Table de bornes de classes. La table doit comporter deux colonnes dont la première indique le point de rupture d'exposition en degrés et la seconde définit sa valeur de code. Prenons l'exemple suivant :
Interruption Aspect_Code
90.0
1
180.0
2
270.0
3
360.0
4
La table peut être enregistrée dans n'importe quel format pris en charge (.dbf, .txt ou une table de géodatabase). Les noms des champs n'ont pas d'importance, étant donné que le premier sera toujours utilisé pour les bornes de classe et le second pour les codes d'exposition.

Interruption	Aspect_Code
90.0	1
180.0	2
270.0	3
360.0	4

Syntaxe

SurfaceAspect_3d (in_surface, out_feature_class, {class_breaks_table}, {aspect_field}, {pyramid_level_resolution})

Paramètre	Explication	Type de données
in_surface	Surface du jeu de données TIN, de MNT ou LAS à traiter.	LAS Dataset Layer; Terrain Layer; TIN Layer
out_feature_class	Classe d'entités qui va être produite par cet outil.	Feature Class
class_breaks_table (Facultatif)	Table contenant les bornes utilisées pour définir les plages d'exposition dans la classe d'entités en sortie.	Table
aspect_field (Facultatif)	Champ contenant les valeurs de code d'exposition.	String
pyramid_level_resolution (Facultatif)	Résolution de taille de fenêtre ou de tolérance z du niveau de pyramide de MNT qui sera utilisée par cet outil. La valeur par défaut est 0 (ou résolution maximale).	Double

Exemple de code

1er exemple d'utilisation de l'outil SurfaceAspect (fenêtre Python)

L'exemple suivant illustre l'utilisation de cet outil dans la fenêtre Python.

import arcpy
from arcpy import env

arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.SurfaceAspect_3d("sample.gdb/featuredataset/terrain", "sample.gdb/featuredataset/terrain_aspect")

2e exemple d'utilisation de l'outil SurfaceAspect (script autonome)

L'exemple suivant illustre l'utilisation de cet outil dans un script Python autonome.

'''****************************************************************************
Name: SurfaceAspect Example
Description: This script demonstrates how to use the 
             SurfaceAspect and SurfaceSlope tools to generate a polygon
             that contains the intersection of both 
****************************************************************************'''

# Import system modules
import arcpy
from arcpy import env

# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")

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

try:
    # List all TINs in workspace
    listTINs = arcpy.ListDatasets("","TIN")
    # Determine whether the list contains any TINs
    if len(listTINs) > 0:
        for dataset in listTINs:
            print dataset
            # Set Local Variables
            aspect = arcpy.CreateUniqueName("Aspect.shp")
            slope = arcpy.CreateUniqueName("Slope.shp")
            outFC = dataset + "_Aspect_Slope.shp"
            #Execute SurfaceAspect
            arcpy.SurfaceAspect_3d(dataset, aspect)
            #Execute SurfaceSlope
            arcpy.SurfaceSlope_3d(dataset, slope)
            #Execute SurfaceSlope
            print "Starting Intersect"
            arcpy.Intersect_analysis(aspect + " #;" + slope + " #", outFC, "ALL")
            print "Completed intersect for " + dataset
            del aspect, slope, outFC
    else:
        print "There are no TINs in the " + env.workspace + " directory."
except:
    # Returns any other error messages
    print arcpy.GetMessages(2)

del arcpy, listTINs