TopologiasDesdeTabla
TopologiasDesdeTabla es una aplicación de consola que crea polígonos a partir de las topologías de una tabla de códigos y los añade a cada archivo .bind de una carpeta. Hace fuera de Digi3D.AI lo que hace la orden TOPOLOGIA_A_POLIGONO. Si una topología proyecta la coordenada Z sobre un modelo digital del terreno (MDT), el programa obtiene esa Z de un archivo .mdt.
Código: TopologiasDesdeTabla en GitHub.
Compilar
El proyecto usa .NET 10 y estos paquetes:
| Paquete | Versión |
|---|---|
Digi21.DigiNG |
26.2.0 |
Digi21.DigiNG.Topology |
26.1.0 |
Digi21.DigiNG.Dtm |
26.0.0 |
Digi21.DigiNG.IO.BinDouble |
26.0.1 |
El programa requiere Digi3D.AI 2027.0.0.428 o posterior instalado en el equipo. Compila el proyecto desde la carpeta del repositorio:
dotnet build TopologiasDesdeTabla\TopologiasDesdeTabla.csproj -c Release -o C:\Herramientas\TopologiasDesdeTabla
Ejecutar
C:\Herramientas\TopologiasDesdeTabla\TopologiasDesdeTabla.exe <carpeta> <tabla.tab.xml> [modelo.mdt] [topología...]
| Argumento | Descripción |
|---|---|
<carpeta> |
Carpeta cuyos archivos .bind se procesan, en orden alfabético sin distinguir mayúsculas de minúsculas. El programa no procesa los archivos de las subcarpetas. |
<tabla.tab.xml> |
Archivo de la tabla de códigos con las topologías. |
[modelo.mdt] |
Archivo .mdt sobre el que se proyectan los polígonos. El programa interpreta el tercer argumento como un MDT solo si su extensión es .mdt; en otro caso es el nombre de una topología. Sin MDT, los vértices conservan su Z original. |
[topología...] |
Nombres de las topologías que se procesan. Si no se indica ninguna, el programa procesa todas las de la tabla de códigos. |
Ejemplos:
TopologiasDesdeTabla C:\Datos tabla.tab.xml
TopologiasDesdeTabla C:\Datos tabla.tab.xml terreno.mdt EDIFICIO ACERA
Si faltan argumentos, el programa escribe el formato de uso en la salida de error y termina con código 1. También termina con código 1 si la carpeta no existe, si la tabla de códigos no define ninguna topología o si falla la carga de la tabla o del MDT.
Qué hace con cada archivo
Para cada archivo .bind, el programa escribe Archivo <ruta> y lo abre en lectura y escritura con la tabla de códigos. Guarda en una lista las entidades que tiene el archivo al abrirlo. Para cada topología, en el orden indicado:
- Obtiene la definición de la topología de la tabla. Si el nombre no existe, escribe
[<topología>] No se puede obtener la topología: <mensaje>en la salida de error y pasa a la topología siguiente. - Analiza las entidades de la lista con
AnalyzeTopologyy escribe por consola los avisos del análisis: líneas con puntos dobles, puntos o líneas con menos de dos vértices, contornos que no encierran ningún área, recintos sin centroide, recintos con varios centroides, centroides fuera de todo recinto y entidades que no forman parte de ningún recinto válido. Cada aviso empieza por[<topología>] Aviso:e indica, cuando procede, las coordenadas X e Y próximas al problema detectado. - Crea los polígonos de los recintos con
CreatePolygons, que proyecta la Z sobre el MDT cuando la definición de la topología establece que se proyecte la coordenada Z sobre un MDT. Los recintos sin centroide no generan polígono. - Añade cada polígono al archivo con
Addy lo libera conDispose. - Escribe
[<topología>] <n> recintos, <m> polígonos añadidos.
El análisis de cada topología usa la lista de entidades guardada al abrir el archivo, así que los polígonos que el programa añade para una topología no forman parte del análisis de las topologías siguientes.
Errores y casos especiales
- Errores de una topología. Cualquier excepción del análisis, de la creación de los polígonos o de la escritura se muestra como
[<topología>] Se localizó el siguiente error: <mensaje>en la salida de error, y el programa continúa con la topología siguiente.AnalyzeTopologylanza una excepción, después de escribir los avisos, si el archivo tiene líneas con puntos dobles o entidades con un solo punto. - Condiciones de exclusión. El programa no omite las topologías que tienen códigos con condición de exclusión, ni define un delegado para evaluar las condiciones de exclusión. Si una topología tiene códigos con condiciones de exclusión,
AnalyzeTopologylanzaArgumentExceptiony el programa escribe el error de la topología. Para evaluar las condiciones de exclusión, asigna a EvaluateExcludeCondition un delegado propio que interprete la expresión de Python. - Archivos de solo lectura. Si un archivo tiene el atributo de solo lectura,
BinDoublelo abre en solo lectura sin lanzar ninguna excepción yAddfalla al añadir el primer polígono. El programa escribe el error de cada topología que tenga polígonos que añadir y no modifica el archivo. El programa continúa procesando los demás archivos. - Errores de un archivo. Si falla la apertura de un archivo, el programa escribe
Se localizó el siguiente error: <mensaje>y continúa con el archivo siguiente. - Ejecuciones repetidas. El programa conserva los polígonos que ya tiene el archivo y añade los que genera. Si lo ejecutas dos veces sobre el mismo archivo, la segunda ejecución añade otra vez los mismos polígonos.
- Sistema de coordenadas.
DigitalTerrainModel.Projectno transforma coordenadas. El MDT y los archivos.bindtienen que estar en el mismo sistema de coordenadas horizontal. El sistema del MDT está enDigitalTerrainModel.CoordinateSystemWkty el del archivo.bindenBinDouble.Wkt.
Cómo funciona
Si se proporciona un archivo .mdt, el programa lo abre una sola vez y añade el modelo a una colección DigitalTerrainModelCollection con la etiqueta vacía para utilizar ese modelo con cualquier regla de proyección. El programa pasa modelos.Project a CreatePolygons:
var modelos = new DigitalTerrainModelCollection();
using var modelo = rutaMdt is null ? null : DigitalTerrainModel.Open(rutaMdt);
if (modelo is not null)
modelos.Add(modelo, "");
// La lista entidades contiene las entidades presentes al abrir el archivo;
// el análisis de las topologías siguientes no incluye los polígonos añadidos durante esta ejecución.
using var archivo = new BinDouble(rutaArchivo, tabla);
var entidades = archivo.ToList();
// Dentro de CreaYAnadePoligonosDeTopologia:
var recintos = entidades.AnalyzeTopology(definicion, manejadoresAvisosAnalisisTopologico).ToList();
var polígonos = recintos.CreatePolygons(definicion, modelos.Project);
foreach (var polígono in polígonos)
{
archivo.Add(polígono);
polígono.Dispose();
}
Referencias de la API: TopologyAnalyzer, TopologyAnalysisHandlers y DigitalTerrainModel.