Contar entidades superpuestas (Analysis)

Resumen

Genera entidades superpuestas planarizadas a partir de las entidades de entrada. El recuento de entidades superpuestas se escribe en las entidades de salida.

Ilustración

Uso

• El tipo de geometría de la salida es el mismo que el tipo de geometría de la entrada, a excepción de la geometría de puntos. A partir de la geometría de puntos, la salida será una clase de entidad multipunto si hay varias clases de entidad de entrada, o una clase de entidad de puntos si hay una sola clase de entidad de puntos de entrada.

• La salida es una unión planarizada de las entradas. La superposición entre entidades desplazadas verticalmente (geometría con diversos valores Z) se evalúa como si todas las entidades estuvieran aplanadas sobre el mismo plano.

  Para la geometría de polígonos, toda área ocupada por dos o más entidades se considera superpuesta. Para la geometría de líneas, solamente se consideran superpuestas las líneas que se superponen por completo (un segmento de línea es un incidente con otro segmento de línea). Las líneas que se intersecan en un punto no se consideran superposición. Para la geometría de puntos, todo punto coincidente se considera superpuesto.

• Estos campos estarán incluidos en la Clase de entidad de salida:

  • COUNT_: la cantidad de entidades superpuestas en la entrada
  • COUNT_FC: la cantidad de clases de entidad individuales que se superponen a la entidad

  El resto de campos de las Entidades de entrada quedan excluidos de la Clase de entidad de salida.

• Cuando se genera una Tabla de superposición de salida, incluye un registro para cada superposición. Por ejemplo, cuando tres entidades de entrada se superponen en la misma ubicación, la tabla contiene tres registros para dicha ubicación (uno para cada geometría superpuesta). Estos campos se incluyen en la Tabla de superposición de salida:

  • OVERLAP_OID: el ObjectID de la entidad de la Clase de entidad de salida relacionada.
  • ORIG_OID: el ObjectID de la entidad de las Entidades de entrada relacionadas.
  • ORIG_NAME: este campo se agregará si hay varias entradas. El campo contiene el nombre de la entrada.

  Esta tabla le permite relacionar cada superposición con las entidades de entrada y salida.

Sintaxis

arcpy.analysis.CountOverlappingFeatures(in_features, out_feature_class, {min_overlap_count}, {out_overlap_table})

Parámetro	Explicación	Tipo de datos
in_features [in_features,...]	Las capas o clases de entidad de entrada. Las entidades de entrada pueden ser puntos, multipuntos, líneas o polígonos. Si proporciona varias entradas, todas deben tener el mismo tipo de geometría.	Feature Layer
out_feature_class	La clase de entidad de salida que contiene el recuento de superposiciones.	Feature Class
min_overlap_count (Opcional)	Limita la salida a únicamente las ubicaciones que satisfacen o superan el número especificado de superposiciones. El valor predeterminado es 1.	Long
out_overlap_table (Opcional)	La tabla de salida que contiene los registros para cada geometría superpuesta individual.	Table

Muestra de código

Ejemplo de CountOverlappingFeatures (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función CountOverlappingFeatures en modo inmediato.

import arcpy
arcpy.env.workspace = r"C:\data\data.gdb"
arcpy.CountOverlappingFeatures_analysis("Viewsheds", "Viewshed_Overlaps")

Ejemplo 2 de CountOverlappingFeatures (script independiente)

El siguiente código demuestra cómo utilizar la función CountOverlappingFeatures para obtener el recuento de superposiciones para las tres redes superpuestas de proveedores de servicios móviles y el parámetro min_overlap_count para limitar la salida a únicamente aquellas áreas donde los tres proveedores de servicios móviles tienen cobertura.

# CountOverlappingFeatures_Example_2.py
# Description: Count number of cellular service providers for given area
# Import the system modules
import arcpy
# Set current workspace
arcpy.env.workspace = r"C:\data\data.gdb"
# Set input parameters
provider_a = 'Provider_A_ServiceArea'
provider_b = 'Provider_B_ServiceArea'
provider_c = 'Provider_C_ServiceArea'
in_fcs  = [provider_a, provider_b, provider_c]
# Set output feature names
out_fc = 'CellularProviders_Count'
out_tbl = 'CelluarProviders_Count_Tbl'
# Obtain overlap count for three overlapping input feature classes
# and use minimum_overlap_count parameter to limit the output to only 
# those areas where all three overlap.
arcpy.CountOverlappingFeatures_analysis(in_fcs, out_fc, 3, out_tbl)

Entornos

Valor Z de salida predeterminado, Resolución M, Tolerancia M, Dominio M de salida, Sistema de coordenadas de salida, Transformaciones geográficas, Espacio de trabajo temporal, La salida tiene valores M, La salida tiene valores Z, Resolución XY, Tolerancia XY, Resolución Z, Tolerancia Z, Espacio de trabajo actual, Palabra clave CONFIG de salida

Información de licenciamiento

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