Etiqueta | Explicación | Tipo de datos |
Ráster de entrada | El ráster que se procesará. | Raster Layer; Mosaic Layer |
Clase de entidad de salida | La clase de entidad que generará. | Feature Class |
Tabla VIP de salida (Opcional) | La tabla del histograma que se creará cuando se especifica Histograma VIP para el parámetro Método de simplificación. La tabla del histograma que se creará cuando se especifica VIP_HISTOGRAM para el parámetro method. | Table |
Método de simplificación (Opcional) | Especifica el método de simplificación que se aplicará al ráster de entrada para seleccionar un subconjunto de celdas que se exportará a la clase de entidad multipunto.
| String |
Método kernel (Opcional) | Especifica el método de selección que se usará dentro de cada vecindad kernel cuando se aplica la simplificación kernel al ráster de entrada.
| String |
Factor Z (Opcional) | El factor por el que se multiplicarán los valores z. Generalmente se utiliza para convertir unidades lineales para que coincidan con las unidades lineales x,y. El valor predeterminado es 1, que no altera los valores de elevación. Este parámetro no está disponible si la referencia espacial de la superficie de entrada tiene un datum z con una unidad lineal especificada. | Double |
Valor de simplificación (Opcional) | El valor de simplificación asociado con el valor del parámetro Método de simplificación.
| Double |
Resumen
Convierte los centros de la celda ráster en entidades multipunto 3D con valores Z que reflejan el valor de la celda ráster.
Uso
Plantéese utilizar esta herramienta si tiene datos de elevación ráster y necesita acceder a las prestaciones funcionales de una superficie triangulada, dado que las entidades multipunto se pueden cargar en un dataset TIN o en un dataset de terreno.
Cuando el valor del parámetro Ráster de entrada es muy grande, plantéese usar el parámetro Método de simplificación para reducir el número de celdas que se exportan a la clase de entidad multipunto. Las opciones son las siguientes:
- Tolerancia Z: celdas delgadas conservando la precisión vertical.
- Kernel: celdas delgadas mientras controlando la distancia de muestra horizontal.
- VIP: utilice esta opción si los multipuntos resultantes se van a aplicar principalmente para aplicaciones de visualización. Este método es relativamente rápido, genera como salida una cantidad de puntos predecible e identifica picos y depresiones locales. No obstante, es sensible al ruido y podría ignorar las entidades topográficas que abarcan una extensión superior a un área de 3 x 3 celdas.
- Histograma VIP: utilice esta opción como paso inicial para aplicar la opción VIP, dado que genera un histograma de las puntuaciones más importantes que reflejan la cantidad de puntos que se seleccionarán con cada uno de los valores de percentil incremental.
Parámetros
arcpy.ddd.RasterToMultipoint(in_raster, out_feature_class, {out_vip_table}, {method}, {kernel_method}, {z_factor}, {thinning_value})
Nombre | Explicación | Tipo de datos |
in_raster | El ráster que se procesará. | Raster Layer; Mosaic Layer |
out_feature_class | La clase de entidad que generará. | Feature Class |
out_vip_table (Opcional) | La tabla del histograma que se creará cuando se especifica Histograma VIP para el parámetro Método de simplificación. La tabla del histograma que se creará cuando se especifica VIP_HISTOGRAM para el parámetro method. | Table |
method (Opcional) | Especifica el método de simplificación que se aplicará al ráster de entrada para seleccionar un subconjunto de celdas que se exportará a la clase de entidad multipunto.
| String |
kernel_method (Opcional) | Especifica el método de selección que se usará dentro de cada vecindad kernel cuando se aplica la simplificación kernel al ráster de entrada.
| String |
z_factor (Opcional) | El factor por el que se multiplicarán los valores z. Generalmente se utiliza para convertir unidades lineales para que coincidan con las unidades lineales x,y. El valor predeterminado es 1, que no altera los valores de elevación. Este parámetro no está disponible si la referencia espacial de la superficie de entrada tiene un datum z con una unidad lineal especificada. | Double |
thinning_value (Opcional) | El valor de simplificación asociado con el valor del parámetro method.
| Double |
Muestra de código
En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python.
arcpy.env.workspace = "C:/data"
arcpy.ddd.RasterToMultipoint("elevation.tif", out_vip_table="elev_VIP.dbf",
method="VIP_HISTOGRAM", z_factor=1)
En el siguiente ejemplo se 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
# Set default workspace
arcpy.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:
print("There are no IMG rasters in the " + env.workspace + " directory.")