Herramientas

Este capítulo proporciona una referencia completa de las herramientas disponibles en el plugin de QGIS. Puede acceder a las herramientas desde la barra de herramientas o el Menú principal en Plugins:

Herramientas de EPA-SWMM

El complemento incluye herramientas para integrarse con el Storm Water Management Model (SWMM) de la EPA, lo que permite crear archivos de entrada de SWMM directamente desde capas de QGIS e importar archivos SWMM existentes.

Ventana de diálogo

Importar archivo EPA-SWMM

Esta herramienta importa un archivo EPA-SWMM INP o HYC existente en QGIS como capas vectoriales.

Crear StormDrainPolygon

Esta herramienta crea representaciones poligonales alrededor de los nodos de drenaje pluvial.

Crear archivo de proyecto SWMM

Esta herramienta crea un archivo INP compatible con EPA-SWMM a partir de capas de QGIS.

Controles de diálogo

Importar archivo EPA-SWMM

Control	Tipo	Descripción
EPA-SWMM .INP FILE OR .HYC FILE	Campo	Especifique la ruta al archivo de entrada SWMM (INP o HYC).
...	button	Abre un cuadro de diálogo de archivo para buscar el archivo SWMM.
Create StormDrainPolygon Layer	checkbox	Si está marcado, crea representaciones poligonales alrededor de los nodos importados.
Rectangles Size	Campo	Define el tamaño de los polígonos rectangulares (predeterminado: 5 unidades). Habilitado solo si la casilla de verificación "Crear capa StormDrainPolygon" está marcada.
Ok	button	Ejecuta el proceso de importación.
Close	button	Cierra el diálogo.

Crear StormDrainPolygon

Control	Tipo	Descripción
Rectangle Size	Campo	Define el tamaño de los polígonos rectangulares (predeterminado: 5 unidades).
Creating New StormDrainPolygon Layer	radioButton	Elimina cualquier capa StormDrainPolygon existente y crea una nueva.
Adding to current StormDrainPolygon Layer	radioButton	Agrega nuevos polígonos a la capa StormDrainPolygon existente, si está presente.
OK	button	Ejecuta la creación del polígono.
Close	button	Cierra el diálogo.

Crear archivo de proyecto SWMM

Control	Tipo	Descripción
Nodes Layer	dropdown	Selecciona la capa de puntos que contiene los nodos de unión SWMM.
Node Names Field	dropdown	Selecciona el campo que contiene identificadores de nodo únicos.
Node Max Depth Field	radioButton	Utiliza un campo de la capa de nodos para obtener la máxima profundidad.
Node Max Depth Value	Campo	Entrada para el valor de profundidad máxima (habilitado solo cuando se selecciona el botón de opción correspondiente, con valores predeterminados basados en las unidades del mapa).
One Max. Depth for All Nodes	radioButton	Utiliza un valor único para la profundidad máxima para todos los nodos.
DEM Layer	dropdown	Selecciona la capa ráster para datos de elevación.
INP File	Campo	Especifica la ubicación de salida para el archivo INP de SWMM.
...	button	Abre un cuadro de diálogo de archivo para elegir la ubicación del archivo de salida.
Close	button	Cierra el diálogo.
Ok	button	Ejecuta la creación del archivo INP.

Flujo de trabajo

Importar archivo EPA-SWMM

1. Comprueba si hay un proyecto RiverFlow2D.

2. Lee el archivo EPA-SWMM especificado (INP o HYC).

3. Extrae información del nodo (coordenadas, ID, atributos).

4. Crea una capa de puntos StormDrain en el directorio de formas del proyecto.

5. Si se marca "Crear capa StormDrainPolygon", crea polígonos alrededor de los nodos.

6. Agrega las capas al grupo COMPONENTES en QGIS.

7. Aplica estilo y etiquetado a las capas importadas.

Crear StormDrainPolygon

1. Comprueba si hay un proyecto RiverFlow2D.

2. Localiza la capa de puntos StormDrain.

3. Extrae coordenadas e ID de nodos.

4. Crea polígonos rectangulares basados en el tamaño especificado.

5. Crea una nueva capa o la agrega a una existente, según el botón de opción seleccionado.

6. Agrega la capa al grupo COMPONENTES en QGIS.

7. Etiqueta los polígonos con ID de nodo.

Crear archivo de proyecto SWMM

1. Seleccione los nodos y las capas DEM, junto con los campos obligatorios en los controles del cuadro de diálogo.

2. Defina la profundidad máxima utilizando un campo o un valor único.

3. Seleccione la ruta de salida para el archivo INP.

4. Haga clic en Aceptar para generar el archivo de proyecto SWMM.

Requisitos

Importar archivo EPA-SWMM

• Un proyecto RiverFlow2D activo.

• Un archivo EPA-SWMM INP o HYC válido.

Crear StormDrainPolygon

• Un proyecto RiverFlow2D activo.

• Una capa de puntos StormDrain que contiene los nodos.

Crear archivo de proyecto SWMM

• Un proyecto RiverFlow2D activo.

• Una capa de nodos con identificadores únicos.

• Una capa DEM que cubre el área del nodo.

Detalles técnicos

Importar archivo EPA-SWMM

Soporte de formato de archivo

• Archivos INP: Archivos de entrada estándar de EPA-SWMM.

• Archivos HYC: Formato específico de Hydronia para redes de drenaje pluvial.

Las capas importadas se guardan en el directorio shape de la escena del proyecto actual.

Consideraciones del sistema de coordenadas

La herramienta comprueba si hay discrepancias de sistema de coordenadas entre el archivo INP y el proyecto de QGIS, y advierte al usuario si las unidades difieren.

Crear StormDrainPolygon

La capa StormDrainPolygon se guarda en el directorio shape de la escena del proyecto actual.

Crear archivo de proyecto SWMM

Estructura del archivo de salida

El archivo INP generado incluye las secciones: TITLE, OPTIONS, EVAPORATION, JUNCTIONS, INFLOWS, REPORT, MAP y COORDINATES.

Consulte la sección Output Files del Manual de Referencia de RiverFlow2D for QGIS  para más detalles.

Método de procesamiento

1. Extrae puntos de la capa de nodos.

2. Muestra el DEM en cada punto.

3. Calcula elevaciones invertidas (elevación DEM - profundidad máxima).

4. Formatea los datos según las especificaciones SWMM INP.

5. Escribe el archivo completo.

Notas de uso

• Asegúrese de que los nodos estén colocados correctamente en la capa de puntos.

• El DEM debe cubrir todas las ubicaciones de los nodos.

• Las unidades de salida (pies o metros) están determinadas por las unidades del proyecto QGIS.

• El archivo INP es una estructura básica, personalizable aún más en EPA-SWMM.

• Solo se crean nodos; se deben agregar otros elementos (conductos, subcuencas) en EPA-SWMM.

Integración con el Módulo UDSWMM

La herramienta EPA-SWMM está diseñada para trabajar junto con el módulo UDSWMM y ofrecer capacidades completas de modelación de drenaje urbano.

Consulte la sección Output Files del Manual de Referencia de RiverFlow2D for QGIS  para más detalles.

Herramienta de evaluación hidroeconómica de inundaciones

