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.ddd.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.
| String |
group (Opcional) | Especifica cómo se agruparán las entidades de entrada; cada grupo estará encerrado en un multiparche de salida.
| 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.
| 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.
import arcpy
from arcpy import env
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
Información de licenciamiento
- Basic: Requiere 3D Analyst
- Standard: Requiere 3D Analyst
- Advanced: Requiere 3D Analyst