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

Resumen

Fusiona las líneas que tienen extremos coincidentes y, opcionalmente, los valores de atributo comunes.

Ilustración

Ilustración de UnsplitLine

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 la estadística SUM se utiliza en un campo llamado POP, la salida tendrá 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 convertir en una única entidad de línea de salida mediante la eliminación de la división. Esta limitación puede hacer que se produzca un error, ya que el proceso de eliminación de la división puede requerir más memoria de la que está 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 una eliminación de división anterior 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 viene determinado por la cantidad de memoria disponible en tiempo de ejecución; por lo tanto, una salida que contiene teselas es un indicador de que eliminar más divisiones con los recursos disponibles ocasionaría una situación de memoria insuficiente o generaría una entidad que no se podría utilizar. 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 muy bajo 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.

Sintaxis

arcpy.management.UnsplitLine(in_features, out_feature_class, {dissolve_field}, {statistics_fields})
ParámetroExplicació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 agregan las entidades.

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

Muestra de código

Ejemplo de UnsplitLine (ventana de Python)

El script de la ventana de Python muestra cómo utilizar la herramienta UnsplitLine en el modo inmediato.

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

El siguiente script independiente muestra cómo utilizar la herramienta 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"]
 
# Execute UnsplitLine using STREETNAME and PREFIX as Dissolve Fields
arcpy.UnsplitLine_management(inFeatures, outFeatureClass, dissolveFields)

Información de licenciamiento

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

Temas relacionados