La herramienta Hydro-Economic Evaluation of Flood (HEEF) brinda funcionalidad para evaluar el daño económico potencial por inundaciones. Esta sección detalla cada componente del conjunto de herramientas HEEF, organizado por ventanas de diálogo y sus controles.

Ventana de diálogo

Base de datos de funciones HEEF

Este es el punto de entrada principal para administrar las funciones de vulnerabilidad usadas en la evaluación de daños por inundación.

Tipo de función de vulnerabilidad

Este diálogo administra las categorías de funciones de vulnerabilidad.

Función de vulnerabilidad

Este diálogo permite explorar y administrar funciones de vulnerabilidad individuales.

Configuración de varios edificios

El Editor de Estructuras permite asignar funciones de vulnerabilidad a múltiples polígonos de edificios simultáneamente:

Diálogo de selección de funciones (HEEF DB)

Este diálogo permite seleccionar funciones de vulnerabilidad para asignarlas a edificios.

Controles de diálogo

Base de datos de funciones HEEF

Control	Tipo	Descripción
Vulnerability Function Type	button	Abre el cuadro de diálogo Administrador de tipos de funciones de vulnerabilidad.
Vulnerability Function	button	Abre el cuadro de diálogo Administrador de funciones de vulnerabilidad.

Tipo de función de vulnerabilidad

Control	Tipo	Descripción
ID	Campo	Muestra el identificador numérico del tipo de función.
Description	Campo	Muestra la descripción del tipo de función.
Table Name	Campo	Muestra el archivo de datos asociado para este tipo de función.
Previous	button	Navega al tipo de función anterior en la base de datos.
Next	button	Navega al siguiente tipo de función en la base de datos.
Add	button	Crea un nuevo tipo de función (requiere los permisos adecuados).
Del	button	Elimina el tipo de función que se muestra actualmente.
Close	button	Cierra el cuadro de diálogo y regresa a la ventana principal de la base de datos.

Función de vulnerabilidad

Control	Tipo	Descripción
Type Function	dropdown	Selecciona la categoría de esta función.
ID	Campo	Muestra el identificador único de la función seleccionada.
Description	Campo	Muestra la descripción del tipo de edificio/estructura.
Material	Campo	Muestra el material de construcción.
Reference Photo	Campo	Muestra la ruta a una imagen del tipo de estructura.
Structure Cost	Campo	Muestra el costo estimado de la estructura física.
Content Cost	Campo	Muestra el costo estimado de los contenidos dentro de la estructura.
Source	dropdown	Muestra la referencia bibliográfica de los datos de la función.
Units	dropdown	Muestra el sistema de unidades (métricas o inglesas).
Previous	button	Navega a la función anterior en la base de datos.
Next	button	Navega a la siguiente función en la base de datos.
Add	button	Crea una nueva función de vulnerabilidad.
Del	button	Elimina la función mostrada actualmente.
Close	button	Cierra el cuadro de diálogo y regresa a la ventana principal de la base de datos.

Configuración de varios edificios

Control	Tipo	Descripción
Vulnerability Function ID	text field	Muestra el ID de la función de vulnerabilidad seleccionada.
Database	button	Abre el cuadro de diálogo de selección de función de vulnerabilidad para elegir una función de la base de datos.
Description	Área de texto	Muestra o permite editar la descripción de la función de vulnerabilidad seleccionada.
Building cost	text field	Permite ingresar el valor monetario de la estructura del edificio.
Content cost	text field	Permite introducir el valor monetario del contenido del edificio.
Function value (tab)	Pestaña	Muestra la tabla de valores de la función de vulnerabilidad.
Update Function File	button	Actualiza el archivo de función con cualquier cambio realizado en los valores de la función.

Diálogo de selección de funciones (HEEF DB)

Control	Tipo	Descripción
Vulnerability Function Type	dropdown	Selecciona la categoría de función.
Vulnerability Function	dropdown	Selecciona una función específica dentro de la categoría elegida.
Description	Campo	Muestra información sobre la función seleccionada.
Graph Function	button	Muestra una representación gráfica de la función seleccionada. Para funciones de daño en profundidad: muestra un gráfico 2D de profundidad versus porcentaje de daño. Para funciones de profundidad-velocidad-daño: muestra un gráfico de superficie 3D de profundidad, velocidad y daño.
Reference Photo	button	Muestra una fotografía del tipo de edificio/estructura (si está disponible).
OK	button	Confirma la selección y regresa al Editor de estructuras.
Close	button	Cancela la selección y regresa al Editor de estructuras.

Flujo de trabajo

Configuración de varios edificios

1. Seleccione uno o más polígonos de edificios en el lienzo del mapa QGIS.

2. Abra el cuadro de diálogo Editor de estructuras.

3. Seleccione una función de vulnerabilidad usando el botón Base de datos.

4. Opcionalmente ajuste los costos de estructura y contenido.

5. Haga clic en Aceptar para aplicar la función de vulnerabilidad a todos los edificios seleccionados.

Requisitos

• La herramienta HEEF requiere un proyecto RiverFlow2D activo.

• Las entidades poligonales de edificios deben seleccionarse antes de abrir el Editor de estructuras.

• La herramienta admite unidades métricas e inglesas para profundidades y velocidades.

• Cuando se hace clic en el botón Aceptar en el Editor de estructuras, los datos de la función se aplican a todos los edificios seleccionados y la simbología categorizada se aplica a la capa del edificio.

Detalles técnicos

Estructura de la base de datos

La base de datos de funciones de vulnerabilidad está organizada en varias tablas basadas en texto:

• t_tfd.txt: Contiene definiciones de tipos de funciones.

• t_head_c01.txt: Contiene categorías de estructura y materiales con costos.

• t_fuentes.txt: Contiene referencias de fuentes bibliográficas.

• Archivos de datos de funciones individuales: contienen las curvas de daño reales.

• Carpeta img/: Contiene fotografías de referencia de tipos de edificios.

Formatos de datos de función

• Depth-Damage Functions (Type 01): Almacena pares de valores de profundidad y porcentajes de daño correspondientes.

• Depth-Velocity-Damage Functions (Type 02): Almacena matrices de profundidades, velocidades y porcentajes de daño correspondientes en una relación 3D.

Herramienta para importar archivos de múltiples fuentes

La herramienta Import Multi Sources File permite importar datos de fuentes puntuales desde archivos externos al proyecto actual como una capa vectorial de QGIS. Esta sección detalla la interfaz de la herramienta, el flujo de trabajo y la implementación técnica.

Ventana de diálogo

Controles de diálogo

Control	Tipo	Descripción
Multi Sources File	Campo	Ruta al archivo de datos de múltiples fuentes que se importará.
...	button	Abre un cuadro de diálogo de archivo para buscar el archivo de múltiples fuentes.
Creating new Source layer	radioButton	Cuando se selecciona, crea una nueva capa de Fuentes, eliminando cualquier capa existente.
Adding to current Source Layer	radioButton	Cuando se selecciona, agrega puntos a la capa de Fuentes existente (habilitada solo si existe una capa de Fuentes).
Close	button	Cierra el cuadro de diálogo sin realizar cambios.

Flujo de trabajo

1. La herramienta primero busca un proyecto RiverFlow2D activo.

