Disolver por pares (Análisis)

Resumen

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

Hay disponible una herramienta alternativa para las operaciones de disolución. Consulte la documentación de la herramienta Disolver para obtener detalles.

Ilustración

Ilustración de la herramienta Disolver por pares

Uso

  • Los atributos de las entidades que se agregan mediante el proceso de disolución 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 un guion bajo y el nombre del campo de entrada como estándar de nombre del tipo de estadística. Por ejemplo, si la estadística SUM se utiliza en un campo llamado POP, la salida incluirá un campo llamado SUM_POP.

  • Es posible crear entidades muy grandes en la clase de entidad de salida. Es especialmente importante si hay un número reducido de valores únicos para el valor del parámetro 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 un equipo y esta salida se ha trasladado a un equipo con menos memoria disponible. Para evitar estos posibles problemas, utilice el parámetro Crear entidades multiparte para dividir entidades multiparte potencialmente más grandes en muchas entidades más pequeñas. Para entidades extremadamente grandes, puede utilizar la herramienta Subdividir para dividir las entidades grandes con el fin de resolver 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.

  • Si el tipo de geometría del valor del parámetro Entidades de entrada es punto o multipunto y se ha activado el parámetro Crear entidades multiparte, la salida será una clase de entidad multipunto. Por el contrario, si el parámetro Crear entidades multiparte está desactivado, la salida será una clase de entidad de punto.

  • De forma predeterminada, las entidades de curva de la entrada se densifican en la salida. Para admitir curvas en la salida, utilice el entorno Mantener segmentos de curva.

  • La herramienta Disolver por pares 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.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Las entidades que se agregan.

Feature Layer
Clase de entidad de salida

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

Feature Class
Campos a disolver
(Opcional)

El campo o los campos en los que se agregarán las entidades.

Field
Campos de estadísticas
(Opcional)

Especifica el o los campos que contienen los valores de los atributos que se utilizarán 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.

De forma predeterminada, la herramienta no calculará ninguna estadística.

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:

  • Suma: se sumarán los valores del campo especificado.
  • Valor medio: se calculará el valor medio del campo especificado.
  • Mínimo: se identificará el valor más bajo de todos los registros del campo especificado.
  • Máximo: se identificará el valor más alto de todos los registros del campo especificado.
  • Rango: se calculará el rango de valores (máximo menos mínimo) para el campo especificado.
  • Desviación estándar: se calculará la desviación estándar de los valores del campo especificado.
  • Recuento: se identificará la cantidad de valores incluidos en los cálculos. Cada valor se contará 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.
  • Primero: se utilizará el valor de campo especificado del primer registro de la entrada.
  • Último: se utilizará el valor de campo especificado del último registro de la entrada.
  • Mediana: se calculará la mediana de todos los registros del campo especificado.
  • Varianza: se calculará la varianza de todos los registros del campo especificado.
  • Único: se contará el número de valores únicos del campo especificado.
  • Concatenar: se concatenarán los valores del campo especificado. Los valores se pueden separar con el parámetro Separador de concatenación.
Value Table
Crear entidades multiparte
(Opcional)

Especifica si se incluirán entidades multiparte en la salida.

  • Activado: las entidades multiparte se incluirán en la salida. Esta es la opción predeterminada.
  • Desactivado: las entidades multiparte no se incluirán en la salida. Se crearán entidades individuales para cada parte.
Boolean
Separador de concatenación
(Opcional)

Un carácter o caracteres que se utilizarán para concatenar valores cuando se utilice la opción Concatenación para el parámetro Campos de estadísticas. De forma predeterminada, la herramienta concatenará los valores sin separador.

String

arcpy.analysis.PairwiseDissolve(in_features, out_feature_class, {dissolve_field}, {statistics_fields}, {multi_part}, {concatenation_separator})
NombreExplicació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 agregarán las entidades.

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

Especifica el o los campos que contienen los valores de los atributos que se utilizarán 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.

De forma predeterminada, la herramienta no calculará ninguna estadística.

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: se sumarán los valores del campo especificado.
  • MEAN: se calculará el valor medio del campo especificado.
  • MIN: se identificará el valor más bajo de todos los registros del campo especificado.
  • MAX: se identificará el valor más alto de todos los registros del campo especificado.
  • RANGE: se calculará el rango de valores (máximo menos mínimo) para el campo especificado.
  • STD: se calculará la desviación estándar de los valores del campo especificado.
  • COUNT: se identificará la cantidad de valores incluidos en los cálculos. Cada valor se contará 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: se utilizará el valor de campo especificado del primer registro de la entrada.
  • LAST: se utilizará el valor de campo especificado del último registro de la entrada.
  • MEDIAN: se calculará la mediana de todos los registros del campo especificado.
  • VARIANCE: se calculará la varianza de todos los registros del campo especificado.
  • UNIQUE: se contará el número de valores únicos del campo especificado.
  • CONCATENATE: se concatenarán los valores del campo especificado. Los valores se pueden separar con el parámetro concatenation_separator.
Value Table
multi_part
(Opcional)

Especifica si se incluirán entidades multiparte en la salida.

  • MULTI_PARTLas entidades multiparte se incluirán en la salida. Esta es la opción predeterminada.
  • SINGLE_PARTLas entidades multiparte no se incluirán en la salida. Se crearán entidades individuales para cada parte.
Boolean
concatenation_separator
(Opcional)

Un carácter o caracteres que se utilizarán para concatenar valores cuando se utilice la opción CONCATENATION para el parámetro statistics_fields. De forma predeterminada, la herramienta concatenará los valores sin separador.

String

Muestra de código

Ejemplo 1 de PairwiseDissolve (ventana de Python)

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

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

El siguiente script independiente muestra cómo utilizar la función 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"]
 
# Run MakeFeatureLayer and SelectLayerByAttribute.  This is only to exclude 
#  features that are not desired in the output.
arcpy.management.MakeFeatureLayer(inFeatures, tempLayer)
arcpy.analysis.SelectLayerByAttribute(tempLayer, "NEW_SELECTION", expression)
 
# Run Dissolve using LANDUSE and TAXCODE as Dissolve Fields
arcpy.analysis.PairwiseDissolve(tempLayer, outFeatureClass, dissolveFields, "", 
                                "SINGLE_PART")

Información de licenciamiento

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

Temas relacionados