De ráster a multipunto (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. 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

EtiquetaExplicaciónTipo 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.

  • Sin simplificaciónNo se aplicará ninguna simplificación. Esta es la opción predeterminada.
  • Tolerancia ZSolo se exportarán las celdas que son necesarias para mantener una superficie dentro de un rango Z especificado para el ráster de entrada.
  • KernelEl ráster se dividirá en teselas de igual tamaño en función del valor del parámetro Valor de simplificación, y se exportarán una o dos celdas que cumplan con el valor del parámetro Método Kernel.
  • VIPSe utilizará una ventana de colector de datos de 3 x 3 celdas para crear el plano tridimensional que mejor se ajuste. A cada celda se le asigna una puntuación de importancia según la desviación absoluta respecto a este plano. A continuación se utiliza un histograma de estas puntuaciones para determinar las celdas que se exportarán según el valor del parámetro Valor de simplificación.
  • Histograma VIPSe creará una tabla que contendrá los valores de importancia reales y la correspondiente cantidad de puntos asociados con esos valores.
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.

  • MínimoSe creará un punto en la celda con el valor de elevación más pequeño que se encuentra en la vecindad kernel. Esta es la opción predeterminada.
  • MáximoSe creará un punto en la celda con el valor de elevación más grande que se encuentra en la vecindad kernel.
  • Mínimo y máximoSe crearán dos puntos en las celdas con los valores z más grandes y más pequeños encontrados en la vecindad kernel.
  • Más cercano a la mediaSe creará un punto en la celda cuyo valor de elevación es más cercano al promedio de las celdas en la vecindad kernel.
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.

  • 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.
Double

arcpy.ddd.RasterToMultipoint(in_raster, out_feature_class, {out_vip_table}, {method}, {kernel_method}, {z_factor}, {thinning_value})
NombreExplicaciónTipo 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.

  • NO_THINNo se aplicará ninguna simplificación. Esta es la opción predeterminada.
  • ZTOLERANCESolo se exportarán las celdas que son necesarias para mantener una superficie dentro de un rango Z especificado para el ráster de entrada.
  • KERNELEl ráster se dividirá en teselas de igual tamaño en función del valor del parámetro Valor de simplificación, y se exportarán una o dos celdas que cumplan con el valor del parámetro Método Kernel.
  • VIPSe utilizará una ventana de colector de datos de 3 x 3 celdas para crear el plano tridimensional que mejor se ajuste. A cada celda se le asigna una puntuación de importancia según la desviación absoluta respecto a este plano. A continuación se utiliza un histograma de estas puntuaciones para determinar las celdas que se exportarán según el valor del parámetro Valor de simplificación.
  • VIP_HISTOGRAMSe creará una tabla que contendrá los valores de importancia reales y la correspondiente cantidad de puntos asociados con esos valores.
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.

  • MINSe creará un punto en la celda con el valor de elevación más pequeño que se encuentra en la vecindad kernel. Esta es la opción predeterminada.
  • MAXSe creará un punto en la celda con el valor de elevación más grande que se encuentra en la vecindad kernel.
  • MINMAXSe crearán dos puntos en las celdas con los valores z más grandes y más pequeños encontrados en la vecindad kernel.
  • MEANSe creará un punto en la celda cuyo valor de elevación es más cercano al promedio de las celdas en la vecindad kernel.
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.

  • 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)

En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python.

arcpy.env.workspace = "C:/data"
arcpy.RasterToMultipoint_3d("elevation.tif", out_vip_table="elev_VIP.dbf", 
                            method="VIP_HISTOGRAM", z_factor=1)
Ejemplo 2 de RasterToMultipoint (secuencia de comandos independiente)

En el siguiente ejemplo se muestra cómo usar esta herramienta en un script 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.")

Información de licenciamiento

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

Temas relacionados