2. El usuario selecciona un archivo de múltiples fuentes usando el cuadro de diálogo del archivo.

3. Según la opción del botón de opción seleccionada:

   • Si se selecciona "Crear nueva capa de origen", cualquier capa de origen existente se elimina del proyecto y se elimina del disco.

   • Si se selecciona "Agregar a la capa de origen actual", se utiliza la capa de orígenes existente (esta opción solo está habilitada si existe una capa de orígenes).

4. La herramienta lee el archivo de múltiples fuentes y:

   • Extrae el número de fuentes de la primera línea.

   • Para cada fuente, lee el ID, las coordenadas X/Y y el archivo asociado.

   • Crea una entidad de puntos para cada fuente.

5. La capa tiene un estilo con símbolos de puntos rojos y está etiquetada usando el campo SOURCEID.

6. La capa se agrega al grupo COMPONENTES en el árbol de capas QGIS.

7. La configuración se aplica al formulario de atributos de la capa:

   • El campo SOURCETYPE está configurado con un mapa de valores (1: Descarga vs Tiempo, 2: Profundidad de la tabla de clasificación vs Q).

   • El campo FILENAME está configurado con un widget de recurso externo.

   • Se adjuntan a la capa un formulario de interfaz de usuario personalizado y un script de Python para una funcionalidad avanzada.

8. Se muestra un mensaje de confirmación cuando se completa la importación.

Requisitos

• Se requiere un proyecto RiverFlow2D activo.

• El archivo de múltiples fuentes debe seguir el formato especificado.

• La herramienta agrega la capa a un grupo COMPONENTES en el árbol de capas, creando el grupo si no existe.

• La capa utiliza el sistema de referencia de coordenadas del proyecto.

• La capa Fuentes se crea en el directorio shape del proyecto.

Detalles técnicos

Formato de archivo

El archivo multifuente debe seguir este formato:

• Primera línea: Número de fuentes (entero)

• Líneas siguientes (una por fuente): ID de fuente Coordenada X Coordenada Y Nombre de archivo

Ejemplo:

3
Fuente1 125,5 345,7 discharge1.txt
Fuente2 220,8 410,2 discharge2.txt
Fuente3 180,3 275,9 discharge3.txt

Integración con RiverFlow2D

Cada punto representa una fuente o sumidero donde el agua entra o sale del dominio del modelo. Los puntos están asociados con archivos que definen las características del caudal:

• Discharge vs Time (Type 1): Archivos que contienen series temporales de valores de descarga.

• Rating Table (Type 2): Archivos que definen la relación entre la profundidad del agua y el caudal.

La capa incluye una interfaz de formulario personalizada que facilita la asignación y edición de propiedades de las fuentes directamente en QGIS.

Herramienta para importar capas de RF2D

La herramienta Import RF2D Layers permite importar varios componentes y archivos de datos de RiverFlow2D en QGIS como capas vectoriales y ráster. Esta herramienta integral admite múltiples formatos de archivo específicos del modelado hidrodinámico y permite integrar componentes de simulación con datos GIS.

Ventana de diálogo

Controles de diálogo

Control	Tipo	Descripción
Component Selector	dropdown	Lista desplegable para seleccionar qué componente de RiverFlow2D importar. Las opciones incluyen TriMesh, esquema de dominio, condiciones de contorno, valores de n de Manning y muchas otras.
Import	button	Ejecuta el proceso de importación para el componente seleccionado.
Close	button	Cierra el cuadro de diálogo sin realizar cambios.

Flujo de trabajo

1. La herramienta primero busca un proyecto RiverFlow2D activo y recupera el sistema de referencia de coordenadas del proyecto.

2. El usuario selecciona un tipo de componente de la lista desplegable.

3. Cuando se hace clic en "Import", la herramienta realiza uno de los siguientes flujos de trabajo:

   • Si se selecciona "Importar todo el proyecto", la herramienta intenta importar todos los componentes disponibles desde el directorio del proyecto en secuencia, verificando la existencia de cada tipo de archivo.

   • Para selecciones de componentes individuales, la herramienta abre un cuadro de diálogo de archivo con el filtro de extensión de archivo apropiado, lo que permite al usuario seleccionar el archivo específico para importar.

4. Durante la importación, la herramienta:

   • Comprueba y, opcionalmente, elimina cualquier capa existente del mismo tipo.

   • Lee el formato de archivo seleccionado y extrae datos de geometría y atributos.

   • Crea capas vectoriales o ráster apropiadas de QGIS.

   • Aplica simbología y etiquetado según el tipo de capa.

   • Organiza las capas en grupos lógicos en el árbol de capas QGIS

Cuando se importa el proyecto completo, un diálogo de progreso muestra el estado del proceso de importación.

Para algunos tipos de capa, la herramienta crea una interfaz de formulario personalizada para editar atributos, mejorando la capacidad del usuario para modificar los parámetros del modelo directamente en QGIS.

Requisitos

• Se requiere un proyecto RiverFlow2D activo.

• El proyecto debe tener un sistema de referencia de coordenadas definido.

• Para la importación completa del proyecto, todos los archivos de los componentes deben estar presentes en el directorio del proyecto con las convenciones de nomenclatura esperadas.

• La herramienta requiere acceso de escritura al directorio del proyecto para crear archivos shapefile para las capas importadas.

• Se necesita suficiente memoria al importar mallas grandes (particularmente los componentes TriMesh con muchos elementos).

Detalles técnicos

Tipos de archivos admitidos

La herramienta admite varios tipos de archivo de RiverFlow2D, cada uno de los cuales representa un componente diferente del modelo hidrodinámico:

Component	File Extension	Description
All Project	.FED	Importa todos los componentes RiverFlow2D disponibles desde el directorio del proyecto en una sola operación. Utiliza el archivo FED como punto de partida para localizar otros archivos de proyecto.
TriMesh	.FED	Malla de elementos finitos que define el dominio computacional.
Domain Outline	_domain_outline.exp	Polígono que define el límite del dominio.
Boundary Conditions	_BoundaryConditions.exp	Líneas que definen dónde se aplican las condiciones de contorno.
Manning's n	.MannN2	Zonas de rugosidad para resistencia al flujo.
Manning's nz	.MANNN	Zonas de rugosidad direccionales.
Rain/Evaporation	.LRAIN	Zonas de precipitación y evaporación.
Infiltration	.LINF	Zonas de infiltración del suelo.
Wind	.WIND	Zonas de forzamiento del viento.
Gates	.TGATES	Compuertas y estructuras hidráulicas.
Bridges	.TBRIDGES	Estructuras de puentes dentro del dominio del flujo.
Culverts	.CULVERTS	Estructuras de alcantarillas para encaminamiento de flujos.
Weirs	.TWEIRS	Estructuras de vertedero para control de flujo.
Dam Breach	.TDAMS	Parámetros de modelización de roturas de presas.
Sources/Sinks	.SOURCES	Fuentes y sumideros puntuales dentro del dominio.
Cross Sections	.XSECS	Datos de secciones transversales del río.
Profiles	.PROFILES	Perfiles longitudinales a lo largo de ríos.
Observation Points	.OBS	Ubicaciones para la salida de series temporales.
DEM	_BedElevations.exp	Datos de elevación del lecho para el dominio.

