Etiqueta | Explicación | Tipo de datos |
Entidades de entrada
| 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 |
Clase de entidad de salida
| La clase de entidad de salida que contiene el recuento de superposiciones. | Feature Class |
Recuento de superposición mínima
(Opcional) | Limita la salida a únicamente las ubicaciones que satisfacen o superan el número especificado de superposiciones. El valor predeterminado es 1. | Long |
Tabla de superposición de salida
(Opcional) | La tabla de salida que contiene los registros para cada geometría superpuesta individual. | Table |
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.
Parámetros
arcpy.analysis.CountOverlappingFeatures(in_features, out_feature_class, {min_overlap_count}, {out_overlap_table})
Nombre | 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
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")
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
Casos especiales
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí