TopologyAnalysisHandlers

Espacio de nombres: Digi21.DigiNG.Topology
Ensamblado: Digi21.DigiNG.Topology

Delegados que TopologyAnalyzer.AnalyzeTopology invoca mientras forma la topología de una TopologyDefinition. Los delegados de notificación pueden ser null. EvaluateExcludeCondition es obligatorio si algún código de la topología tiene una condición de exclusión que no está vacía.

Requiere el paquete Digi21.DigiNG.Topology 26.1.0 y Digi3D.AI 2027.0.0.428 o posterior.

public sealed class TopologyAnalysisHandlers

Constructores

public TopologyAnalysisHandlers()

Crea un objeto con todos los delegados a null.

Propiedades

Cada propiedad se puede leer y asignar. AnalyzeTopology lee las propiedades una sola vez, al empezar: asignar una propiedad durante el análisis no afecta al análisis en curso.

Propiedad Descripción
Action<int> ProgressChanged Recibe el porcentaje de avance, de 0 a 100, de cada fase del análisis: la formación de los anillos y la asignación de huecos y centroides a los anillos. El porcentaje vuelve a empezar en 0 en cada fase.
Action<ReadOnlyLine> LineWithDoublePoints Recibe cada línea con un código de la topología cuyos dos primeros vértices, o sus dos últimos, tienen la misma X e Y. Si se notifica alguna línea, AnalyzeTopology lanza una excepción cuando termina el análisis.
Action<Entity> EntityWithFewerThanTwoVertices Recibe cada punto y cada línea con menos de dos vértices que tiene un código de la topología. Si se notifica alguna entidad, AnalyzeTopology lanza una excepción cuando termina el análisis.
Action<IEnumerable<ReadOnlyLine>> RingWithoutArea Recibe las líneas de cada anillo que no encierra ningún área. Ese anillo no forma un polígono.
Action<ClosedLoopWithHoles> PolygonWithoutCentroid Recibe cada polígono que no contiene ningún centroide. Solo se invoca si TopologyDefinition.ReportPolygonsWithoutCentroid es true; si es false, AnalyzeTopology descarta esos polígonos sin notificarlos.
Action<IEnumerable<ReadOnlyText>> DuplicatedCentroids Recibe los centroides de cada polígono que contiene más de un centroide. Si ninguna entidad tiene un código de la topología, de modo que no se puede formar ningún anillo, recibe todos los textos que se han leído como centroides.
Action<IEnumerable<ReadOnlyText>> CentroidsWithoutPolygon Recibe una sola vez los centroides que no están dentro de ningún polígono.
Action<Entity> EntityNotInValidPolygon Recibe cada línea o polígono que tiene un código con la relación Required o GuaranteesPolygon y no forma parte de ningún polígono válido. Solo se invoca si ReportPolygonsWithoutCentroid es false. Recibe la misma instancia que se pasó en la colección entities.
Func<Entity, string, bool> EvaluateExcludeCondition Evalúa la condición de exclusión de un código para una entidad que tiene ese código, y devuelve true para excluir la entidad de la topología. Recibe la entidad y la condición, que es una expresión de Python. Es obligatorio si algún código de la topología tiene una condición de exclusión que no está vacía.

Excepciones lanzadas por los delegados

Si un delegado lanza una excepción, AnalyzeTopology deja de invocar delegados, deja que termine el análisis nativo y lanza esa excepción cuando termina.

Condiciones de exclusión fuera de Digi3D.AI

Las condiciones de exclusión de los códigos son expresiones de Python que Digi3D.AI evalúa con su intérprete. AnalyzeTopology no evalúa las condiciones de exclusión por sí mismo: el programa tiene que evaluar la expresión con su propio código en EvaluateExcludeCondition, o no analizar las topologías que tienen alguna condición de exclusión. El ejemplo TopologiasDesdeTabla no define el delegado EvaluateExcludeCondition y muestra el error que produce una topología con condiciones de exclusión.

Ejemplo

Este programa forma una topología de una tabla de códigos sobre un archivo .bind y cuenta los errores que notifica cada delegado:

using Digi21.DigiNG.DigiTab;
using Digi21.DigiNG.IO.BinDouble;
using Digi21.DigiNG.Topology;

if (args.Length != 3)
{
    Console.WriteLine("Uso: Recintos <archivo.bind> <tabla.tab.xml> <nombre de la topología>");
    return 1;
}

using var tabla = DigiTab.Load(args[1]);
using var topología = tabla.GetTopology(args[2]);

if (topología is null)
{
    Console.WriteLine($"La tabla de códigos no define la topología {args[2]}.");
    return 1;
}

using var archivo = new BinDouble(args[0], tabla, true);
var entidades = archivo.ToList();

int numeroDeAnillosSinArea = 0, numeroDePoligonosSinCentroide = 0, numeroDePoligonosConVariosCentroides = 0, numeroDeCentroidesSinPoligono = 0;
var manejadores = new TopologyAnalysisHandlers
{
    RingWithoutArea = líneas => numeroDeAnillosSinArea++,
    PolygonWithoutCentroid = recinto => numeroDePoligonosSinCentroide++,
    DuplicatedCentroids = textos => numeroDePoligonosConVariosCentroides++,
    CentroidsWithoutPolygon = textos => numeroDeCentroidesSinPoligono += textos.Count(),
};

try
{
    var recintos = entidades.AnalyzeTopology(topología, manejadores).ToList();
    Console.WriteLine($"{recintos.Count} polígonos; {numeroDeAnillosSinArea} anillos sin área; {numeroDePoligonosSinCentroide} polígonos sin centroide; " +
        $"{numeroDePoligonosConVariosCentroides} polígonos con varios centroides; {numeroDeCentroidesSinPoligono} centroides fuera de un polígono.");
}
catch (Exception ex)
{
    Console.WriteLine(ex.Message);
    return 1;
}

return 0;