De ráster a multipunto (Herramientas de 3D Analyst)
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. Sin embargo, es sensible al ruido y puede ignorar las entidades topográficas que abarcan una extensión mayor que el área de 3 celdas por 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.
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.
No Thinning—No thinning will be applied. This is the default.
Z Tolerance—Only the cells that are required for maintaining a surface within a specified z-range of the input raster will be exported.
Kernel—The raster will be divided into equal-sized tiles based on the Thinning Value parameter value, and one or two cells that meet the Kernel Method parameter value will be exported.
VIP—A roving 3-cell-by-3-cell window will be used to create a three-dimensional best fit plane. Each cell is given a significance score based on its absolute deviation from this plane. A histogram of these scores is then used to determine the cells that will be exported based on the Thinning Value parameter value.
VIP Histogram—A table will be created containing the significance values and the corresponding number of points associated with those values.
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.
Minimum—A point will be created at the cell with the smallest elevation value found in the kernel neighborhood. This is the default.
Maximum—A point will be created at the cell with the largest elevation value found in the kernel neighborhood.
Minimum and Maximum—Two points will be created at the cells with the smallest and largest z-values found in the kernel neighborhood.
Closest to Mean—A point will be created at the cell whose elevation value is closest to the average of the cells in the kernel neighborhood.
String
Factor Z
(Opcional)
El factor por el que se multiplicarán los valores z. Esto se utiliza generalmente para convertir las unidades lineales z 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.
Tolerancia Z: la diferencia máxima permitida (en unidades z) entre el ráster de entrada y la superficie creada a partir de la clase de entidad multipunto de salida. El valor predeterminado es una décima parte del rango z del ráster de entrada.
Kernel: la cantidad de celdas ráster a lo largo del borde de cada tesela. El valor predeterminado es 3, lo que significa que el ráster se dividirá en ventanas de 3 x 3 celdas.
VIP: el rango de percentiles del histograma de puntuaciones de importancia. El valor predeterminado es 5,0, lo que significa que se exportarán las celdas con puntajes dentro del 5 por ciento superior del histograma.
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.
NO_THIN—No thinning will be applied. This is the default.
ZTOLERANCE—Only the cells that are required for maintaining a surface within a specified z-range of the input raster will be exported.
KERNEL—The raster will be divided into equal-sized tiles based on the Thinning Value parameter value, and one or two cells that meet the Kernel Method parameter value will be exported.
VIP—A roving 3-cell-by-3-cell window will be used to create a three-dimensional best fit plane. Each cell is given a significance score based on its absolute deviation from this plane. A histogram of these scores is then used to determine the cells that will be exported based on the Thinning Value parameter value.
VIP_HISTOGRAM—A table will be created containing the significance values and the corresponding number of points associated with those values.
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.
MIN—A point will be created at the cell with the smallest elevation value found in the kernel neighborhood. This is the default.
MAX—A point will be created at the cell with the largest elevation value found in the kernel neighborhood.
MINMAX—Two points will be created at the cells with the smallest and largest z-values found in the kernel neighborhood.
MEAN—A point will be created at the cell whose elevation value is closest to the average of the cells in the kernel neighborhood.
String
z_factor
(Opcional)
El factor por el que se multiplicarán los valores z. Esto se utiliza generalmente para convertir las unidades lineales z 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.
ZTolerance—La diferencia máxima permitida (en unidades z) entre el ráster de entrada y la superficie creada a partir de la clase de entidad multipunto de salida. El valor predeterminado es una décima parte del rango z del ráster de entrada.
KERNEL—La cantidad de celdas ráster a lo largo del borde de cada tesela. El valor predeterminado es 3, lo que significa que el ráster se dividirá en ventanas de 3 x 3 celdas.
VIP—El rango de percentiles del histograma de puntuaciones de importancia. El valor predeterminado es 5,0, lo que significa que se exportarán las celdas con puntajes dentro del 5 por ciento superior del histograma.
Double
Muestra de código
Ejemplo 1 de RasterToMultipoint (ventana de Python)
El siguiente ejemplo muestra cómo usar esta herramienta en la ventana de Python.
Ejemplo 2 de RasterToMultipoint (script independiente)
El siguiente ejemplo demuestra el uso de esta herramienta en un script de Python independiente:
'''*********************************************************************
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
# Run RasterToMultipoint
arcpy.ddd.RasterToMultipoint(raster, "", outTbl, method, "", zfactor)
else:
print("There are no IMG rasters in the " + arcpy.env.workspace + " directory.")