Geometría mínima de delimitación

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.

Licencia:

Las opciones Tipo de geometría (geometry_type) CONVEX_HULL, CIRCLE y ENVELOPESobre solo están disponibles con una licencia de ArcGIS Desktop Advanced.

• 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.

• 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

arcpy.management.MinimumBoundingGeometry(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. RECTANGLE_BY_AREA —El rectángulo del área más pequeña que encierra una entidad de entrada. Esta es la opción predeterminada. RECTANGLE_BY_WIDTH —El rectángulo del ancho más pequeño que encierra una entidad de entrada. CONVEX_HULL —El polígono convexo más pequeño que encierra una entidad de entrada. CIRCLE —El círculo más pequeño que encierra una entidad de entrada. ENVELOPE —El contorno de una entidad de entrada. Licencia: Las opciones CONVEX_HULL, CIRCLE y ENVELOPE solo se encuentran disponibles con una licencia de ArcGIS Desktop Advanced.	String
group_option (Opcional)	Especifica cómo se agruparán las entidades de entrada; cada grupo estará encerrado con un polígono 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 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. NO_MBG_FIELDS —Omite cualquier atributo de entrada en la clase de entidad de salida. Esta es la opción predeterminada. MBG_FIELDS —Agrega los atributos geométricos en la clase de entidad de salida.	Boolean

Muestra 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
• Palabra clave CONFIG 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 de licenciamiento

• Basic: Limitado
• Standard: Limitado
• Advanced: Sí