ArcMap

MNT vers raster

Résumé

Interpole un raster à l’aide des valeurs z d’un jeu de données de MNT.

Utilisation

  • Le paramètre de résolution indique quel niveau de pyramide du MNT utiliser pour la conversion. Les niveaux de pyramide sont définis à l’aide des types de pyramide de tolérance z ou de taille de fenêtre. Pour plus d’informations sur les pyramides de MNT, reportez-vous à la rubrique Pyramides de MNT.

  • Pour extraire un sous-ensemble du MNT, définissez l'étendue à l'aide des paramètres d'environnement de géotraitement.

  • Les options d’interpolation Linear (Linéaire) et Natural neighbor (Voisin naturel) s’appliquent sur toute la surface du MNT triangulée. L’option linéaire recherche le triangle englobant le centre de chaque cellule et applique une moyenne pondérée des nœuds du triangle afin d’interpoler une valeur. L’option Natural neighbors (Voisins naturels) applique aux voisins de Voronoï des poids basés sur la surface.

Syntaxe

TerrainToRaster(in_terrain, out_raster, {data_type}, {method}, {sample_distance}, {pyramid_level_resolution})
ParamètreExplicationType de données
in_terrain

Jeu de données de MNT à traiter.

Terrain Layer
out_raster

Nom et emplacement du raster en sortie. Pour enregistrer un jeu de données raster dans une géodatabase ou dans un dossier, tel qu’une grille Esri, vous ne devez ajouter aucune extension de fichier au nom du jeu de données raster. Une extension de fichier peut être fournie afin de définir le format du raster lorsque vous le stockez dans un dossier, par exemple .tif pour générer un GeoTIFF ou .img pour générer un fichier au format ERDAS IMAGINE.

Si le raster est stocké dans un fichier TIFF ou dans une géodatabase, la qualité et le type de compression raster peuvent être spécifiés à l'aide de paramètres d'environnement de géotraitement.

Raster Dataset
data_type
(Facultatif)

Spécifie le type de valeurs numériques stocké dans le raster en sortie.

  • FLOAT —Le raster en sortie utilisera la virgule flottante 32 bits, qui prend en charge les valeurs comprises entre -3,402823466e+38 et 3,402823466e+38. Il s’agit de l’option par défaut.
  • INT —Le raster en sortie utilisera une profondeur de couleur entière appropriée. Cette option arrondit les valeurs z au nombre entier le plus proche et écrit un entier dans chaque valeur de cellule raster.
String
method
(Facultatif)

Méthode d'interpolation qui sera utilisée pour calculer les valeurs de cellule.

  • LINEAR —Applique un poids basé sur la distance à la valeur Z de chaque nœud dans le triangle englobant le centre d’une cellule donnée, puis additionne les valeurs pondérées pour attribuer la valeur de cellule. Il s’agit de l’option par défaut.
  • NATURAL_NEIGHBORS —Applique une structure de pondération surfacique qui utilise les polygones de Voronoi pour déterminer les valeurs de cellule.
String
sample_distance
sampling_method distance
(Facultatif)

Méthode d'échantillonnage et distance utilisées pour définir la taille des cellules du raster en sortie.

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

Exemple 1 d'utilisation de l'outil TerrainToRaster (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.TerrainToRaster_3d("sample.gdb/featuredataset/terrain", "terrain.img", "INT", "LINEAR", "CELLSIZE 10", 2.5)
Exemple 2 d'utilisation de l'outil TerrainToRaster (script autonome)

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

'''*********************************************************************
Name: TerrainToRaster Example
Description: This script demonstrates how to use the 
             TerrainToRaster tool.
             
**********************************************************************'''
# Import system modules
import arcpy
from arcpy import env
import exceptions, sys, traceback

try:
    arcpy.CheckOutExtension("3D")
    # Set environment setting
    env.workspace = "C:/data"
    # Set Local Variables
    terrain = "sample.gdb/featuredataset/terrain"
    bitType = "INT"
    method = "LINEAR"
    sampling = "CELLSIZE 10"
    pyrLvl = 2.5
    outRas = arcpy.CreateUniqueName("terrain_level.img")    
    #Execute TerrainToRaster
    arcpy.ddd.TerrainToRaster(terrain, outRas, bitType, 
                              method, sampling, pyrLvl)
    arcpy.CheckInExtension("3D")
except arcpy.ExecuteError:
    print arcpy.GetMessages()
except:
    # Get the traceback object
    tb = sys.exc_info()[2]
    tbinfo = traceback.format_tb(tb)[0]
    # Concatenate error information into message string
    pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
          .format(tbinfo, str(sys.exc_info()[1]))
    msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
    # Return python error messages for script tool or Python Window
    arcpy.AddError(pymsg)
    arcpy.AddError(msgs)

Environnements

Informations de licence

  • Basic: Requiert 3D Analyst
  • Standard: Requiert 3D Analyst
  • Advanced: Requiert 3D Analyst

Rubriques connexes