Volumen mínimo de delimitación (3D Analyst)

Resumen

Crea entidades multiparche que representan el volumen de espacio que ocupa un conjunto de entidades 3D.

Ilustración

Volumen mínimo de delimitación

Uso

  • Los métodos Esfera o Sobre (geometry_type="SPHERE" o geometry_type = "ENVELOPE" en Python) ofrecen una representación rápida del volumen ocupado por un conjunto de entidades 3D.

  • La opción Envoltura convexa (geometry_type="CONVEX_HULL" en Python) proporciona un mayor detalle que los métodos Esfera o Sobre, pero no captura las depresiones locales de las entidades de entrada.

  • La opción Envoltura cóncava (geometry_type="CONCAVE_HULL" en Python) proporciona la mayor cantidad de detalle sobre la forma del volumen de delimitación, pero es pesada desde el punto de vista del cómputo y no se debe utilizar con grandes colecciones de datos de entrada.

  • Cuando el volumen mínimo de delimitación resultante representa grupos de entidades de entrada, los campos utilizados para separar la entrada se agregan al multiparche resultante. Si las características de la geometría se incluyen en el volumen mínimo de delimitación, los siguientes campos se agregan a las entidades de salida:

    • MBV_Area: el área de la superficie total del volumen mínimo de delimitación
    • MBV_Volume: el volumen total del espacio contenido por la entidad multiparche

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Dataset LAS o entidades 3D cuyo volumen de límite mínimo se va a evaluar.

LAS Dataset Layer; Feature Layer
Valor Z

El origen de los valores z para los datos de entrada.

Field
Clase de entidad de salida

La clase de entidad que generará.

Feature Class
Tipo de Clase de Entidad de Salida
(Opcional)

Especifica el método a utilizar para determinar la geometría del volumen mínimo de delimitación.

  • CONVEX_HULLRegión convexa más pequeña que rodea los datos de entrada.
  • SPHERELa esfera más pequeña que encierra los datos de entrada.
  • ENVELOPELa extensión XYZ de los datos de entrada.
  • CONCAVE_HULLEnvoltura cóncava que encierra los datos de entrada.
String
Opciones de grupo
(Opcional)

Especifica cómo se agruparán las entidades de entrada; cada grupo estará encerrado en un multiparche de salida.

  • NONELas entidades de entrada no se agruparán. Esta es la opción predeterminada. Esta opción no se encuentra disponible para la entrada de punto.
  • ALLTodas las entidades de entrada serán tratadas como un grupo.
  • LISTLas entidades de entrada se agruparán según sus valores comunes en el campo o los campos especificados en el parámetro de campo de grupo.
String
Campos de grupo
(Opcional)

Campo o campos en las entidades de entrada que se utilizan para agrupar las entidades cuando se especifica Lista como Opción de grupo. Se requiere al menos un campo de grupo para la opción Lista. Todas las entidades que tienen el mismo valor en el campo o los campos especificados se tratarán como un grupo.

Field
Agregar características de geometría como atributos a la salida
(Opcional)

Especifica si cada entidad tendrá como atributos al volumen y al área de superficie del volumen mínimo de delimitación.

  • Desactivado: no se agregan atributos geométricos a la entidad de salida. Esta es la opción predeterminada.
  • Activado: se agregan atributos geométricos a la entidad de salida.
Boolean

arcpy.ddd.MinimumBoundingVolume(in_features, z_value, out_feature_class, {geometry_type}, {group}, {group_field}, {mbv_fields})
NombreExplicaciónTipo de datos
in_features

Dataset LAS o entidades 3D cuyo volumen de límite mínimo se va a evaluar.

LAS Dataset Layer; Feature Layer
z_value

El origen de los valores z para los datos de entrada.

Field
out_feature_class

La clase de entidad que generará.

Feature Class
geometry_type
(Opcional)

Especifica el método a utilizar para determinar la geometría del volumen mínimo de delimitación.

  • CONVEX_HULLRegión convexa más pequeña que rodea los datos de entrada.
  • SPHERELa esfera más pequeña que encierra los datos de entrada.
  • ENVELOPELa extensión XYZ de los datos de entrada.
  • CONCAVE_HULLEnvoltura cóncava que encierra los datos de entrada.
String
group
(Opcional)

Especifica cómo se agruparán las entidades de entrada; cada grupo estará encerrado en un multiparche de salida.

  • NONELas entidades de entrada no se agruparán. Esta es la opción predeterminada. Esta opción no se encuentra disponible para la entrada de punto.
  • ALLTodas las entidades de entrada serán tratadas como un grupo.
  • LISTLas entidades de entrada se agruparán según sus valores comunes en el campo o los campos especificados en el parámetro de campo de grupo.
String
group_field
[group_field,...]
(Opcional)

Campo o campos en las entidades de entrada que se utilizan para agrupar las entidades cuando se especifica LIST como group_option. Se requiere al menos un campo de grupo para la opción LIST. Todas las entidades que tienen el mismo valor en el campo o los campos especificados se tratarán como un grupo.

Field
mbv_fields
(Opcional)

Especifica si se agregan atributos geométricos a la clase de entidad multiparche de salida.

  • NO_MBV_FIELDSNo se agregan atributos geométricos a la entidad de salida. Esta es la opción predeterminada.
  • MBV_FIELDSSe agregan atributos geométricos a la entidad de salida.
Boolean

Muestra de código

Ejemplo 1 de MinimumBoundingVolume (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.ddd.MinimumBoundingVolume('tree_canopy.shp', 'Shape.Z', 
                                'canopy_volume.shp', 'CONCAVE_HULL',
                                group='List', group_field='Season'
                                mbv_fields='MBV_FIELDS')
Ejemplo 2 de MinimumBoundingVolume (script independiente)

En el siguiente ejemplo se muestra cómo usar esta herramienta en una secuencia de comandos independiente de Python.

'''****************************************************************************
Name: Detect Periods of Activity
Description: 
****************************************************************************'''
# Import system modules
import arcpy
import tempfile
import math

in_features = arcpy.GetParameterAsText(0)
out_volume = arcpy.GetParameterAsText(1)
grouping_field = arcpy.GetParameterAsText(2)


try:
    arcpy.MinimumBoundingVolume_3d(in_features, 'Shape.Z', out_volume, 
                                   'CONCAVE_HULL','LIST', group_field)

except arcpy.ExecuteError:
    print(arcpy.GetMessages())

Temas relacionados