De ráster a multipunto (3D Analyst)
Resumen
Convierte los centros de la celda ráster en entidades multipunto cuyos valores Z reflejan el valor de la celda ráster.
Uso
Esta herramienta se usa para los datasets ráster que modelan las propiedades de superficie, como elevación.
-
Esta herramienta es útil para incorporar un DEM de ráster en puntos que pueden utilizarse como datos secundarios para crear un dataset de terreno o TIN.
Se pueden convertir todos los centros de las celdas, con la opción NO_THIN, o puede aplicarse uno de varios filtros para excluir aquellas celdas que son menos significativas. Las opciones de simplificación incluyen ZTOLERANCE, KERNEL y VIP.
- El método de simplificación ZTOLERANCE representa la diferencia máxima permitida (en unidades z) entre la altura del ráster de entrada y la altura de la clase de entidad multipunto de salida. Por defecto, la tolerancia Z es 1/10 del rango de z del ráster de entrada. Mientras más grande sea la tolerancia, mayor será la simplificación y menor la salida de puntos.
- El método de simplificación KERNEL define la cantidad de celdas para una ventana. El valor predeterminado es 3, que se traduce en un conjunto de celdas de 3 por 3 en el ráster de entrada. Se evalúan los valores de las celdas individuales en cada una de estas ventanas. Entonces se eligen una o dos celdas, según el método de selección KERNEL. Mientras más grande sea el tamaño de kernel, se realizará una mayor simplificación y se generarán menos puntos.
- El método VIP se utiliza para seleccionar un porcentaje de puntos desde el ráster de entrada basado en su importancia. La importancia se evalúa mediante una ventana de colector de datos de 3 por 3. Puede elegir la opción VIP_HISTOGRAM para escribir una tabla a fin de ver los valores de importancia reales y la correspondiente cantidad de puntos asociados con esos valores.
-
Utilice el método de simplificación ZTOLERANCE cuando sea importante conservar la exactitud vertical. Utilice el método de simplificación KERNEL cuando sea importante controlar la distancia de muestra horizontal.
-
Considere aplicar un método de simplificación cuando realice la conversión de ráster a multipuntos. Existen dos métodos de simplificación utilizados para generar una clase de entidad multipunto nueva: ZTOLERANCE y KERNEL. Si se selecciona NO_THIN, los datos de resolución completa generarán como salida una clase de entidad multipunto nueva.
-
El método VIP es relativamente rápido, genera como salida puntos numéricos predecibles y es apto para seleccionar picos y depresiones locales. No obstante, es sensible al ruido e insensible a las entidades topográficas que son más grandes que la ventana de 3 por 3.
Sintaxis
| Parámetro | Explicación | Tipo de datos |
in_raster |
El ráster de entrada. | Raster Layer |
out_feature_class |
La clase de entidad de salida. | Feature Class |
out_vip_table (Opcional) |
La tabla del histograma que se va a reproducir cuando se especifica el Histograma VIP para el parámetro Método. | Table |
method (Opcional) |
El método de simplificación aplicado para generar la nueva clase de entidad multipunto.
| String |
kernel_method (Opcional) |
El método de selección utilizado para crear puntos cuando la simplificación kernel se especifica en el parámetro Método.
| String |
z_factor (Opcional) |
El factor utilizado para multiplicar la elevación del ráster. Por lo general, se utiliza para convertir unidades entre pies y metros. | Double |
Ejemplo de código
El siguiente ejemplo muestra cómo usar de esta herramienta en la ventana Python:
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.RasterToMultipoint_3d("elevation.tif", "","elev_VIP.dbf", "VIP_HISTOGRAM", "", "1")
El siguiente ejemplo muestra cómo usar esta herramienta en una secuencia de comandos independiente de Python:
'''*********************************************************************
Name: RasterToMultipoint Example
Description: This script demonstrates how to use
the RasterToMultipoint tool to create multipoint datasets
fot all IMG rasters in a target workspace.
**********************************************************************'''
# Import system modules
import arcpy
from arcpy import env
import exceptions
try:
arcpy.CheckOutExtension("3D")
# Set default workspace
env.workspace = "C:/data"
# Create the list of IMG rasters
rasterList = arcpy.ListRasters("*", "IMG")
# Loop the process for each raster
if rasterList:
for raster in rasterList:
# Set Local Variables
# [:-4] strips the last 4 characters (.img) from the raster name
outTbl = "VIP_" + raster[:-4] + ".dbf"
method = "VIP_HISTOGRAM"
zfactor = 1
#Execute RasterToMultipoint
arcpy.ddd.RasterToMultipoint(raster, "",outTbl, method, "", zfactor)
else:
"There are no IMG rasters in the " + env.workspace + " directory."
except Exception as e:
# Returns any other error messages
print e.message