Distribuir polígono (Analysis)

Resumen

Resume los atributos de una capa de polígono de entrada basándose en la superposición espacial de una capa de polígono de destino y asigna los atributos resumidos a los polígonos de destino. Los polígonos de destino tienen atributos numéricos sumados derivados de los polígonos de entrada a los que se superpone cada destino. Este proceso se conoce normalmente como distribución.

Esta herramienta se puede utilizar para estimar la población de una entidad en función del porcentaje de esa entidad que se superpone a otra entidad con una población conocida.

Ilustración

Se muestra la suma parcial de los atributos de entrada dentro del destino.

Uso

• De forma predeterminada, el porcentaje de área superpuesta determina el valor del atributo. Se puede utilizar un campo de ponderación junto con el área para determinar la parte del atributo que se va a sumar de cada entidad superpuesta.

• Un valor de campo de ponderación de 0 establecerá los campos en valores de distribución de 0 para cualquier entidad de destino superpuesta.

• Esta herramienta respeta el entorno Factor de procesamiento en paralelo. Si el entorno no está configurado (predeterminado) o está configurado con el valor 100, se permitirá el procesamiento en paralelo completo y la herramienta intentará distribuir el trabajo entre todos los núcleos lógicos del equipo. Configurar el entorno a 0 desactiva el procesamiento en paralelo. Especificar un factor entre 1 y 99 hará que la herramienta determine el porcentaje de núcleos lógicos que debe usar aplicando la fórmula (Factor de procesamiento en paralelo / 100 * Núcleos lógicos) redondeada al entero más próximo. Si el resultado de la fórmula es 0 o 1, no se habilitará el procesamiento en paralelo.

Sintaxis

arcpy.analysis.ApportionPolygon(in_features, apportion_fields, target_features, out_features, method, {estimation_features}, {weight_field}, {maintain_geometries})

Parámetro	Explicación	Tipo de datos
in_features	Las entidades poligonales que tienen atributos numéricos que se van a resumir en las geometrías de polígono de destino.	Feature Layer
apportion_fields [apportion_fields,...]	Los campos numéricos de los polígonos de entrada que cada polígono de destino resumirá y se registrarán en la clase de entidad de salida.	Field
target_features	Las entidades poligonales que se copiarán en la clase de entidad de salida e incluirán todos los campos distribuidos.	Feature Layer
out_features	La clase de entidad de salida que contiene el atributo y las geometrías de los polígonos de destino, así como los campos de distribución especificados de los polígonos de entrada.	Feature Class
method	Especifica el método utilizado para distribuir los campos de los polígonos de entrada a los polígonos de destino. AREA —La cantidad que cada polígono de entrada contribuye a los valores resumidos para cada entidad de destino viene determinada por el área de superposición entre las dos entidades. Si una entidad de entrada se superpone con a entidades de destino por la misma cantidad, los campos distribuidos se dividirán en dos y contribuyen a ambas entidades de destino por la mitad del valor total. Esta es la opción predeterminada.	String
estimation_features (Opcional)	Este parámetro está deshabilitado en ArcGIS Pro 2.7 y se admitirá en una versión futura.	Feature Layer
weight_field (Opcional)	Un campo numérico de la capa de polígonos de destino que se utiliza para ajustar qué polígonos de destino reciben valores distribuidos más grandes de los campos de los polígonos de entrada que se van a distribuir. Los destinos con mayor ponderación se distribuyen con un ratio más alto que los valores de campo.	Field
maintain_geometries (Opcional)	Especifica si la clase de entidad de salida mantendrá las geometrías originales de la capa de polígono de destino. MAINTAIN_GEOMETRIES —La clase de entidad de salida mantendrá las geometrías originales de la capa de polígono de destino. Esta es la opción predeterminada. INTERSECT_GEOMETRIES —La clase de entidad de salida será una intersección geométrica de los polígonos de destino y los polígonos de entrada. Solo se incluirán en la salida las áreas de los polígonos de destino que se superpongan con un polígono de entrada.	Boolean

Muestra de código

Ejemplo 1 de ApportionPolygon (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la función ApportionPolygon.

import arcpy
arcpy.env.workspace = "C:/data/MyAnalysis.gdb"
arcpy.ApportionPolygon_analysis(
        "CensusBlockGroups", "Pop2020", "StoreServiceArea", 
        "StoreServiceArea_w_Population", "AREA", "", "", "MAINTAIN_GEOMETRIES")

Ejemplo 2 de ApportionPolygon (script independiente)

El siguiente script independiente transfiere la población ponderada por área de una capa Census Block Groups a un polígono Store Service Area.

# Name: Store Service Area Get Population.py
# Description: Use apportionment to transfer population figures to different geometry 
# Import system modules 
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/MyAnalysis.gdb"
# Perform apportionment
inputDataWithPop = "CensusBlockGroups"
popField = "Pop2020"
targetServiceAreas = "Store_ServiceAreas"
outputApp = "Store_ServiceAreas_w_Population"
apportionMethod = "AREA"
keepTargetGeom = "MAINTAIN_GEOMETRIES"
arcpy.ApportionPolygon_analysis(inputDataWithPop, popField, targetServiceAreas, 
                                outputApp, apportionMethod, "", "", 
                                keepTargetGeom)
# Summarize store service area populations by store admin region
outStats = "PopulationPerSalesRegion_tlb"
statsFields = [["Pop2020", "SUM"]]
regionField = "SalesRegion" # Values like North, North-East, etc.
arcpy.Statistics_analysis(outputApp, outStats, statsFields, regionField)

Entornos

Espacio de trabajo actual, Espacio de trabajo temporal, Sistema de coordenadas de salida, Extensión, Factor de procesamiento en paralelo

Información de licenciamiento

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