Geometría mínima de delimitación (Administración de datos)

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

Ilustración de la herramienta Geometría mínima de delimitació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.
  • 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

EtiquetaExplicaciónTipo 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.

  • Rectángulo por áreaEl rectángulo del área más pequeña que encierra una entidad de entrada. Esta es la opción predeterminada.
  • Rectángulo por anchoEl rectángulo del ancho más pequeño que encierra una entidad de entrada.
  • Envoltura convexaEl polígono convexo más pequeño que encierra una entidad de entrada.
  • CírculoEl círculo más pequeño que encierra un sobre de entidad de entrada.
  • SobreEl sobre de una entidad de entrada.
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.

  • NadaLas 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.
  • TodasTodas las entidades de entrada serán tratadas como un grupo.
  • ListaLas 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
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.

  • Desactivado: omite los atributos geométricos en la clase de entidad de salida. Esta es la opción predeterminada.
  • Activado: agrega los atributos geométricos a la clase de entidad de salida.
Boolean

arcpy.management.MinimumBoundingGeometry(in_features, out_feature_class, {geometry_type}, {group_option}, {group_field}, {mbg_fields_option})
NombreExplicaciónTipo 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.

  • RECTANGLE_BY_AREAEl rectángulo del área más pequeña que encierra una entidad de entrada. Esta es la opción predeterminada.
  • RECTANGLE_BY_WIDTHEl rectángulo del ancho más pequeño que encierra una entidad de entrada.
  • CONVEX_HULLEl polígono convexo más pequeño que encierra una entidad de entrada.
  • CIRCLEEl círculo más pequeño que encierra un sobre de entidad de entrada.
  • ENVELOPEEl sobre de una entidad de entrada.
String
group_option
(Opcional)

Especifica cómo se agruparán las entidades de entrada; cada grupo estará encerrado en un polígono de salida.

  • NONELas 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.
  • ALLTodas las entidades de entrada serán tratadas como un grupo.
  • LISTLas 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)

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.

  • NO_MBG_FIELDSOmite cualquier atributo de entrada en la clase de entidad de salida. Esta es la opción predeterminada.
  • MBG_FIELDSAgrega los atributos geométricos a la clase de entidad de salida.
Boolean

Muestra de código

Ejemplo 1 de MinimumBoundingGeometry (ventana de Python)

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")
Ejemplo 2 de MinimumBoundingGeometry (script independiente)

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")

Temas relacionados