Eliminar división de línea (Administración de datos)

Resumen

Agrega entidades de línea que tienen extremos coincidentes y, opcionalmente, valores de atributo comunes.

Ilustración

Ilustración de la herramienta Eliminar división de línea

Uso

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

  • La disponibilidad de memoria física puede limitar el número (y la complejidad) de las entidades de entrada que se pueden procesar y agregar a una única entidad de línea de salida. Esta limitación puede provocar un error, ya que el proceso de eliminación de disolución puede requerir más memoria de la disponible. Para evitarlo, Eliminar división de línea puede dividir y procesar las entidades de entrada con un algoritmo de ordenamiento en teselas adaptable. Para determinar las entidades que se han ordenado en teselas, ejecute la herramienta Frecuencia en el resultado de esta herramienta, especificando los mismos campos que se utilizaron en el parámetro Campos a disolver para el parámetro Campos de frecuencia. Se ordenaron en tesela los registros con un valor de frecuencia de 2. Los límites de la tesela se preservan en las entidades de salida para evitar la creación de entidades que sean demasiado grandes para que las utilice ArcGIS.

    Precaución:

    Ejecutar Eliminar división de línea en la salida de un proceso anterior de eliminación de división casi nunca reduce el número de entidades en la salida cuando el procesamiento original ha dividido y procesado las entradas mediante un ordenamiento en teselas adaptable. El tamaño máximo de cualquier entidad de salida se determina por la cantidad de memoria disponible en el tiempo de ejecución; la salida que contiene teselas es un indicador de que agregar aún más con los recursos disponibles ocasionará una situación de memoria insuficiente o resultará en una entidad inutilizable. Además, ejecutar la herramienta Eliminar división de línea una segunda vez en una salida creada de esta manera puede ocasionar un rendimiento lento y una ganancia escasa o nula, y puede ocasionar un fallo inesperado.

  • Los valores nulos se excluyen de todos los cálculos estadísticos. Por ejemplo, el promedio de 10, 5 y un valor nulo es 7,5 ((10 + 5)/2). El recuento devuelve el número de valores incluidos en el cálculo estadístico, que en este caso es 2.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Entidades de línea que se agregarán.

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. Si no se especifica ningún campo, la herramienta disolverá todas las entidades juntas.

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
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.management.UnsplitLine(in_features, out_feature_class, {dissolve_field}, {statistics_fields}, {concatenation_separator})
NombreExplicaciónTipo de datos
in_features

Entidades de línea que se agregarán.

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. Si no se especifica ningún campo, la herramienta disolverá todas las entidades juntas.

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
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 de UnsplitLine (ventana de Python)

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

import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Streets"
arcpy.management.UnsplitLine("streets", "C:/output/output.gdb/streets_unsplit",
                             ["STREETNAME", "PREFIX"])
Ejemplo 2 de UnsplitLine (script independiente)

El siguiente script independiente muestra cómo utilizar la función UnsplitLine.

# Name: UnsplitLine_Example2.py
# Description: Unsplit line features based on common attributes
 
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/Portland.gdb/Streets"
 
# Set local variables
inFeatures = "streets"
outFeatureClass = "C:/output/output.gdb/streets_unsplit"
dissolveFields = ["STREETNAME", "PREFIX"]
 
# Run UnsplitLine using STREETNAME and PREFIX as Dissolve Fields
arcpy.management.UnsplitLine(inFeatures, outFeatureClass, dissolveFields)

Temas relacionados