Mejores prácticas

• Antes de importar una nueva versión de un componente existente, se recomienda eliminar primero la capa anterior de QGIS para evitar conflictos.

• La opción "Importar todo el proyecto" proporciona el flujo de trabajo más eficiente al configurar un nuevo proyecto o actualizar un modelo completo.

• Para actualizaciones incrementales o cuando trabaje con componentes específicos, utilice las opciones de importación individuales para apuntar solo a los datos necesarios.

• Después de la importación, verifique que la geometría y los atributos de las capas importadas coincidan con los valores esperados de los archivos de origen.

• Para proyectos grandes, considere importar componentes individualmente en lugar de usar "Importar todo el proyecto" para administrar mejor el uso de la memoria.

Herramienta para recuperar capas

La herramienta Recover Layers permite recuperar capas de componentes de RiverFlow2D que existen en el directorio del proyecto pero han sido eliminadas del lienzo de QGIS. Esta herramienta permite restaurar rápidamente capas del proyecto sin tener que reimportarlas desde sus archivos fuente.

Ventana de diálogo

Controles de diálogo

Control	Tipo	Descripción
Recover Layer List	dropdown	Muestra una lista de capas de proyecto que existen en el directorio del proyecto pero que no están cargadas actualmente en QGIS.
Recover	button	Carga la capa seleccionada desde el directorio del proyecto y la agrega al grupo apropiado en el árbol de capas de QGIS.
Close	button	Cierra el cuadro de diálogo sin recuperar ninguna capa.

Flujo de trabajo

1. Cuando se abre, la herramienta escanea automáticamente la estructura de directorios del proyecto RiverFlow2D activo.

2. La herramienta compara las capas actualmente cargadas en QGIS con los archivos de forma presentes en el directorio shape del proyecto.

3. Cualquier capa que exista como archivo pero que no esté cargada actualmente en QGIS se agrega a la lista "Recover Layer List".

4. El usuario selecciona una capa para recuperar de la lista desplegable.

5. Cuando se hace clic en el botón "Recover", la herramienta:

   • Carga el archivo shapefile desde el directorio del proyecto.

   • Aplica estilos y etiquetado apropiados según el tipo de capa.

   • Para tipos de capas específicos, como condiciones de contorno, configura widgets y formularios de atributos personalizados.

   • Agrega la capa al grupo apropiado en el árbol de capas QGIS (MESH_SPATIAL_DATA, COMPONENTS o OUTPUT_CONTROL)

6. Si no hay capas disponibles para recuperación, el botón "Recover" estará deshabilitado.

Requisitos

• Se requiere un proyecto RiverFlow2D activo.

• El proyecto debe tener una estructura de directorios definida con un subdirectorio shape que contenga los archivos shapefile de los componentes.

• Los archivos shapefile deben seguir las convenciones de nomenclatura estándar para que la herramienta los reconozca.

• El usuario debe tener acceso de lectura al directorio del proyecto para cargar los archivos de forma.

Detalles técnicos

Tipos de capas admitidas

La herramienta puede recuperar una amplia gama de capas de componentes de RiverFlow2D, incluyendo:

• Esquema del dominio

• Componentes de malla (MeshBreakLine, MeshDensityLine, MeshDensityPolygon)

• Condiciones de contorno

• Coeficientes de rugosidad de Manning (Manning N, Manning Nz)

• Estructuras hidráulicas (Puentes, Compuertas, Alcantarillas, Vertederos, Brecha de Presas)

• Componentes ambientales (Infiltración, RainEvap, Viento)

• Fuentes y sumideros

• Componentes de análisis (Secciones Transversales, Perfiles, Puntos de Observación)

• Otros componentes especializados (MultipleDemBoundaries, InitialConcentrations, InternalRatingTable, etc.)

Cada tipo de capa se recupera con su estilo y configuración adecuados, según las configuraciones predefinidas en la herramienta.

Mejores prácticas

• Utilice esta herramienta cuando elimine accidentalmente capas que forman parte de un proyecto existente en lugar de volver a importarlas.

• Después de recuperar las capas, verifique su estilo y configuración para asegurarse de que coincidan con sus expectativas.

• Si necesita recuperar varias capas, recupérelas una por una, seleccionándolas en el menú desplegable y haciendo clic en "Recuperar".

• La herramienta solo recupera capas que todavía tienen su correspondiente archivo shapefile en el directorio del proyecto; si se han eliminado archivos, utilice la herramienta Importar capas RF2D.

Herramienta para comparar mapas ráster de salida

La herramienta Compare Output Raster Maps permite comparar salidas ráster de diferentes escenarios de simulación. Esta herramienta permite una evaluación cuantitativa de las diferencias entre corridas del modelo, lo que ayuda a evaluar el impacto de cambios de parámetros, analizar diseños alternativos o validar resultados del modelo contra distintos escenarios.

Ventana de diálogo

Controles de diálogo

Control	Tipo	Descripción
Base Scenario List	Vista de lista	Muestra todas las capas ráster disponibles del proyecto actual para su selección como escenario base.
Alternate Scenario Dropdown	combo box	Selecciona el escenario alternativo para compararlo con el escenario base.
Alternate Scenario List	Vista de lista	Muestra las capas ráster disponibles del escenario alternativo seleccionado.
Type Operation	radio buttons	Especifica la operación de comparación que se realizará: "Alternate - Base" (predeterminada) o "Base - Alternate".
Output Layer Name	text field	Establece el nombre de la capa de diferencia resultante.
Compute	button	Ejecuta la operación de comparación y crea la capa de diferencia.
Save Report Balance Fill/Cut	checkbox	Cuando está marcado, genera un informe cuantitativo de las diferencias entre los mapas, incluidos los volúmenes de relleno y corte.
Report File Path	text field	Especifica la ubicación para guardar el archivo del informe (habilitado cuando la casilla de verificación está marcada).
Browse	button	Abre un cuadro de diálogo de archivo para seleccionar la ubicación del archivo del informe.
Close	button	Cierra el diálogo.

Flujo de trabajo

1. La herramienta primero carga todas las capas ráster disponibles del proyecto RiverFlow2D activo actual como escenario base.

2. Seleccione una capa ráster de la lista de escenarios base que desee comparar.

3. En el menú desplegable de escenario alternativo, seleccione un proyecto alternativo:

   • El menú desplegable se completa con escenarios de proyectos disponibles.

   • Cuando se selecciona, la herramienta carga todas las capas ráster de ese escenario.

4. Seleccione una capa ráster correspondiente de la lista de escenarios alternativos para compararla con la capa base.

5. Elija el tipo de operación:

   • "Alternate - Base" muestra dónde el escenario alternativo tiene valores más altos que el escenario base (diferencias positivas) y dónde tiene valores más bajos (diferencias negativas).

   • "Base - Alternate" muestra dónde el escenario base tiene valores más altos que el escenario alternativo (diferencias positivas) y dónde tiene valores más bajos (diferencias negativas). En la práctica, invierte los resultados de la primera opción.

6. Introduzca un nombre para la capa de diferencia de salida.

