Resumen
Fusiona las líneas que tienen extremos coincidentes y, opcionalmente, los valores de atributo comunes.
Ilustración
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ámetro | Explicación | Tipo 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:
| Value Table |
Muestra de código
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"])
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)
Entornos
Información de licenciamiento
- Basic: No
- Standard: No
- Advanced: Sí