ArcMap

De terreno a ráster

Resumen

Interpola un ráster usando los valores z de un dataset de terreno.

Uso

  • El parámetro de resolución indica qué nivel de la pirámide del terreno se va a utilizar para la conversión. Los niveles de pirámide se definen al utilizar los tipos de pirámide tolerancia z o tamaño de ventana. Para obtener más información sobre las pirámides de terreno, consulte Pirámides de terreno.

  • Para extraer un subconjunto del terreno, defina la extensión usando la configuración del entorno de geoprocesamiento.

  • Las opciones de interpolación Lineal y Vecino natural se aplican a través de la superficie triangulada del terreno. La opción lineal busca el triángulo que abarca cada centro de celda y aplica un promedio ponderado de los nodos del triángulo para interpolar un valor. La opción Vecinos naturales utiliza pesos basados en el área en los vecinos Voronoi.

Sintaxis

arcpy.ddd.TerrainToRaster(in_terrain, out_raster, {data_type}, {method}, {sample_distance}, {pyramid_level_resolution})
ParámetroExplicaciónTipo de datos
in_terrain

El dataset de terreno que se va a procesar.

Terrain Layer
out_raster

Ubicación y nombre del ráster de salida. Al almacenar un dataset ráster en una geodatabase o en una carpeta como una cuadrícula de Esri, no se debe adicionar extensión de archivo al nombre del dataset ráster. Se puede indicar una extensión de archivo para definir el formato del ráster al almacenarlo en una carpeta, como .tif para generar un GeoTIFF o .img para generar un archivo con el formato ERDAS IMAGINE.

Si el ráster se almacena como un archivo TIFF o en una geodatabase, su tipo de compresión de ráster y la calidad se pueden especificar utilizando la configuración del entorno de geoprocesamiento.

Raster Dataset
data_type
(Opcional)

Especifica el tipo de valores numéricos almacenados en el ráster de salida.

  • FLOAT —El ráster de salida utilizará una coma flotante de 32 bits, que admite valores que varían de -3,402823466e+38 a 3,402823466e+38. Esta es la opción predeterminada.
  • INT —El ráster de salida utilizará una profundidad de bit de enteros apropiada. Esta opción redondea los valores z al número entero más cercano y escribe el número entero en cada valor de celda ráster.
String
method
(Opcional)

Método de interpolación que se utilizará para calcular los valores de las celdas.

  • LINEAR —Aplica un peso basado en la distancia al valor Z de cada nodo del triángulo que abarca el centro de una celda dada y, a continuación, suma los valores ponderados para asignar el valor de celda. Esta es la opción predeterminada.
  • NATURAL_NEIGHBORS —Aplica un esquema de pesos basado en el área que utiliza polígonos Voronoi para determinar los valores de celda.
String
sample_distance
sampling_method distance
(Opcional)

El método de muestreo y distancia utilizados para definir el tamaño de celda del ráster de salida.

String
pyramid_level_resolution
(Opcional)

La tolerancia Z o la resolución del tamaño de la ventana del nivel de pirámide de terreno que utilizará esta herramienta. El valor predeterminado es 0, o resolución completa.

Double

Muestra de código

Ejemplo 1 de TerrainToRaster (ventana de Python)

En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de 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)
Ejemplo 2 de TerrainToRaster (script independiente)

En el siguiente ejemplo se muestra cómo usar esta herramienta en un script independiente de Python.

'''*********************************************************************
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)

Entornos

Información de licenciamiento

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

Temas relacionados