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 de polígono de salida y sus atributos variarán según las opciones de agrupamiento y los tipos de geometría especificados.
El parámetro Opción de grupo del cuadro de diálogo (el parámetro group_option de la secuencia de comandos de Phyton) afectará los atributos y los polígonos de salida de las siguientes formas:
- Si se utiliza NONE, no se agrupará ninguna de las entidades de entrada. Se creará una entidad de polígono de salida para cada entidad de entrada; los polígonos resultantes se pueden superponer. Los atributos de las entidades de entrada se mantendrán en la clase de entidad de salida. Se agregará un campo nuevo, ORIG_FID, a la clase de entidad de salida y se establecerá en los Id. de entidad de entrada.
- Si se utiliza ALL, se creará una entidad de polígono de salida para todas las entidades de entrada. Los atributos de las entidades de entrada no se mantendrán en la clase de entidad de salida.
- Si utiliza LIST, cada conjunto de entidades de entrada que tenga los mismos valores de campo en los campos de grupo especificados será tratado como un grupo. Se creará una entidad de polígono de salida para cada grupo; los polígonos resultantes se pueden superponer. Los atributos de las entidades de entrada utilizados como el campo o los campos de grupo permanecerán en la clase de entidad de salida.
Cada tipo de geometría puede estar caracterizada por una o más mediciones únicas; estas mediciones se pueden agregar opcionalmente a la salida como campos nuevos como se describe a continuación. Los valores ancho, longitud y diámetro están en unidades de entidades; 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 campo de geometría mínima de delimitación.
- Los campos y mediciones nuevos de RECTANGLE_BY_AREA y RECTANGLE_BY_WIDTH 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 campos y mediciones nuevos para ENVELOPE 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 CONVEX_HULL 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 que primero se encuentre).
- MBG_Length: distancia más larga entre dos vértices cualquiera de la envoltura convexa; estos vértices se llaman pares de antípodas o puntos antipodales. (Se puede encontrar entre más de un par de vértices, pero se utilizará el que primero 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 a los pares de antípodas.
- El nuevo campo y medición para CIRCLE son:
- MBG_Diameter: diámetro del círculo resultante.
- Los campos y mediciones nuevos de RECTANGLE_BY_AREA y RECTANGLE_BY_WIDTH son:
Existen casos especiales de entidades de entrada que resultarían en polígonos de salida no válidos (de área cero). En estos casos, un valor pequeño derivado de la Tolerancia XY de la entidad de entrada se utilizará como el ancho, el largo o el diámetro para crear polígonos de salida. Estos polígonos sirven de "marcadores de posición" para realizar un seguimiento de las entidades. Si al utilizar el ancho del contorno del polígono predeterminado en ArcMap, los polígonos resultantes aparecen como "invisibles", cámbielo por un símbolo de línea de contorno más grueso para visualizarlos. Los ejemplos de estos casos incluyen:
- Si una entidad multipunto contiene solo un punto o un grupo de tales entidades es coincidente, se creará un polígono cuadrado muy pequeño alrededor del punto para los tipos de geometría, RECTANGLE_BY_AREA, RECTANGLE_BY_WIDTH, CONVEX_HULL y ENVELOPE, y un círculo muy pequeño para el tipo de geometría CIRCLE. Para indicar estos casos, MBG_Width, MBG_Length, MBG_Orientation y MBG_Diameter se establecen con valor cero.
- Si una entidad de entrada o un grupo de entidades de entrada se encuentran perfectamente alineados, por ejemplo, una línea horizontal o vertical o una entidad multipunto de dos puntos, alrededor de la entidad se creará un polígono rectángulo de ancho muy pequeño. Esto se aplica a los tipos de geometría RECTANGLE_BY_AREA, RECTANGLE_BY_WIDTH, CONVEX_HULL y ENVELOPE; el valor MBG_Width resultante se establecerá en cero para indicar estos casos.
Sintaxis
MinimumBoundingGeometry_management (in_features, out_feature_class, {geometry_type}, {group_option}, {group_field}, {mbg_fields_option})| Parámetro | Explicación | Tipo de datos |
in_features | Entidades de entrada que pueden ser 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 con un polígono de salida.
| String |
group_field [group_field,...] (Opcional) | Campo o campos en las entidades de entrada que se utilizarán para agrupar las entidades, cuando se especifique LIST en 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 los omitirá de la clase de entidad de salida.
| Boolean |
Ejemplo de código
Ejemplo 1 de MinimumBoundingGeometry (ventana de Python)
La siguiente secuencia de comandos de la ventana de Python demuestra 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")
Ejemplo 2 de MinimumBoundingGeometry (secuencia de comandos independiente)
La siguiente secuencia de comandos independiente es un ejemplo simple de cómo aplicar la función MinimumBoundingGeometry en un entorno de secuencias de comandos.
# 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")
Entornos
- Espacio de trabajo actual
- Espacio de trabajo temporal
- Valor Z de salida predeterminado
- Resolución M
- Tolerancia M
- Dominio M de salida
- Dominio Z de salida
- Sistema de coordenadas de salida
- Extensión
- La salida tiene valores M
- La salida tiene valores Z
- Cuadrícula espacial de salida 1
- Cuadrícula espacial de salida 2
- Cuadrícula espacial de salida 3
- Resolución XY
- Tolerancia XY
- Resolución Z
- Tolerancia Z
Información sobre licencias
- ArcGIS for Desktop Basic: Sí
- ArcGIS for Desktop Standard: Sí
- ArcGIS for Desktop Advanced: Sí