7. Si desea generar un reporte volumétrico de las diferencias:

   • Marque la opción "Save Report Balance Fill/Cut".

   • Especifique una ubicación para guardar el informe utilizando el campo de texto o el botón "Browse".

8. Haga clic en "Compute" para ejecutar la operación de comparación.

9. La herramienta realiza los siguientes pasos:

   • Carga ambas capas ráster seleccionadas en la memoria.

   • Garantiza que tengan extensiones y resoluciones coincidentes.

   • Realiza la operación aritmética especificada (resta) entre las capas.

   • Crea una nueva capa ráster con las diferencias calculadas.

   • Aplica una simbología apropiada para resaltar las diferencias positivas y negativas.

   • Si se solicita, calcula las diferencias volumétricas y genera un informe.

10. La capa de diferencia resultante se agrega al proyecto QGIS con una simbología de rampa de color.

Requisitos

• Se requiere un proyecto RiverFlow2D activo para el escenario base.

• Tanto la capa ráster base como la alternativa deben:

  • Tener el mismo sistema de referencia de coordenadas.

  • Tener extensiones y resoluciones compatibles.

  • Representar el mismo tipo de datos (por ejemplo, profundidad del agua o magnitud de la velocidad) para que la comparación sea significativa.

• Se necesita acceso de escritura al directorio del proyecto para crear la capa de diferencia y el archivo de informe.

Detalles técnicos

Interpretación de la capa de diferencia

La capa de diferencias resultante ayuda a visualizar y cuantificar cambios entre escenarios:

• Positive Values (typically shown in blue): Indica áreas donde el escenario alternativo tiene valores más altos que el escenario base. Para comparaciones de profundidad del agua, estas representan áreas con aguas más profundas en el escenario alternativo.

• Negative Values (typically shown in red): Indica áreas donde el escenario alternativo tiene valores más bajos que el escenario base. Para comparaciones de profundidad del agua, estas representan áreas con aguas menos profundas en el escenario alternativo.

• Values Near Zero (typically shown in white or transparent): Indica áreas con diferencias mínimas entre escenarios.

Informe de equilibrio volumétrico

Cuando se selecciona la opción "Save Report Balance Fill/Cut", la herramienta genera un informe detallado que contiene:

• Header Information: Fecha, hora, nombres de proyectos y capas comparadas.

• Raster Statistics: Desviación mínima, máxima, media y estándar de los valores de diferencia.

• Fill Volume: Volumen total de diferencias positivas (donde la alternativa > la base).

• Cut Volume: Volumen total de diferencias negativas (donde la alternativa < la base).

• Net Volume: La suma algebraica de volúmenes de relleno y corte.

• Cell Details: Número de celdas con diferencias positivas, negativas y cero.

• Area Summary: Superficie total afectada por cambios, desglosada por diferencias positivas y negativas.

Este informe es útil para la evaluación cuantitativa de alternativas de diseño, análisis de impacto o verificación de cambios del modelo.

Mejores prácticas

• Compare rásteres del mismo tipo (por ejemplo, profundidad del agua con profundidad del agua) para garantizar resultados significativos.

• Utilice nombres de capas de salida descriptivos que indiquen qué escenarios se están comparando.

• Para comparaciones de elevación o batimetría, considere la operación "Alternativa - Base" para mostrar las áreas de deposición como positivas y la erosión como negativa.

• Revise tanto la capa de diferencia visual como el informe volumétrico para un análisis completo.

• Al comparar varios pares de capas, organice las capas de salida en un grupo para facilitar la administración.

• Considere usar transparencia en la simbología de la capa de diferencia para ver las capas de referencia subyacentes.

• Para resultados que dependen del tiempo, asegúrese de comparar el mismo paso de tiempo de cada escenario.

Herramienta de configuración de elevación de TriMesh

La herramienta Setting TriMesh Elevation permite asignar valores de elevación desde un archivo FED a una capa TriMesh. Esta herramienta permite actualizar los atributos de elevación de los elementos de malla sin reimportar toda la malla, lo que resulta útil para actualizar información del terreno en un modelo existente o aplicar ajustes de elevación.

Ventana de diálogo

Controles de diálogo

Control	Tipo	Descripción
FED File	Campo	Ruta al archivo FED que contiene datos de elevación para los elementos de malla.
...	button	Abre un cuadro de diálogo de archivo para buscar y seleccionar un archivo FED.
Progress Bar	Barra de progreso	Muestra el progreso del proceso de importación de datos de elevación.
Close	button	Cierra el diálogo.

Flujo de trabajo

1. La herramienta primero busca un proyecto RiverFlow2D activo.

2. El cuadro de diálogo presenta un campo para seleccionar un archivo FED, con un botón de exploración para facilitar la selección de archivos.

3. Cuando se selecciona un archivo FED usando el botón de exploración:

   • La herramienta verifica que exista una capa TriMesh en el proyecto actual.

   • Lee el archivo FED para extraer datos de elevación para cada elemento de malla.

   • La herramienta compara la cantidad de elementos en el archivo FED con la cantidad de entidades en la capa TriMesh para garantizar que coincidan.

   • Si los recuentos de elementos coinciden, la herramienta actualiza el atributo de elevación (índice de campo 5) para cada elemento de malla con el valor correspondiente del archivo FED.

   • Una barra de progreso visualiza el proceso de importación.

   • Al finalizar, se muestra un mensaje de confirmación.

4. Si se produce un error durante el proceso (por ejemplo, no se encontró ninguna capa TriMesh o el recuento de elementos no coincide), se muestra un mensaje de error apropiado.

Requisitos

• Se requiere un proyecto RiverFlow2D activo.

• Debe existir una capa TriMesh en el proyecto QGIS.

• El archivo FED debe contener datos de elevación para todos los elementos de malla.

• La cantidad de elementos en el archivo FED debe coincidir con la cantidad de entidades en la capa TriMesh.

• La capa TriMesh debe tener un campo de atributo en el índice 5 para almacenar valores de elevación.

Detalles técnicos

Requisitos de formato de archivo

El archivo FED usado para establecer la elevación de TriMesh debe seguir el formato estándar de archivo FED de RiverFlow2D:

• Primera línea: contiene el número de elementos y el número de líneas de encabezado.

• Líneas de encabezado: contienen información del encabezado (omitida durante el procesamiento).

• Datos del elemento: cada línea posterior contiene datos del elemento, con el valor de elevación en la sexta columna (índice 5).

Mejores prácticas

• Antes de actualizar las elevaciones, asegúrese de que la capa TriMesh sea la que desea modificar, ya que los cambios afectarán la geometría de la malla.

• Verifique que el archivo FED contenga valores de elevación adecuados antes de aplicarlos a la malla.

• Después de actualizar las elevaciones, revise la malla para asegurarse de que los cambios se hayan aplicado correctamente.

• Considere guardar su proyecto antes de usar esta herramienta, ya que los cambios en la capa TriMesh son permanentes una vez aplicados.

• Para mallas grandes con muchos elementos, el proceso de importación puede llevar algún tiempo. La barra de progreso proporciona información visual sobre el estado de la operación.

Herramienta para comprobar el ángulo interno de las celdas de TriMesh

