En el Analizando errores de topología artículo te mostramos cómo puedes usar la nueva herramienta Analyze Network Data para identificar errores de topología en tus datos de utility network. En este artículo te mostraremos cómo puedes usar la base de datos resultante y la herramienta Apply Error Resolutions para resolver los errores de topología que las herramientas descubrieron.
La herramienta Apply Error Resolutions se usa mejor durante el proceso de migración de datos, antes de que la topología de la red haya sido habilitada y antes de que los datos hayan sido cargados en un enterprise geodatabase. Esta herramienta debe ejecutarse en una utility network con topología deshabilitada. La herramienta puede usarse para aplicar resoluciones a datos que han sido cargados en un enterprise geodatabase si los datos no están registrados como versionados, y la herramienta se ejecuta como un usuario que tiene permisos para editar las clases de entidades correspondientes usando la conexión a la base de datos.
Aunque puede haber muchas causas y resoluciones para cada error, este artículo discutirá los enfoques más comunes para abordar cada error junto con recursos que puedes usar para ayudarte a determinar el camino más apropiado a seguir. Los errores en este artículo están listados desde los más comunes hasta los menos comunes, para los errores que la herramienta Analyze Network Data puede identificar. Para más información sobre por qué Analyze Network Data solo soporta ciertos errores, lee el Analizando errores de topología artículo.Los errores sin resoluciones automatizadas están incluidos en este artículo con referencias a recursos adicionales que pueden ayudarte a resolver los errores.
Errores de Topología
A continuación encontrarás un resumen de los diferentes tipos de errores que la herramienta puede detectar.
Error de Topología | Descripción | Acciones Disponibles |
|---|
Conectividad ambigua | Esto ocurre cuando hay más de una regla disponible para una conexión potencial. | Ninguna |
Vértices duplicados | Esto ocurre cuando una línea tiene dos o más vértices duplicados. | Eliminar (Vértice) |
Geometría vacía | Este error ocurre cuando una entidad línea tiene una longitud cero o casi cero. | Eliminar (Entidad) |
Política de conectividad de borde | Esto ocurre cuando una línea tiene una conexión que viola su política de conectividad de borde. | Ninguna |
Terminal inválido | Esto ocurre cuando el id del terminal desde o hacia terminal id de una línea no es válido para uno de los dispositivos/junctions a los que está conectado. | Ninguna |
Dispositivo terminal midspan | Esto ocurre cuando un dispositivo que tiene una configuración terminal está dibujado midspan en una línea. | Ninguna |
Junction faltante | Esto ocurre cuando dos entidades con un tipo de activo diferente están conectadas sin un junction o dispositivo. | Crear |
Regla faltante | Esto ocurre cuando dos entidades están potencialmente conectadas pero no hay una regla que lo permita. | Ninguna |
Línea auto-intersectante | Esto ocurre cuando la geometría de una línea se intersecta consigo misma. | Eliminar (Vértice) |
Longitud de forma | Este error ocurre cuando una entidad línea tiene una longitud cero o casi cero. | Eliminar (Entidad) |
Puntos apilados | Esto ocurre cuando dos o más junctions o dispositivos están dentro de una tolerancia (xy) y ocupan la misma ubicación z. | Eliminar (Entidad) Actualizar (Entidad) |
Toma subred | Este error ocurre cuando una entidad con la categoría subnetwork tap está dibujada en el punto final de una sola línea o en la intersección del punto final de dos líneas. | Ninguna |
Vértice dentro de tolerancia | Este error ocurre cuando dos o más vértices están dentro de la tolerancia espacial del conjunto de datos pero no son topológicamente coincidentes. | Anclar Ajustar |
Nota: Hay dos acciones eliminar: Eliminar todo y Eliminar todo menos el primero. La tabla anterior lista ambas acciones simplemente como Eliminar, porque cualquiera acción es apropiada. Además, la tabla anterior especifica si eliminar aplica a toda la entidad o solo al vértice en error aunque esta información no esté especificada en la acción.
Al revisar errores usando la tabla de atributos, considera cambiar la altura de fila de tu tabla para que puedas ver todos los tipos de activos en un error. Puedes cambiar esto yendo a Proyecto > Opciones > Tabla > Columnas y filas > Altura de fila y configurarlo a triple o doble.
Resoluciones de Errores
Limpiar manualmente los datos es algo que muchos clientes hacen en preparación para su migración de datos. Sin embargo, ciertos errores se prestan mejor a limpieza automatizada, o puedes decidir que para tu primer intento migrando a utility network quieres aplicar rápidamente correcciones automatizadas a tus datos.
Independientemente del motivo para tu decisión, puedes especificar resoluciones automatizadas a tus datos usando la tabla Error Resolutions. La tabla Error Resolutions tiene las siguientes columnas:
- Código del error – El error identificado en la ubicación
- Tipos de análisis – Una lista concatenada de todas las entidades presentes en esa ubicación.
- Clave de resolución – Un ID que identifica exclusivamente el error asociado con la corrección
- Posición del grupo – Cuando múltiples tipos de entidades están presentes en una ubicación, esto da el orden en que fueron encontradas
- Tipo de entidad – La clase network, grupo asset y tipo asset de la entidad en esta ubicación
- Clase fuente – La capa utility network a la cual se aplicará la corrección
- Grupo asset – El grupo asset de la entidad a la cual se aplicará la corrección
- Tipo asset – El tipo asset de la entidad a la cual se aplicará la corrección
- Contexto – Si la entidad en esta ubicación representa un error, o una entidad coincidente con el error
- Acción – Qué acción aplicar a esta entidad para resolver el problema, si hay alguna
- Delta X – Cuánto debe desplazarse la entidad en dirección x
- Delta Y – Cuánto debe desplazarse la entidad en dirección y
- Delta Z – Cuánto debe desplazarse la entidad en dirección z
- Paso delta – Si hay múltiples entidades desplazadas en esta ubicación, cuánto debe desplazarse cada entidad subsecuente
- Tipo Crear/Actualizar – La clase, grupo asset y tipo asset a usar para crear una nueva entidad o actualizar la existente.
Acciones
La siguiente tabla describe las acciones disponibles para cada corrección.
Acción | Descripción |
|---|
Crear | Esta acción creará una nueva entidad. Cuando esta acción está seleccionada debes especificar el tipo de entidad usando el campo Tipo Crear/Actualizar. |
Actualizar todo Actualizar todo menos el primero | Esta acción actualizará el vértice correspondiente o las entidades. Si hay múltiples entidades asociadas con la corrección puedes elegir actualizar todas las entidades o actualizar todas menos la primera entidad. Al actualizar las entidades puedes usar esta acción para actualizar la ubicación usando los campos delta x, y, z y paso. Cuando hay múltiples entidades coincidentes asegúrate de especificar un valor paso delta para asegurar que cada entidad subsecuente esté desplazada respecto a la anterior. También puedes cambiar el grupo asset y/o tipo asset usando el campo Tipo Crear/Actualizar. |
Eliminar todo Eliminar todo menos el primero | This action will delete the corresponding vertex or feature(s). If there are multiple features associated with the fix you can choose to delete all the features/vertices or to delete all of them but the first feature/vertex. |
Anchor Snap | These resolutions are used to resolve the Vertex within tolerance error. They allow one vertex to be designated as the anchor location and the remaining vertices can be snapped to that location. |
When reviewing the fixes for an error you will often see multiple rows with the same Resolution Key. Each of these rows either represents one of the features in error or a feature that is coincident with the feature in error. When specifying an action, you will almost always be applying the fix to one or more of the error features. If there are multiple error rows for the fix, you will need to think carefully about which feature you apply the fix to.
Once you’ve determined the fixes for all the issues you want to automate, you’re ready to apply the resolutions. Any remaining issues will need to be resolved manually. The manual resolution process can be facilitated by using the location features in the diagnostics database.
Examples
What follows is a series of examples of resolutions and actions for each topology error.
Missing junction
This error occurs when two features with a different asset type are connected without a junction or device. Each error indicates whether it occurs between the midpoint or endpoint of each line. For two lines to be connected the endpoint of one line must connect to the endpoint, or midspan, on the other line.
Missing junction errors are described in three different ways:
- End/End - The endpoints of two separate lines are coincident. If no junction is created there will be an error in the utility network. This error is typically resolved by creating a feature at the endpoint of the two lines to connect the two features.
- Mid/End - The endpoint of one line connects midspan to another line. If no junction is created there will be an error in the utility network. This error is typically resolved by creating a feature on the endpoint of one line that taps into the second.
- Mid/Mid - The two lines share midspan vertices. These lines are not connected and do not report any errors in the utility network. They are reported for informational purposes.
Midpoint/midpoint coincidence, shown as mid-mid, situations are included for informational purposes only since these features are not considered for connectivity and will not create errors. You do not need to apply resolutions for mid-mid missing junction errors to have an error free topology. These errors are filtered out from the layers using definition queries but are visible if you look at the table directly or remove the definition queries.
The most common resolution to missing junction errors is to create a junction feature at the intersection of the two lines. To perform this resolution, look at the resolutions for the error, you will see at least two different line types in the list. Select only one of the resolutions, set its action to Create, and pick the Create/Update type of the point feature you want to create at that location.
Additional Resources
Address common errors in the utility network (article)
Utility Network Error management – Topology Errors (article)
Utility Network Error Management – Electric topology errors (article)
Gestión de errores de Utility Network – errores de topología de Gas y Pipeline (artículo)
Gestión de errores de Utility Network – errores de topología de Agua (artículo)
Corregir errores de conectividad en una utility network (tutorial)
Acerca de las características de error (ayuda en línea)
Puntos apilados
Esto ocurre cuando dos o más junctions o devices están dentro de la tolerancia xy y en la misma ubicación z. Los registros con error indicarán qué tipos de features están apilados; si solo se lista un tipo, entonces hay múltiples instancias de esa feature apiladas en la ubicación. La columna group key indicará los tipos de lines, si hay alguno, presentes en esa ubicación y puede ayudarte a entender cómo resolver mejor el error.
La resolución más común para este error es dejar una feature en su lugar y eliminar o desplazar las features restantes. Para realizar esta resolución, encuentra todas las point features para el error en la tabla Error Resolutions. Identifica la feature que deseas conservar y establece su acción en Update all but first o Delete all but first.
Si hay diferentes tipos de point features apiladas, establece la acción para las otras resoluciones de puntos como Update All o Delete All.
Usar la acción Delete es una solución fácil pero no se usa comúnmente durante migraciones en producción. Las migraciones en producción típicamente usan las acciones Update all y Update all but first con un desplazamiento xyz para conservar las features originales para revisión posterior. Si estás desplazando múltiples tipos de point features, asegúrate de que sus desplazamientos estén configurados para que no creen puntos apilados en el nuevo desplazamiento. Si hay más de 2 features siendo desplazadas, asegúrate también de especificar un valor Delta Step para garantizar que las features apiladas subsecuentes se desplacen continuamente.
Recursos adicionales
Abordar errores comunes en la utility network (artículo)
Gestión de errores de Utility Network – Errores de topología (artículo)
Gestión de errores de Utility Network – errores de topología eléctrica (artículo)
Gestión de errores de Utility Network – errores de topología de Gas y Pipeline (artículo)
Gestión de errores de Utility Network – errores de topología de Agua (artículo)
Corregir errores de topología en una utility network (tutorial)
Acerca de las características de error (ayuda en línea)
Línea auto-intersectante
Esto ocurre cuando la geometría de una línea se intersecta a sí misma. La feature del lugar del error indicará el vértice específico donde la línea se intersecta consigo misma y la columna group key en el resumen del error indicará si hay otras features presentes en esa ubicación. Es importante notar cuántos tipos diferentes están listados en la columna records in error, porque esto determinará cómo aplicarás las resoluciones para corregirlo.
La resolución más común para este error es eliminar los vértices responsables por la auto-intersección. Si solo hay un tipo en la columna records in error, encuentra la línea para el error en la tabla resolutions y establece su acción a Delete all but first.
La resolución más común para líneas auto-intersectantes es eliminar el vértice que causa la auto-intersección.
Si hay múltiples resoluciones con el mismo tipo en la columna records in error, entonces necesitarás establecer uno de los tipos a Delete all but first y los tipos restantes a Delete all. Esto ocurre cuando una línea auto-intersectante ocurre en el vértice inicial o final de una feature, resultando en que tanto un vértice medio como uno final sean reportados como erróneos. La resolución más común para este problema es establecer la resolución al vértice medio a delete all y establecer la resolución al vértice final a delete all but first. Esto preservará el punto final de la línea mientras elimina los vértices dentro que causan la auto-intersección.
Recursos adicionales
Acerca de las características de error (ayuda en línea)
Herramientas para verificar y reparar geometrías (ayuda en línea)
Vértices duplicados
Esto ocurre cuando una línea tiene dos o más vértices duplicados dentro de la tolerancia xy y con el mismo valor z. La feature del lugar del error indicará la ubicación específica de los vértices duplicados y la columna group key en el resumen del error indicará si hay otras features presentes en esa ubicación.
Los vértices duplicados son a menudo resultado de un error de digitalización; presta atención a cualquier feature cercana al resolver estos errores.
La resolución más común para este error es eliminar los vértices duplicados. Para realizar esta resolución, encuentra la fila del error en la tabla fixes y establece la acción para todas las line features a Delete all but first. Cuando se aplican las resoluciones del error, esto eliminará todos los vértices duplicados para las features especificadas, dejando intactos los vértices únicos para la línea.
La resolución más común para vértices duplicados es eliminar los vértices duplicados
Recursos adicionales
Acerca de las características de error (ayuda en línea)
Herramientas para verificar y reparar geometrías (ayuda en línea)
Geometría vacía
Este error ocurre cuando una line feature tiene una geometría vacía. La única resolución automatizada para este error es eliminar la feature, ya que una geometría vacía no puede ser actualizada.
La resolución más común para este error es dibujar manualmente la geometría de la feature, si puedes identificar su ubicación. Si deseas eliminar automáticamente esta feature mediante una acción en la herramienta Error Resolution, encuentra la fila con este código de error y establece su acción a Delete all.
La resolución más común para un error por geometría vacía es eliminar la feature usando la acción Delete all.
Recursos adicionales
Acerca de las características de error (ayuda en línea)
Herramientas para verificar y reparar geometrías (ayuda en línea)
Longitud del shape
Este error ocurre cuando una line feature tiene longitud cero o casi cero.
Los errores por longitud inválida ocurren cuando el vértice inicial/final son idénticos o casi idénticos.
La resolución más común para este error es redibujar manualmente la línea para corregir la geometría. Si deseas eliminar automáticamente esta feature mediante una acción en Error Resolution table, encuentra la fila con este código y establece su acción a Delete all.
La resolución más común para este error es eliminar la line feature.
Recursos adicionales
Acerca de las características de error (ayuda en línea)
Herramientas para verificar y reparar geometrías (ayuda en línea)
Dispositivo terminal midspan
Esto ocurre cuando un device que tiene configuración terminal está dibujado midspan sobre una línea.
Cuando un device tiene terminals debe dividir la línea a la que está conectado; si no, se creará un error topológico.
La resolución más común para este problema es dividir la línea donde el device está conectado. Actualmente las herramientas no pueden aplicar una resolución automática; sin embargo, puedes usar el modo By Feature del Split tool para dividir múltiples features a la vez.
No hay acción disponible para dividir líneas automáticamente. Si quieres dividir líneas debes usar Split tool en ArcGIS Pro.
Una forma precisa para identificar las features que necesitan ser divididas es usar Select By Location tool con Relationships: Contains Clementini and Within Clementini.
Usa Select By Location tool para limitar la operación split solo a líneas que necesitan ser divididas.
Recursos adicionales
Gestión de errores Utility Network – Errores topológicos (artículo)
Utility Network Error Management – Electric topology errors (article)
Utility Network Error Management – Gas and Pipeline Topology errors (article)
Utility Network Error Management – Water topology errors (article)
Fix topology errors in a utility network (tutorial)
About error features (online help)
Ambiguous connectivity
This occurs when there is more than one rule available for a potential connection between features. This kind of error is not common when using the Migrate To Utility Network tool unless you add rules to your network and/or change an asset type’s terminal configuration.
Am
Ambiguous connectivity happens when there are multiple rules that allow features to connect, like when a device has multiple terminals.
The most common cause for this error is a line connected to a device with terminal with multiple rules, in which case the resolution is to specify which terminal the line is connected to using the Modify Terminal Connections pane.
There is no action to automatically resolve ambiguous connectivity errors, but you can use the Modify Terminal Connections pane to manually resolve the issue.
Note: When modifying the terminal connections of a line always use the Modify Terminal Connections pane, as it will ensure you only select terminals that are valid for the line based on the devices on either end of the line. If you modify terminal connections using the attribute editor or the attributes pane you run the risk of introducing Invalid Terminal errors.
If you have many of these errors, consider using the Assign Terminal Connections tool in the Utility Network Package Toolbox to calculate terminal connections for all the features in the network. Terminals are assigned without respect to any attribution or flow, so while this tool will resolve topology errors, you will need to review and adjust the connections for any devices with a directional terminal configuration.
Additional Resources
Address common errors in the utility network (article)
Utility Network Error management – Topology Errors (article)
Utility Network Error Management – Electric topology errors (article)
Utility Network Error Management – Gas and Pipeline Topology errors (article)
Utility Network Error Management – Water topology errors (article)
Fix connectivity errors in a utility network (tutorial)
Configure rules for a utility network (tutorial)
About error features (online help)
Rule missing
Esto ocurre cuando un punto y una línea están potencialmente conectados pero no existe una regla de unión-arista que lo permita. Este tipo de error no es común al usar la herramienta Migrate to utility network a menos que agregues un nuevo tipo de activo sin añadir una regla correspondiente, elimines reglas existentes o cambies la configuración del terminal de un tipo de activo. Esta verificación no toma en cuenta ninguna regla de arista-unión-arista que definas en tu base de datos.
Los errores de regla faltante ocurren cuando dos entidades intentan conectarse en la utility network, pero no hay una regla que permita que estén conectadas.
Si se debe permitir que las dos entidades se conecten, la solución es agregar una regla que permita su conexión. Puedes ver una lista de todas las reglas candidatas de unión-arista que pueden ser importadas en el archivo RuleCandidates.csv creado junto con la base de datos de resultados del análisis. Asegúrate de revisar el archivo de reglas antes de importarlo para garantizar que todas las reglas sean correctas para tus datos y para evitar introducir conectividad ambigua involuntariamente. Esto es especialmente importante si ya tienes configuradas reglas de arista-unión-arista.
Usa la herramienta Import Rules para importar el archivo CSV de reglas candidatas creado por la herramienta.
Si no se debe permitir que las dos entidades se conecten, asegúrate de que las entidades tengan los tipos de activos correctos y estén dibujadas correctamente. Puedes lograr esto cambiando manualmente el grupo y tipo de activo de la entidad, o usando la acción Update all en la tabla de resolución para corregir automáticamente los tipos de activos de todas las entidades afectadas.
Puedes usar la acción Update all para actualizar el tipo de activo de las entidades si determinas que están clasificadas incorrectamente.
Si quieres aprender cómo modificar tus reglas de conectividad para mejorar la calidad de los datos, lee el artículo refining your connectivity rules (¡próximamente!).
Recursos adicionales
Abordar errores comunes en la utility network (artículo)
Gestión de errores en Utility Network – Errores de topología (artículo)
Gestión de errores en Utility Network – Errores de topología eléctrica (artículo)
Gestión de errores en Utility Network – Errores de topología en gas y tuberías (artículo)
Gestión de errores en Utility Network – Errores de topología en agua (artículo)
Corregir errores de conectividad en una utility network (tutorial)
Configurar reglas para una utility network (tutorial)
Acerca de las entidades con error (ayuda en línea)
Refinando tus reglas de conectividad (tutorial)
Terminal inválido
Esto ocurre cuando el campo from terminal id o to terminal id de una línea no es válido para uno de los dispositivos o uniones a los que está conectado. Este tipo de error no es común al usar la herramienta Migrate To Utility Network a menos que asignes terminales manualmente sin usar la herramienta Assign Terminal Connections.
El error terminal inválido ocurre cuando una línea está conectada a un dispositivo que tiene terminales, pero hace referencia a un terminal que no existe.
La solución más común a este error es actualizar el terminal en la línea a un valor válido usando el panel Modify Terminal Connections.
Usa el panel Modify Terminal Connections para resolver manualmente cualquier ID de terminal inválido. La interfaz solo mostrará conexiones válidas para las entidades.
Recursos adicionales
Abordar errores comunes en la utility network (artículo)
Gestión de errores en Utility Network – Errores de topología (artículo)
Gestión de errores en Utility Network – Errores de topología eléctrica (artículo)
Gestión de errores en Utility Network – Errores de topología en gas y tuberías (artículo)
Gestión de errores en Utility Network – Errores de topología en agua (artículo)
Corregir errores de conectividad en una utility network (tutorial)
Configurar reglas para una utility network (tutorial)
Acerca de las entidades con error (ayuda en línea)
Política de conectividad del edge
Este error ocurre cuando una línea con edge connectivity policy de End Vertex tiene una línea, unión o dispositivo conectado a uno de sus vértices intermedios. Los modelos creados por la herramienta Migrate To Utility Network tienen una política predeterminada de conectividad Any Vertex
Additional Resources
Fix topology errors in a utility network (tutorial)
Configure rules for a utility network (tutorial)
About error features (online help)
Subnetwork tap
This error occurs when a feature with the subnetwork tap category is drawn at the end point of a single line or at the endpoint intersection of two lines. This kind of error is not possible when using the Migrate To Utility Network tool unless you manually assign the subnetwork tap category to an asset type.
Subnetwork tap features have certain cartographic requirements that must be met. Resolving this issue requires you to make a choice about whether a feature should be a subnetwork tap, and how it should be drawn within the system.
If the junction or device feature is improperly classified, you can use the error resolution table to correct its asset group and asset type. Otherwise, you must manually resolve this error by adjusting the location of the junction/device, so it is no longer at the endpoint of both lines. You can learn more about the topological requirements of subnetwork taps by reading the additional resources below.
Additional Resources
About error features (online help)
Subnetwork taps (online help)
Vertex Within Tolerance
This error occurs when two or more features have common vertices that are close enough to each other to be considered coincident with a spatial query, but not close enough to be consistently topologically connected. It is recommended that these features be snapped to share a common location to ensure they are consistently connected and traceable.
This issue will not be reported if there are other errors, like stacked point features, present at the same location.
Note: If there is only a single resolution available for this error summary that means there are multiple features, or vertices, at that location. In this case you should set the resolution to anchor. This will use the first object in the resolution as the anchor and the remaining objects for that resolution will be snapped.
Additional Resources
None
