Disolver por pares (Análisis)

Resumen

Agrega entidades basándose en atributos especificados utilizando un enfoque de procesamiento en paralelo.

Ilustración

Ilustración de Disolver

Uso

  • Los atributos de las entidades que se agregan al disolver se pueden resumir o describir con una variedad de estadísticas. La estadística que se utiliza para resumir atributos se agrega a la clase de entidad de salida como un campo simple con el siguiente estándar de nombre de tipo de estadística + guion bajo + nombre del campo de entrada. Por ejemplo, si la estadística SUM se utiliza en un campo llamado POP, la salida tendrá un campo llamado SUM_POP.

  • Es posible crear entidades muy grandes en la clase de entidad de salida. Esto se da especialmente en el caso donde hay un pequeño número de valores únicos en los Campos a disolver o al disolver todas las entidades en una única entidad. Las entidades muy grandes pueden causar problemas de visualización o procesamiento o reducir el rendimiento cuando se dibujan en un mapa o se editan. También pueden surgir problemas si la salida de disolución ha creado una entidad de tamaño máximo en una máquina y posteriormente esta salida se ha trasladado a una máquina con menos memoria disponible. Para evitar estos posibles problemas, desactive Crear entidades multiparte (multi_part="SINGLE_PART" en Python) para dividir entidades multiparte potencialmente más grandes en varias entidades más pequeñas. Para entidades extremadamente grandes, es posible que se deba usar la herramienta Subdividir para dividir entidades grandes con el fin de solucionar los problemas de procesamiento, visualización o rendimiento.

  • Los valores nulos se excluyen de todos los cálculos estadísticos. Por ejemplo, el AVERAGE de 10, 5 y NULL es 7,5 ([10+5]/2). La estadística COUNT devuelve la cantidad de valores incluidos en el cálculo estadístico, que en este caso es 2.

  • El botón Agregar campo del parámetro Campos a disolver se utiliza sólo en ModelBuilder. En ModelBuilder, donde no se ejecutó la herramienta anterior o sus datos derivados no existen, es probable que el parámetro Campos a disolver no se complete con nombres de campos. El botón Agregar campo le permite agregar los campos esperados para que pueda completar el cuadro de diálogo de la herramienta y continuar creando el modelo.

  • Si el tipo de geometría Entidades de entrada es de un punto o multipunto y se ha activado Crear entidades multiparte (multi_part="MULTI_PART" en Python), la salida será una clase de entidad multipunto. Por el contrario, si no se ha activado Crear entidades multiparte (multi_part="SINGLE_PART" en Python), la salida será una clase de entidad de punto.

  • La herramienta Disolver por pares utiliza el entorno Factor de procesamiento 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

PairwiseDissolve(in_features, out_feature_class, {dissolve_field}, {statistics_fields}, {multi_part})
ParámetroExplicaciónTipo de datos
in_features

Las entidades que se agregan.

Feature Layer
out_feature_class

La clase de entidad que se crea y que contiene las entidades agregadas.

Feature Class
dissolve_field
[dissolve_field,...]
(Opcional)

El campo o los campos en los que se agregan las entidades.

El botón Agregar campo, que se utiliza solo en ModelBuilder, le permite agregar los campos esperados para que pueda completar el cuadro de diálogo y continuar creando el modelo.

Field
statistics_fields
[[field, {statistic_type}],...]
(Opcional)

Especifica el campo numérico con los valores de atributos que se utilizaron para calcular la estadística especificada. Se pueden especificar varias estadísticas y combinaciones de campos. Los valores nulos se excluyen de todos los cálculos estadísticos.

Los campos de atributo de texto se pueden resumir con las estadísticas FIRST y LAST. Los campos de atributo numérico se pueden resumir con cualquier estadística.

Los tipos de estadísticas disponibles son los siguientes:

  • SUM: agrega el valor total para el campo especificado.
  • MEAN: calcula el promedio para el campo especificado.
  • MIN: busca el valor más pequeño para todos los registros del campo especificado.
  • MAX: busca el valor más grande para todos los registros del campo especificado.
  • RANGE: busca el rango de valores (Máximo menos Mínimo) para el campo especificado.
  • STD: busca la desviación estándar de los valores en el campo especificado.
  • COUNT: busca la cantidad de valores incluidos en los cálculos estadísticos. Esto cuenta todos los valores excepto los valores nulos. Para determinar el número de valores nulos de un campo, cree un recuento del campo en cuestión, cree un recuento de otro campo que no contenga valores nulos (por ejemplo, OID si está presente) y reste los dos valores.
  • FIRST: busca el primer registro de la entrada y utiliza el valor de campo especificado.
  • LAST: busca el último registro de la entrada y utiliza el valor de campo especificado.
  • MEDIAN: calcula la mediana de todos los registros del campo especificado.
  • VARIANCE: calcula la varianza de todos los registros del campo especificado.
  • UNIQUE: hace un recuento del número de valores únicos del campo especificado.
Value Table
multi_part
(Opcional)

Especifique si deben admitir entidades multiparte en la clase de entidad de salida.

  • MULTI_PARTEspecifica que se permitan entidades multiparte. Esta es la opción predeterminada.
  • SINGLE_PARTEspecifica que no se permitan entidades multiparte. En lugar de crear entidades multiparte, se crearán entidades individuales para cada parte.
Boolean

Muestra de código

Ejemplo 1 de PairwiseDissolve (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la herramienta PairwiseDissolve en el modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Taxlots"
arcpy.PairwiseDissolve_analysis("taxlots", "C:/output/output.gdb/taxlots_dissolved",
                                ["LANDUSE", "TAXCODE"], "", "SINGLE_PART")
Ejemplo 2 de PairwiseDissolve (secuencia de comandos independiente)

La siguiente secuencia de comandos independiente muestra cómo utilizar la herramienta PairwiseDissolve.

# Name: PairwiseDissolve_Example2.py
# Description: Dissolve features based on common attributes
 
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Taxlots"
 
# Set local variables
inFeatures = "taxlots"
tempLayer = "taxlotsLyr"
expression = arcpy.AddFieldDelimiters(inFeatures, "LANDUSE") + " <> ''"
outFeatureClass = "C:/output/output.gdb/taxlots_dissolved"
dissolveFields = ["LANDUSE", "TAXCODE"]
 
# Execute MakeFeatureLayer and SelectLayerByAttribute.  This is only to exclude 
#  features that are not desired in the output.
arcpy.MakeFeatureLayer_management(inFeatures, tempLayer)
arcpy.SelectLayerByAttribute_management(tempLayer, "NEW_SELECTION", expression)
 
# Execute Dissolve using LANDUSE and TAXCODE as Dissolve Fields
arcpy.PairwiseDissolve_analysis(tempLayer, outFeatureClass, dissolveFields, "", 
                                "SINGLE_PART")

Información de licenciamiento

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

Temas relacionados