La herramienta Check Internal Angle of TriMesh's Cells permite identificar y localizar celdas problemáticas en una malla triangular donde los ángulos internos son menores de 5 grados. Las mallas con ángulos extremadamente pequeños pueden causar inestabilidad computacional e imprecisiones en simulaciones hidrodinámicas, por lo que esta herramienta es esencial para el control de calidad del dominio computacional.

Esta herramienta también detecta celdas con área nula. En estos casos, la herramienta muestra el ID de la celda, pero debido a que estas celdas no tienen geometría, las herramientas de zoom y selección no pueden utilizarse. Por lo tanto, la celda debe ubicarse manualmente para determinar la causa, que generalmente se debe a dos nodos con las mismas coordenadas.

Ventana de diálogo

Esta herramienta tiene una interfaz mínima porque ejecuta automáticamente el proceso de revisión al iniciarse y muestra resultados en un diálogo aparte si se encuentran celdas problemáticas.

Controles de diálogo

Control	Tipo	Descripción
Close	button	Cierra el cuadro de diálogo después del proceso de verificación.

Flujo de trabajo

1. Cuando se inicia, la herramienta busca automáticamente una capa TriMesh activa en el proyecto.

2. Aparece un cuadro de diálogo de progreso que muestra el estado del proceso de verificación.

3. La herramienta examina cada celda triangular en TriMesh y calcula los tres ángulos internos.

4. Para cada celda, la herramienta:

   • Extrae las coordenadas de los tres vértices.

   • Calcula las distancias al cuadrado entre cada par de vértices.

   • Calcula los ángulos internos usando la ley de los cosenos.

   • Comprueba si algún ángulo es inferior a 5 grados (aproximadamente 0,08726647 radianes).

5. Si se encuentran celdas con ángulos problemáticos:

   • Se abre un cuadro de diálogo de lista que muestra los ID de todas las celdas problemáticas.

   • El usuario puede seleccionar una celda de la lista y usar el botón "Acercar a la celda" para inspeccionarla en el lienzo del mapa.

   • La celda seleccionada se resalta en la capa TriMesh.

6. Si no se encuentran celdas problemáticas, se muestra un mensaje informativo y la herramienta se cierra.

7. Si se detecta una celda con área cero durante el proceso de verificación (lo que indica que hay vértices superpuestos), se muestra un mensaje de error con el ID de la celda y el proceso de verificación finaliza.

Requisitos

• Se requiere un proyecto RiverFlow2D activo.

• Debe haber una capa TriMesh presente en el proyecto QGIS con el nombre "TriMesh".

• La capa TriMesh debe contener una geometría triangular válida.

• La herramienta requiere acceso de lectura a los datos de la malla para realizar cálculos de ángulos.

Detalles técnicos

Cuadro de diálogo Lista de celdas

Si la herramienta identifica celdas con ángulos internos menores de 5 grados, muestra un diálogo secundario que enumera esas celdas:

Control	Tipo	Descripción
List of cells	Vista de lista	Muestra los ID de las celdas triangulares con ángulos internos inferiores a 5 grados.
Zoom to cell	button	Acerca el lienzo del mapa a la celda seleccionada para realizar una inspección visual.
Close	button	Cierra el diálogo.

Método numérico

La herramienta utiliza el siguiente enfoque para calcular y revisar ángulos internos:

1. Para cada celda triangular con vértices \(v_0\), \(v_1\) y \(v_2\):

2. Calcular distancias al cuadrado entre vértices:

   • \(d_{12}^2 = (v_1.x - v_0.x)^2 + (v_1.y - v_0.y)^2\)

   • \(d_{13}^2 = (v_2.x - v_0.x)^2 + (v_2.y - v_0.y)^2\)

   • \(d_{23}^2 = (v_2.x - v_1.x)^2 + (v_2.y - v_1.y)^2\)

3. Calcula los ángulos internos usando la ley de los cosenos:

   • \(\cos(\angle v_0) = \frac{d_{12}^2 + d_{13}^2 - d_{23}^2}{2\sqrt{d_{12}^2 \cdot d_{13}^2}}\)

   • \(\cos(\angle v_1) = \frac{d_{12}^2 + d_{23}^2 - d_{13}^2}{2\sqrt{d_{12}^2 \cdot d_{23}^2}}\)

   • \(\angle v_2 = \pi - (\angle v_0 + \angle v_1)\)

4. Compruebe si algún ángulo tiene menos de 5 grados (0,08726647 radianes).

Mejores prácticas

• Ejecute esta herramienta después de crear o modificar un TriMesh para garantizar que la calidad de la malla cumpla con los requisitos de estabilidad numérica.

• Utilice esta herramienta antes de ejecutar simulaciones para identificar y solucionar problemas potenciales en la malla computacional.

• Cuando se identifican celdas problemáticas:

  • Considere volver a mallar las áreas afectadas con diferentes parámetros de densidad de malla.

  • Edite manualmente la malla para corregir problemas geométricos.

  • Si utiliza líneas de rotura para controlar la generación de malla, ajuste su ubicación para evitar crear triángulos degenerados.

• Para una simulación numérica óptima, lo ideal es que todos los ángulos internos estén entre 30 y 120 grados, aunque la herramienta solo señala los casos más extremos por debajo de 5 grados.

• Considere ejecutar esta herramienta junto con otras comprobaciones de calidad de la malla, como garantizar transiciones de elevación suaves entre celdas adyacentes.

Herramienta de configuración de RiverFlow2D

La herramienta RiverFlow2D Settings proporciona una interfaz centralizada para configurar parámetros esenciales requeridos para las operaciones de proyectos de RiverFlow2D. Esta herramienta permite especificar la ubicación del ejecutable de RiverFlow2D, definir rutas del proyecto y configurar opciones de procesamiento de malla que afectan el rendimiento y la precisión de la simulación.

Ventana de diálogo

Controles de diálogo

Control	Tipo	Descripción
RiverFlow2D executable	text field	Ruta al archivo ejecutable RiverFlow2D (.exe) en el sistema.
Browse (executable)	button	Abre un cuadro de diálogo de archivo para seleccionar el archivo ejecutable RiverFlow2D.
Project Path	text field	Ruta del directorio donde se almacenan los archivos del proyecto.
Browse (project path)	button	Abre un cuadro de diálogo de directorio para seleccionar la carpeta del proyecto.
Project File	text field	Nombre del archivo del proyecto sin extensión.
Browse (project file)	button	Abre un cuadro de diálogo de archivo para seleccionar un archivo de proyecto .dat.
Resolution factor for gmsh	text field	Valor numérico que determina el tamaño del elemento de malla durante el procesamiento con Gmsh. El valor predeterminado es 1.
Optimize mesh cell ordering	checkbox	Cuando está marcada, permite optimizar la numeración de las celdas de la malla para mejorar la eficiencia computacional.
OK	button	Guarda la configuración y cierra el cuadro de diálogo.
Cancel	button	Cierra el cuadro de diálogo sin guardar los cambios.

Flujo de trabajo

1. Cuando se inicia la herramienta, verifica que se haya configurado un proyecto RiverFlow2D. Si no hay ningún proyecto configurado, aparece un mensaje de advertencia y el cuadro de diálogo no se abrirá.

