Etiqueta | Explicación | Tipo de datos |
Entidades de entrada | Las entidades de entrada, que pueden ser de punto, multipunto, línea, polígono o multiparche. | Feature Layer |
Clase de entidad de salida | La clase de entidad poligonal de salida. | Feature Class |
Tipo de geometría (Opcional) | Especifica el tipo de geometría mínima de delimitación que representarán los polígonos de salida.
| String |
Opción de grupo (Opcional) | Especifica cómo se agruparán las entidades de entrada; cada grupo estará encerrado en un polígono de salida.
| String |
Campos de grupo (Opcional) | Campo o campos en las entidades de entrada que se utilizarán 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 se agregarán los atributos geométricos a la clase de entidad de salida o si se omitirán en la clase de entidad de salida.
| Boolean |
Resumen
Crea una clase de entidad que contiene polígonos que representan una geometría mínima de delimitación especificada que encierra cada entidad de entrada o cada grupo de entidades de entrada.
Ilustración
Uso
Las entidades poligonales de salida y sus atributos variarán según el tipo de geometría y las opciones de agrupación especificadas.
El parámetro Opción de grupo (parámetrogroup_option en Python) afectará a los atributos y polígonos de salida de las siguientes formas:
- Si se utiliza Ninguno, no se agrupará ninguna de las entidades de entrada. Se creará una entidad poligonal de salida para cada entidad de entrada; los polígonos resultantes podrían superponerse. Los atributos de las entidades de entrada se mantienen en la clase de entidad de salida. Se agrega a la clase de entidad de salida un nuevo campo, ORIG_FID, que contiene los Id. de entidad de entrada.
- Si se utiliza Todo, se creará una sola entidad poligonal de salida para todas las entidades de entrada. Los atributos de las entidades de entrada no se mantienen en la clase de entidad de salida.
- Si se utiliza Lista, cada conjunto de entidades de entrada con los mismos valores de campo en el campo o campos de grupo especificados será tratado como un grupo. Se creará una entidad poligonal de salida para cada grupo; los polígonos resultantes podrían superponerse. Los atributos de las entidades de entrada utilizados como campo o campos de grupo se mantendrán en la clase de entidad de salida.
Cada tipo de geometría puede estar caracterizada por una o varias mediciones únicas; estas mediciones se pueden agregar opcionalmente a la salida como nuevos campos como se describe a continuación. Los valores de ancho, longitud y diámetro están en las unidades de la entidad; los ángulos de orientación están en grados decimales en el sentido de las agujas del reloj desde el norte. El prefijo MBG_ indica el campo de geometría mínima de delimitación.
- Los nuevos campos y mediciones para Rectángulo por área y Rectángulo por ancho son:
- MBG_Width- longitud del lado más corto del rectángulo resultante.
- MBG_Length- longitud del lado más largo del rectángulo resultante.
- MBG_Orientation- orientación del lado más largo del rectángulo resultante.
- Los nuevos campos y mediciones para Sobre son:
- MBG_Width- longitud del lado más corto del rectángulo resultante.
- MBG_Length- longitud del lado más largo del rectángulo resultante.
- Los nuevos campos y mediciones para Envoltura convexa son:
- MBG_Width- distancia más corta entre dos vértices cualquiera de la envoltura convexa. (Se puede encontrar entre más de un par de vértices, pero se utilizará el primero que se encuentre).
- MBG_Length- distancia más larga entre dos vértices cualquiera de la envoltura convexa; estos vértices se denominan pares de antípodas o puntos antipodales. (Se puede encontrar entre más de un par de vértices, pero se utilizará el primero que se encuentre).
- MBG_APodX1- coordenada x del primer punto de los pares de antípodas.
- MBG_APodY1- coordenada y del primer punto de los pares de antípodas.
- MBG_APodX2- coordenada x del segundo punto de los pares de antípodas.
- MBG_APodY2- coordenada y del segundo punto de los pares de antípodas.
- MBG_Orientation- orientación de la línea imaginaria que conecta los pares de antípodas.
- El campo y medición nuevos para Círculo son:
- MBG_Diameter- diámetro del círculo resultante.
- Los nuevos campos y mediciones para Rectángulo por área y Rectángulo por ancho son:
Existen casos especiales de entidades de entrada que tienen como resultado polígonos de salida (de área cero) no válidos. En estos casos, se usará un valor pequeño derivado de la Tolerancia XY de la entidad de entrada como el ancho, la longitud o el diámetro para crear polígonos de salida. Estos polígonos sirven como "marcadores de posición" para hacer un rastreo de las entidades. Si los polígonos resultantes son "invisibles" en ArcMap cuando se utiliza el ancho de contorno de polígono predeterminado, cambie a un símbolo de línea de contorno más grueso para visualizarlos. A continuación, se describen algunos ejemplos de estos casos:
- Si una entidad multipunto contiene solo un punto o un grupo de esas entidades coinciden, se creará un polígono cuadrado muy pequeño alrededor del punto para los tipos de geometría Rectángulo por área, Rectángulo por ancho, Envoltura convexa y Sobre; y un círculo muy pequeño para el tipo de geometría Círculo. Los valores MBG_Width, MBG_Length, MBG_Orientation y MBG_Diameter se establecerán en cero para indicar estos casos.
- Si una entidad de entrada o un grupo de entidades de entrada están perfectamente alineadas, por ejemplo, una línea horizontal o vertical, o una entidad multipunto de dos puntos, se creará un polígono rectangular con un ancho muy pequeño alrededor de la entidad. Esto se aplica a los tipos de geometría Rectángulo por área, Rectángulo por ancho, Envoltura convexa y Sobre; el valor resultante de MBG_Width se establecerá en cero para indicar estos casos.
Parámetros
arcpy.management.MinimumBoundingGeometry(in_features, out_feature_class, {geometry_type}, {group_option}, {group_field}, {mbg_fields_option})
Nombre | Explicación | Tipo de datos |
in_features | Las entidades de entrada, que pueden ser de punto, multipunto, línea, polígono o multiparche. | Feature Layer |
out_feature_class | La clase de entidad poligonal de salida. | Feature Class |
geometry_type (Opcional) | Especifica el tipo de geometría mínima de delimitación que representarán los polígonos de salida.
| String |
group_option (Opcional) | Especifica cómo se agruparán las entidades de entrada; cada grupo estará encerrado en un polígono de salida.
| String |
group_field [group_field,...] (Opcional) | El campo o campos de las entidades de entrada que se utilizarán 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 |
mbg_fields_option (Opcional) | Especifica si se agregarán los atributos geométricos a la clase de entidad de salida o si se omitirán en la clase de entidad de salida.
| Boolean |
Muestra de código
El siguiente script de la ventana de Python muestra cómo utilizar la función MinimumBoundingGeometry en el modo inmediato.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.MinimumBoundingGeometry_management("parks.shp",
"c:/output/output.gdb/parks_mbg",
"RECTANGLE_BY_AREA", "NONE")
El siguiente script independiente es un ejemplo simple de cómo aplicar la función MinimumBoundingGeometry en un entorno de scripts.
# Name: MinimumBoundingGeometry.py
# Description: Use MinimumBoundingGeometry function to find an area
# for each multipoint input feature.
# import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Create variables for the input and output feature classes
inFeatures = "treeclusters.shp"
outFeatureClass = "forests.shp"
# Use MinimumBoundingGeometry function to get a convex hull area
# for each cluster of trees which are multipoint features
arcpy.MinimumBoundingGeometry_management(inFeatures, outFeatureClass,
"CONVEX_HULL", "NONE")