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

Ilustración de la herramienta Distribuir polígono
Se muestra la suma parcial de los atributos de entrada dentro del destino.

Uso

  • De forma predeterminada, el porcentaje de área superpuesta determina el porcentaje de los atributos transferidos.

  • Se normalizará un campo de ponderación del polígono de entrada y se utilizará para ajustar cuánto se transfieren los atributos. Un campo de ponderación de 0 establecerá los atributos distribuidos de la entrada a los destinos en 0.

  • Si se especifica, el valor del parámetro Entidades de estimación se utiliza para determinar cómo se transferirán los atributos, en lugar de utilizar el área. Las entidades de estimación deben intersecar el valor del parámetro Polígonos de entrada para que cuenten. Si las entidades de estimación también intersecan el valor del parámetro Polígonos de destino, los atributos se transferirán al destino desde la entidad de entrada.

  • El parámetro Mantener geometrías de destino se utiliza para incluir la geometría de destino o la intersección de las geometrías de entrada y de destino en la geometría de salida.

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

Parámetros

EtiquetaExplicaciónTipo de datos
Polígonos de entrada

Las entidades poligonales con atributos numéricos que se resumirán en las geometrías de polígono de destino.

Feature Layer
Campos a distribuir

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
Polígonos de destino

Las entidades poligonales y sus campos distribuidos que se copiarán en la clase de entidad de salida.

Feature Layer
Clase de entidad de salida

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
Método de distribución

Especifica el método que se utilizará para distribuir los campos de los polígonos de entrada a los polígonos de destino.

  • ÁreaLa cantidad que cada polígono de entrada contribuye a los valores resumidos para cada entidad de destino vendrá 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.
  • LongitudLos atributos de las entidades de entrada se dividirán en función del porcentaje en que una línea esté dentro de cada entidad de destino. En el cálculo solo se incluye la línea que interseca la entidad de entrada. La línea fuera de la entidad de entrada se excluye. Por ejemplo, si una entidad de destino cubre 750 metros de una línea, y otra entidad de destino abarca 250 metros de una línea, el 75 % (750 / 1.000) de los valores de atributo de la entidad de entrada se agregarán a la primera entidad de destino y el 25 % (250 / 1000) de los valores de atributo de la entidad de entrada se agregarán a la segunda entidad de destino.
  • PuntosLos atributos de las entidades de entrada se dividirán en función del número de puntos dentro de cada entidad de destino que se superpongan con una entidad de entrada. Los puntos fuera de la entidad de entrada se excluyen. Opcionalmente, se puede especificar un campo de ponderación para que se utilice la ponderación total de todos los puntos dentro de cada entidad de destino para determinar cómo se dividen los valores de atributo de las entidades de entrada. Por ejemplo, si dos entidades de destino se superponen a una entidad de entrada y hay dos puntos dentro de la primera entidad de destino y ocho puntos dentro de la segunda entidad de destino, el 20 % (2 / 10) de los valores de atributo de la entidad de entrada se agregarán a la primera entidad de destino y el 80 % (8 / 10) de los valores de atributo de la entidad de entrada se agregarán a la segunda entidad de destino.
String
Entidades de estimación
(Opcional)

Las entidades de punto o polilínea de entrada que se utilizarán para estimar el porcentaje de los campos de distribución del polígono de entrada para distribuir el polígono de destino. Esta es la cantidad de la línea o el punto dentro de la intersección dividida por la cantidad dentro de la entidad de entrada para crear un porcentaje.

Feature Layer
Campo de peso
(Opcional)

Un campo numérico de la capa de polígonos de destino que se utilizará 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.

Si se especifican entidades de estimación, el campo de ponderación es un campo numérico de las entidades de estimación que ajustará los valores distribuidos a los polígonos de destino que intersecan las entidades de estimación.

Field
Mantener geometrías de destino
(Opcional)

Especifica si la clase de entidad de salida mantendrá las geometrías originales de la capa de polígono de destino.

  • Activado: 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.
  • Desactivado: 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

arcpy.analysis.ApportionPolygon(in_features, apportion_fields, target_features, out_features, method, {estimation_features}, {weight_field}, {maintain_geometries})
NombreExplicaciónTipo de datos
in_features

Las entidades poligonales con atributos numéricos que se resumirán 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 y sus campos distribuidos que se copiarán en la clase de entidad de salida.

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 que se utilizará para distribuir los campos de los polígonos de entrada a los polígonos de destino.

  • AREALa cantidad que cada polígono de entrada contribuye a los valores resumidos para cada entidad de destino vendrá 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.
  • LENGTHLos atributos de las entidades de entrada se dividirán en función del porcentaje en que una línea esté dentro de cada entidad de destino. En el cálculo solo se incluye la línea que interseca la entidad de entrada. La línea fuera de la entidad de entrada se excluye. Por ejemplo, si una entidad de destino cubre 750 metros de una línea, y otra entidad de destino abarca 250 metros de una línea, el 75 % (750 / 1.000) de los valores de atributo de la entidad de entrada se agregarán a la primera entidad de destino y el 25 % (250 / 1000) de los valores de atributo de la entidad de entrada se agregarán a la segunda entidad de destino.
  • POINTSLos atributos de las entidades de entrada se dividirán en función del número de puntos dentro de cada entidad de destino que se superpongan con una entidad de entrada. Los puntos fuera de la entidad de entrada se excluyen. Opcionalmente, se puede especificar un campo de ponderación para que se utilice la ponderación total de todos los puntos dentro de cada entidad de destino para determinar cómo se dividen los valores de atributo de las entidades de entrada. Por ejemplo, si dos entidades de destino se superponen a una entidad de entrada y hay dos puntos dentro de la primera entidad de destino y ocho puntos dentro de la segunda entidad de destino, el 20 % (2 / 10) de los valores de atributo de la entidad de entrada se agregarán a la primera entidad de destino y el 80 % (8 / 10) de los valores de atributo de la entidad de entrada se agregarán a la segunda entidad de destino.
String
estimation_features
(Opcional)

Las entidades de punto o polilínea de entrada que se utilizarán para estimar el porcentaje de los campos de distribución del polígono de entrada para distribuir el polígono de destino. Esta es la cantidad de la línea o el punto dentro de la intersección dividida por la cantidad dentro de la entidad de entrada para crear un porcentaje.

Feature Layer
weight_field
(Opcional)

Un campo numérico de la capa de polígonos de destino que se utilizará 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.

Si se especifican entidades de estimación, el campo de ponderación es un campo numérico de las entidades de estimación que ajustará los valores distribuidos a los polígonos de destino que intersecan las entidades de estimación.

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

Información de licenciamiento

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

Temas relacionados