2. Si existe un proyecto, el cuadro de diálogo se abre y carga la configuración actual de ambos ámbitos:

   • Configuración de la aplicación QGIS (para la ruta del ejecutable de RiverFlow2D)

   • Configuraciones específicas del proyecto (para rutas del proyecto y configuraciones de malla)

3. El usuario puede modificar cualquiera de las siguientes configuraciones:

   • RiverFlow2D executable: ruta al archivo ejecutable del software de simulación, normalmente ubicado en el directorio de instalación de RiverFlow2D.

   • Project Path: Directorio donde se guardarán todos los archivos del proyecto.

   • Project File: Nombre base del archivo del proyecto (sin extensión).

   • Resolution factor for gmsh: Valor numérico que controla el tamaño del elemento de malla durante la generación de malla con Gmsh. Los valores más altos producen mallas más finas.

   • Optimize mesh cell ordering: Opción para renumerar las celdas de la malla para mejorar el rendimiento computacional.

4. Después de realizar los cambios deseados, al hacer clic en "Aceptar" se guardan todas las configuraciones:

   • La ruta del ejecutable de RiverFlow2D se guarda en la configuración de la aplicación QGIS.

   • La ruta del proyecto, el nombre del archivo del proyecto, el factor de resolución y la configuración de optimización de la malla se guardan en el proyecto QGIS actual.

5. Luego, otras herramientas del complemento utilizan la configuración guardada, incluidas la generación de mallas, las ejecuciones de simulación y el procesamiento de resultados.

Requisitos

• Se requiere una instalación válida de RiverFlow2D en el sistema.

• El usuario debe tener los permisos adecuados para acceder y ejecutar el ejecutable RiverFlow2D.

• El directorio de la ruta del proyecto debe existir y el usuario debe tener permisos de escritura en él.

• Si especifica un archivo de proyecto, el archivo .dat correspondiente debe ser válido si ya existe.

• Cuando se utiliza el factor de resolución para gmsh, se recomiendan valores numéricos entre 0,1 y 10 para la mayoría de las aplicaciones.

Detalles técnicos

Detalles de configuración

Ruta del ejecutable de RiverFlow2D

La ruta del ejecutable es crítica, ya que permite al complemento iniciar RiverFlow2D para las simulaciones. La ubicación predeterminada suele ser:

C:/Program Files/Hydronia/RiverFlow2D/RiverFlow2DDIP.exe

Factor de resolución para gmsh

El factor de resolución controla el tamaño de los elementos en el proceso de generación de malla:

• Los valores inferiores a 1 crean mallas más gruesas con elementos más grandes (cálculo más rápido, menor precisión).

• Los valores mayores que 1 crean mallas más finas con elementos más pequeños (cálculo más lento, mayor precisión).

• El valor predeterminado de 1 mantiene la resolución original derivada de los datos de elevación.

Optimización de celdas de malla

La opción "Optimize mesh cell ordering" mejora la eficiencia computacional al:

• Reordenar las celdas de la malla para minimizar el ancho de banda de la matriz del sistema.

• Reducir los requisitos de memoria durante la simulación.

• Disminuir potencialmente el tiempo de simulación, especialmente para mallas grandes.

Mejores prácticas

Si se le indica hacerlo o si está seguro de la configuración, puede cambiar estos ajustes para ayudar a resolver un problema. Si no está seguro de la configuración, contacte con Hydronia Support.

• A veces, QGIS puede perder la ruta del archivo del proyecto; configurarla aquí ayudará al complemento a encontrar el archivo del proyecto en esos casos.

• Cuando trabaje con dominios grandes:

  • Comience con un factor de resolución más bajo (0,5 - 0,8) para la prueba y calibración iniciales.

  • Aumente gradualmente el factor de resolución para las ejecuciones de producción finales.

• Habilite siempre la optimización de celdas de malla para mallas grandes (más de 500 000 elementos) para mejorar la eficiencia computacional.

• Documente el factor de resolución utilizado para cada simulación para garantizar la reproducibilidad de los resultados.

Herramienta de archivos de hidrograma múltiple a hidrograma único

La herramienta de archivos de hidrograma múltiple a hidrogramas individuales proporciona una función especializada para convertir datos de hidrogramas de series de tiempo desde un formato combinado de múltiples fuentes en archivos individuales de un solo hidrograma. Esta herramienta es particularmente útil para preparar insumos hidrológicos para simulaciones cuando se trabaja con múltiples fuentes de entrada que inicialmente se almacenaron en un único archivo de datos.

Ventana de diálogo

Controles de diálogo

Control	Tipo	Descripción
Multiple hydrograph file	text field	Ruta al archivo de entrada que contiene datos de múltiples hidrogramas.
Browse	button	Abre un cuadro de diálogo de archivo para seleccionar el archivo de hidrograma múltiple de entrada.
Format file	dropdown	Especifica el formato del archivo de entrada (actualmente admite el formato HEC-DSSVue).
Prefix for single hydrograph files	text field	Prefijo de texto que se agregará a todos los archivos de salida generados (predeterminado: "Hydrog_").
Output folder	text field	Directorio donde se guardarán los archivos de hidrograma individuales.
Browse (output folder)	button	Abre un cuadro de diálogo de directorio para seleccionar la carpeta de salida.
OK	button	Procesa el archivo de entrada y genera los archivos de hidrograma individuales.
Close	button	Cancela la operación y cierra el diálogo.

Flujo de trabajo

1. Cuando se inicia, la herramienta establece automáticamente el directorio de salida predeterminado en el directorio de escena del proyecto actual.

2. El usuario selecciona un archivo de entrada de hidrograma múltiple mediante:

   • Escribiendo la ruta completa en el campo "Archivo de hidrograma múltiple", o

   • Haciendo clic en el botón "Examinar" para navegar y seleccionar el archivo.

3. La herramienta completa automáticamente el campo "Carpeta de salida" con el directorio que contiene el archivo de entrada seleccionado, pero el usuario puede especificar una ubicación de salida diferente si lo desea.

4. El usuario puede personalizar el prefijo de los archivos generados modificando el campo "Prefijo para archivos de hidrograma único". El prefijo predeterminado es "Hydrog_".

5. El usuario selecciona el formato apropiado en el menú desplegable "Formato de archivo". Actualmente, la herramienta admite archivos con formato HEC-DSSVue.

6. Después de configurar todos los ajustes, el usuario hace clic en "Aceptar" para procesar el archivo. La herramienta:

   • Lee el archivo de entrada de múltiples hidrogramas

   • Identifica el número de hidrogramas separados contenidos dentro

   • Crea archivos individuales para cada hidrograma.

   • Nombra cada archivo usando el prefijo especificado seguido de un número secuencial

   • Muestra un mensaje de resumen que muestra cuántos archivos se crearon.

7. La herramienta muestra un mensaje de finalización que indica la cantidad de archivos de hidrograma que se crearon exitosamente.

Requisitos

• Se recomienda un proyecto RiverFlow2D activo para una gestión adecuada de la ruta de los archivos, aunque no es estrictamente necesario.

• El archivo de multihidrógrafo de entrada debe tener el formato adecuado según el estándar HEC-DSSVue, con los valores de tiempo en las columnas esperadas.

