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

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

Sintaxis

arcpy.3d.MinimumBoundingVolume(in_features, z_value, out_feature_class, {geometry_type}, {group}, {group_field}, {mbv_fields})

Parámetro	Explicación	Tipo 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á esta herramienta.	Feature Class
geometry_type (Opcional)	Especifica el método a utilizar para determinar la geometría del volumen mínimo de delimitación. CONVEX_HULL —Región convexa más pequeña que rodea los datos de entrada. SPHERE —La esfera más pequeña que encierra los datos de entrada. ENVELOPE —La extensión XYZ de los datos de entrada. CONCAVE_HULL —Envoltura 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. NONE —Las 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. ALL —Todas las entidades de entrada serán tratadas como un grupo. LIST —Las 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_FIELDS —No se agregan atributos geométricos a la entidad de salida. Esta es la opción predeterminada. MBV_FIELDS —Se 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 un script 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())

Entornos

Espacio de trabajo actual, Extensión, Sistema de coordenadas de salida, Transformaciones geográficas

Información de licenciamiento

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