• El usuario debe tener permisos de escritura para el directorio de salida seleccionado.

• Para el formato HEC-DSSVue, el archivo debe contener:

  • Datos de tiempo en la columna 5 (en formato horas:minutos, por ejemplo, "08:30")

  • Valores de flujo para diferentes hidrogramas a partir de la columna 6

Detalles técnicos

Detalles de procesamiento de archivos

La herramienta procesa archivos con formato HEC-DSSVue utilizando el siguiente enfoque:

1. El archivo se escanea para determinar el número de filas y columnas de datos.

2. La herramienta identifica cuántos hidrogramas separados están presentes contando el número de columnas de datos después de la columna de tiempo (a partir de la columna 6).

3. Para cada hidrograma identificado, se crea un archivo de salida independiente con el patrón de nomenclatura: [prefijo][número].txt (por ejemplo, "Hydrog_1.txt", "Hydrog_2.txt").

4. Cada archivo de salida está estructurado con:

   • Una línea de encabezado que contiene el número de pasos de tiempo.

   • Filas de datos con dos columnas: tiempo acumulado (en horas) y valor del flujo

5. La herramienta convierte datos de tiempo del formato HEC-DSSVue (HH:MM) a horas decimales para los archivos de salida, calculando el tiempo acumulado a medida que procesa cada fila.

Mejores prácticas

• Utilice esta herramienta al principio del proceso de configuración del proyecto RiverFlow2D cuando prepare los datos de entrada.

• Verifique que los archivos de hidrograma único generados tengan el número correcto de puntos de tiempo y los intervalos de tiempo apropiados antes de usarlos en simulaciones.

• Guarde el archivo original de múltiples hidrogramas como copia de seguridad en caso de que necesite regenerar los archivos individuales con configuraciones diferentes.

• Al gestionar múltiples fuentes de afluencia, utilice prefijos descriptivos para identificar claramente el propósito de cada conjunto de hidrogramas (por ejemplo, "Afluencia_", "Afluente_").

• Si crea varios conjuntos de archivos de hidrograma, considere organizarlos en directorios separados para evitar confusiones.

• Después de generar los archivos de hidrograma, use la herramienta Fuente RiverFlow2D para asignarlos correctamente a los puntos fuente en su modelo.

Herramienta para importar un proyecto de escenario único a multiescenario

Esta herramienta facilita la migración de proyectos RiverFlow2D independientes al marco multiescenario, permitiendo organizar y comparar múltiples escenarios de simulación dentro de un solo proyecto de QGIS.

Ventana de diálogo

Controles de diálogo

Control	Tipo	Descripción
.DAT File Name	text field	Campo de solo lectura que muestra la ruta al archivo de proyecto RiverFlow2D seleccionado (.dat).
Browse	button	Abre un cuadro de diálogo de archivo para seleccionar el archivo de proyecto RiverFlow2D (.dat) para importar.
OK	button	Inicia el proceso de importación después de confirmar el archivo del proyecto seleccionado.
Cancel	button	Cierra el cuadro de diálogo sin importar ningún proyecto.

Flujo de trabajo

1. Cuando se inicia, la herramienta comprueba si ya existe una estructura de proyecto de múltiples escenarios. De lo contrario, le pedirá al usuario que cree una primero.

2. El usuario selecciona un archivo de proyecto RiverFlow2D (.dat) haciendo clic en el botón Examinar, que abre un cuadro de diálogo de selección de archivos. Sólo se mostrarán los archivos con la extensión .dat.

3. Después de seleccionar un archivo de proyecto válido, su ruta aparece en el campo ".DAT File Name".

4. Cuando el usuario hace clic en "Aceptar", la herramienta realiza las siguientes operaciones:

   • Verifica que el archivo seleccionado sea un archivo de proyecto RiverFlow2D válido.

   • Crea una nueva carpeta de escenario dentro de la estructura del proyecto de múltiples escenarios.

   • Copia todos los archivos de proyecto relevantes desde la ubicación de origen a la nueva carpeta del escenario.

   • Actualiza las rutas de los archivos en el proyecto para reflejar la nueva ubicación.

   • Registra el nuevo escenario en la configuración del proyecto multiescenario.

   • Actualiza las fuentes de datos de la capa para que apunten a las nuevas ubicaciones de los archivos.

5. Al finalizar, se muestra un mensaje de éxito y el proyecto importado pasa a estar disponible como escenario en el proyecto de múltiples escenarios.

6. Si se producen errores durante el proceso de importación (por ejemplo, estructura de archivos no válida, problemas de permisos), se muestran los mensajes de error correspondientes.

Requisitos

• Debe existir o crearse una estructura de proyecto RiverFlow2D de múltiples escenarios válida antes de utilizar esta herramienta.

• El proyecto de origen debe ser un proyecto RiverFlow2D válido con un archivo .dat adecuado y archivos de datos asociados.

• El usuario debe tener permisos de lectura para los archivos del proyecto de origen y permisos de escritura para el directorio del proyecto de múltiples escenarios.

• Debe haber suficiente espacio en disco disponible para copiar todos los archivos del proyecto a la nueva ubicación.

• El proyecto QGIS debe guardarse antes de realizar la operación de importación para garantizar que todas las configuraciones actuales se mantengan correctamente.

Detalles técnicos

Operaciones de archivos

La herramienta realiza varias operaciones del sistema de archivos durante el proceso de importación:

1. Validación de la estructura del proyecto: Comprueba que tanto el proyecto de origen como la estructura multiescenario de destino sean válidos.

2. Generación del nombre del escenario: Crea un nombre de escenario único basado en el nombre del proyecto de origen (el nombre del archivo *.dat), evitando conflictos con escenarios existentes.

3. Creación del directorio: Crea un nuevo directorio de escenarios dentro de la estructura del proyecto multiescenario.

4. Copia de archivos: Copia recursivamente todos los archivos del proyecto desde la ubicación de origen al nuevo directorio del escenario, preservando la estructura del directorio.

5. Reconfiguración de rutas: Actualiza todas las rutas de archivo dentro de los archivos del proyecto para reflejar la nueva ubicación en la estructura de múltiples escenarios.

6. Actualización de fuentes de capas: Modifica las fuentes de datos de la capa QGIS para que apunten a los archivos en la nueva ubicación.

La herramienta preserva toda la estructura del proyecto, incluyendo:

• Archivos de definición de proyecto (.dat, .qgs, .qgz)

• Archivos de malla (.2dm, .msh)

• Archivos de datos de entrada (hidrógrafos, condiciones de contorno)

• Archivos de salida de simulación (si están presentes)

• Datos de referencia y capas SIG

Mejores prácticas

• Antes de importar un proyecto, asegúrese de que se ejecute correctamente como un proyecto independiente para evitar transferir problemas de configuración.

• Cuando trabaje con proyectos grandes que contengan datos de salida importantes, considere eliminar los resultados de simulación innecesarios antes de importarlos para reducir el tiempo de importación y los requisitos de almacenamiento.

• Después de importar, verifique que todas las capas y referencias estén vinculadas correctamente en el nuevo escenario.

• Mantenga una copia de seguridad del proyecto independiente original hasta que haya confirmado que el escenario importado funciona correctamente.