Skip to content

Herramientas

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

Menú Tools

Herramientas de EPA-SWMM

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

Submenús del proyecto EPA-SWMM

Ventana de diálogo

Importar archivo EPA-SWMM

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

Diálogo Import EPA-SWMM File

Crear StormDrainPolygon

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

Diálogo Create StormDrainPolygon

Crear archivo de proyecto SWMM

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

Diálogo Create SWMM Project

Controles del diálogo

Importar archivo EPA-SWMM

Control Tipo Descripción
EPA-SWMM .INP FILE OR .HYC FILE campo Especifica la ruta al archivo de entrada SWMM (INP o HYC).
... botón Abre un diálogo de archivos para buscar el archivo SWMM.
Create StormDrainPolygon Layer casilla Si se marca, crea representaciones poligonales alrededor de los nodos importados.
Rectangles Size campo Define el tamaño de los polígonos rectangulares (predeterminado: 5 unidades). Solo se habilita si está marcada la casilla \"Create StormDrainPolygon Layer\".
Ok botón Ejecuta el proceso de importación.
Close botón 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 botón de opción Elimina cualquier capa StormDrainPolygon existente y crea una nueva.
Adding to current StormDrainPolygon Layer botón de opción Agrega nuevos polígonos a la capa StormDrainPolygon existente, si está presente.
OK botón Ejecuta la creación de polígonos.
Close botón Cierra el diálogo.

Crear archivo de proyecto SWMM

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

Flujo de trabajo

Importar archivo EPA-SWMM

  1. Compruebe que exista un proyecto OilFlow2D.

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

  3. Extraiga la información de los nodos (coordenadas, ID y atributos).

  4. Cree una capa de puntos StormDrain en el directorio shape del proyecto.

  5. Si está marcada la opción \"Create StormDrainPolygon Layer\", cree polígonos alrededor de los nodos.

  6. Agregue las capas al grupo COMPONENTS en QGIS.

  7. Aplique estilos y etiquetado a las capas importadas.

Crear StormDrainPolygon

  1. Compruebe que exista un proyecto OilFlow2D.

  2. Localice la capa de puntos StormDrain.

  3. Extraiga las coordenadas y los ID de los nodos.

  4. Cree polígonos rectangulares según el tamaño especificado.

  5. Cree una capa nueva o agregue elementos a una existente, según el botón de opción seleccionado.

  6. Agregue la capa al grupo COMPONENTS en QGIS.

  7. Etiquete los polígonos con los ID de los nodos.

Crear archivo de proyecto SWMM

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

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

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

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

Requisitos

Importar archivo EPA-SWMM

  • Un proyecto OilFlow2D activo.

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

Crear StormDrainPolygon

  • Un proyecto OilFlow2D activo.

  • Una capa de puntos StormDrain que contenga los nodos.

Crear archivo de proyecto SWMM

  • Un proyecto OilFlow2D activo.

  • Una capa de nodos con identificadores únicos.

  • Una capa DEM que cubra el área de los nodos.

Detalles técnicos

Importar archivo EPA-SWMM

Compatibilidad de formatos

  • 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 del escenario del proyecto actual.

Consideraciones del sistema de coordenadas

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

Crear StormDrainPolygon

La capa StormDrainPolygon se guarda en el directorio shape del escenario 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 OilFlow2D for QGIS Reference Manual para obtener más detalles.

Método de procesamiento

  1. Extrae puntos de la capa de nodos.

  2. Muestrea el DEM en cada punto.

  3. Calcula las elevaciones de solera (elevación del DEM - profundidad máxima).

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

  5. Escribe el archivo completo.

Notas de uso

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

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

  • Las unidades de salida (pies o metros) se determinan según las unidades del proyecto de QGIS.

  • El archivo INP es una estructura básica que puede personalizarse posteriormente en EPA-SWMM.

  • Solo se crean nodos de unión; los demás elementos (conducciones, subcuencas) deben agregarse 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 OilFlow2D for QGIS Reference Manual para obtener más detalles.

Herramienta Import Multi Sources File

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

Ventana de diálogo

Diálogo Import Multi Sources File

Controles del diálogo

Control Tipo Descripción
Multi Sources File campo Ruta al archivo de datos de múltiples fuentes que se importará.
... botón Abre un diálogo de archivos para buscar el archivo de múltiples fuentes.
Creating new Source layer botón de opción Al seleccionarlo, crea una nueva capa Sources y elimina cualquier capa existente.
Adding to current Source Layer botón de opción Al seleccionarlo, agrega puntos a la capa Sources existente (solo se habilita si existe una capa Sources).
Close botón Cierra el diálogo sin realizar cambios.

Flujo de trabajo

  1. Primero, la herramienta comprueba que exista un proyecto OilFlow2D activo.

  2. El usuario selecciona un archivo de múltiples fuentes mediante el diálogo de archivos.

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

    • Si se selecciona \"Creating new Source layer\", se elimina del proyecto cualquier capa Sources existente y se borra del disco.

    • Si se selecciona \"Adding to current Source Layer\", se usa la capa Sources existente (esta opción solo se habilita si existe una capa Sources).

  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 punto para cada fuente.

  5. La capa se simboliza con puntos rojos y se etiqueta mediante el campo SOURCEID.

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

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

    • El campo SOURCETYPE se configura con un mapa de valores (1: Discharge vs Time, 2: Rating table depth vs Q).

    • El campo FILENAME se configura con un widget de recurso externo.

    • Se adjuntan a la capa un formulario de interfaz de usuario personalizado y un script de Python para funciones avanzadas.

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

Requisitos

  • Se requiere un proyecto OilFlow2D activo.

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

  • La herramienta agrega la capa a un grupo COMPONENTS en el árbol de capas y crea el grupo si no existe.

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

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

Detalles técnicos

Formato de archivo

El archivo de múltiples fuentes debe seguir este formato:

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

  • Líneas posteriores (una por fuente): SourceID X-coordinate Y-coordinate Filename

Ejemplo:

3
Source1 125.5 345.7 discharge1.txt
Source2 220.8 410.2 discharge2.txt
Source3 180.3 275.9 discharge3.txt

Integración con OilFlow2D

Cada punto representa una fuente o un sumidero donde el agua entra al dominio del modelo o sale de él. Los puntos están asociados con archivos que definen las características de la descarga:

  • 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 la descarga.

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

Herramienta Import OilFlow2D Layers

La herramienta Import OilFlow2D Layers permite importar diversos componentes y archivos de datos de OilFlow2D 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 SIG.

Ventana de diálogo

Diálogo Import OilFlow2D Layers

Controles del diálogo

Control Tipo Descripción
Component Selector desplegable Lista desplegable para seleccionar qué componente de OilFlow2D se importará. Las opciones incluyen TriMesh, Domain Outline, Boundary Conditions, Manning's n values y muchas otras.
Import botón Ejecuta el proceso de importación para el componente seleccionado.
Close botón Cierra el diálogo sin realizar cambios.

Flujo de trabajo

  1. Primero, la herramienta comprueba que exista un proyecto OilFlow2D activo y obtiene el sistema de referencia de coordenadas del proyecto.

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

  3. Al hacer clic en \"Import\", la herramienta ejecuta uno de los siguientes flujos de trabajo:

    • Si se selecciona \"Import All Project\", la herramienta intenta importar secuencialmente todos los componentes disponibles del directorio del proyecto y comprueba la existencia de cada tipo de archivo.

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

  4. Durante la importación, la herramienta:

    • Comprueba si existe una capa del mismo tipo y, opcionalmente, la elimina.

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

    • Crea las 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 del árbol de capas de QGIS.

Al importar 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 los atributos, lo que mejora la capacidad del usuario para modificar directamente los parámetros del modelo en QGIS.

Requisitos

  • Se requiere un proyecto OilFlow2D activo.

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

  • Para importar el proyecto completo, todos los archivos de componentes deben estar presentes en el directorio del proyecto con las convenciones de nombres esperadas.

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

  • Se necesita memoria suficiente al importar mallas grandes (en particular, componentes TriMesh con muchos elementos).

Detalles técnicos

Tipos de archivo compatibles

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

Componente Extensión del archivo Descripción
All Project .FED Importa todos los componentes de OilFlow2D disponibles del directorio del proyecto en una sola operación. Usa el archivo FED como punto de partida para localizar los demás archivos del 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 la resistencia al flujo.
Manning's nz .MANNN Zonas de rugosidad direccional.
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 puente dentro del dominio de flujo.
Culverts .CULVERTS Estructuras de alcantarilla para el transporte del flujo.
Weirs .TWEIRS Estructuras de vertedero para el control del flujo.
Dam Breach .TDAMS Parámetros de modelado de la rotura 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 los ríos.
Observation Points .OBS Ubicaciones para la salida de series temporales.
DEM _BedElevations.exp Datos de elevación del lecho para el dominio.

Prácticas recomendadas

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

  • La opción \"Import All Project\" proporciona el flujo de trabajo más sencillo al configurar un proyecto nuevo o actualizar un modelo completo.

  • Para actualizaciones incrementales o al trabajar con componentes específicos, use las opciones de importación individuales para seleccionar únicamente los datos necesarios.

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

  • En proyectos grandes, considere importar los componentes individualmente en lugar de usar \"Import All Project\" para administrar mejor la memoria.

Herramienta Recover Layers

La herramienta Recover Layers permite recuperar capas de componentes de OilFlow2D que existen en el directorio del proyecto pero se eliminaron del lienzo de QGIS. Esta herramienta permite restaurar rápidamente las capas del proyecto sin tener que volver a importarlas desde sus archivos de origen.

Ventana de diálogo

Diálogo Recover Layer

Controles del diálogo

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

Flujo de trabajo

  1. Al abrirse, la herramienta analiza automáticamente la estructura de directorios del proyecto OilFlow2D activo.

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

  3. Las capas que existen como archivos pero no están cargadas actualmente en QGIS se agregan a la lista desplegable \"Recover Layer List\".

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

  5. Al hacer clic en el botón \"Recover\", la herramienta:

    • Carga el shapefile desde el directorio del proyecto.

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

    • Para tipos de capa específicos, como Boundary Conditions, configura formularios de atributos y widgets personalizados.

    • Agrega la capa al grupo correspondiente del árbol de capas de QGIS (MESH_SPATIAL_DATA, COMPONENTS u OUTPUT_CONTROL).

  6. Si no hay capas disponibles para recuperar, el botón \"Recover\" se deshabilita.

Requisitos

  • Se requiere un proyecto OilFlow2D activo.

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

  • Los shapefiles 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 shapefiles.

Detalles técnicos

Tipos de capa compatibles

La herramienta puede recuperar una amplia variedad de capas de componentes de OilFlow2D, entre ellas:

  • Domain Outline

  • Componentes de malla (MeshBreakLine, MeshDensityLine, MeshDensityPolygon)

  • Boundary Conditions

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

  • Estructuras hidráulicas (Bridges, Gates, Culverts, Weirs, DamBreach)

  • Componentes ambientales (Infiltration, RainEvap, Wind)

  • Sources and Sinks

  • Componentes de análisis (CrossSections, Profiles, ObservationPoints)

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

Cada tipo de capa se recupera con su estilo y configuración correspondientes, según los ajustes predefinidos de la herramienta.

Prácticas recomendadas

  • Use 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, compruebe su estilo y configuración para asegurarse de que coincidan con lo esperado.

  • Si necesita recuperar varias capas, recupérelas una por una: seleccione cada capa de la lista desplegable y haga clic en \"Recover\".

  • La herramienta solo recupera las capas que aún tienen su shapefile correspondiente en el directorio del proyecto; si los archivos se eliminaron, use la herramienta Import OilFlow2D Layers.

Herramienta Compare Output Raster Maps

La herramienta Compare Output Raster Maps permite comparar salidas ráster de distintos escenarios de simulación. Esta herramienta permite evaluar cuantitativamente las diferencias entre ejecuciones del modelo, evaluar el impacto de cambios en los parámetros, analizar diseños alternativos o validar los resultados del modelo frente a distintos escenarios.

Ventana de diálogo

Diálogo Compare Output Raster Maps

Controles del diálogo

Control Tipo Descripción
Base Scenario List list view Muestra todas las capas ráster disponibles del proyecto actual para seleccionar el escenario base.
Alternate Scenario Dropdown combo box Selecciona el escenario alternativo que se comparará con el escenario base.
Alternate Scenario List list view 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 diferencias resultante.
Compute button Ejecuta la operación de comparación y crea la capa de diferencias.
Save Report Balance Fill/Cut checkbox Cuando se marca, 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 donde se guardará el archivo de informe (se habilita cuando se marca la casilla).
Browse button Abre un diálogo de archivos para seleccionar la ubicación del archivo de informe.
Close button Cierra el diálogo.

Flujo de trabajo

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

  2. Seleccione en la lista del escenario base la capa ráster que desea comparar.

  3. En el desplegable del escenario alternativo, seleccione un proyecto alternativo:

    • El desplegable se completa con los escenarios de proyecto disponibles.

    • Al seleccionarlo, la herramienta carga todas las capas ráster de ese escenario.

  4. Seleccione en la lista del escenario alternativo una capa ráster correspondiente para compararla con la capa base.

  5. Elija el tipo de operación:

    • \"Alternate - Base\" muestra dónde el escenario alternativo tiene valores mayores que el base (diferencias positivas) y dónde tiene valores menores (diferencias negativas).

    • \"Base - Alternate\" muestra dónde el escenario base tiene valores mayores que el alternativo (diferencias positivas) y dónde tiene valores menores (diferencias negativas). Esto invierte efectivamente los resultados de la primera opción.

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

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

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

    • Especifique una ubicación para guardar el informe mediante el campo de texto o el botón de exploración.

  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.

    • Comprueba que tengan extensiones y resoluciones coincidentes.

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

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

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

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

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

Requisitos

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

  • Las capas ráster base y alternativa deben:

    • Tener el mismo sistema de referencia de coordenadas.

    • Tener extensiones y resoluciones compatibles.

    • Representar el mismo tipo de datos (p. ej., profundidad del agua, 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 diferencias y el archivo de informe.

Detalles técnicos

Interpretación de la capa de diferencias

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

  • Valores positivos (normalmente mostrados en azul): Indican áreas donde el escenario alternativo tiene valores mayores que el escenario base. En las comparaciones de profundidad del agua, representan áreas con mayor profundidad de agua en el escenario alternativo.

  • Valores negativos (normalmente mostrados en rojo): Indican áreas donde el escenario alternativo tiene valores menores que el escenario base. En las comparaciones de profundidad del agua, representan áreas con menor profundidad de agua en el escenario alternativo.

  • Valores cercanos a cero (normalmente mostrados en blanco o transparente): Indican áreas con diferencias mínimas entre escenarios.

Informe de balance volumétrico

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

  • Información del encabezado: Fecha, hora, nombres de los proyectos y capas comparadas.

  • Estadísticas ráster: Mínimo, máximo, media y desviación estándar de los valores de diferencia.

  • Volumen de relleno: Volumen total de las diferencias positivas (donde alternativo \(>\) base).

  • Volumen de corte: Volumen total de las diferencias negativas (donde alternativo \(<\) base).

  • Volumen neto: Suma algebraica de los volúmenes de relleno y corte.

  • Detalles de las celdas: Número de celdas con diferencias positivas, negativas y cero.

  • Resumen del área: Área total afectada por los cambios, desglosada por diferencias positivas y negativas.

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

Mejores prácticas

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

  • Use nombres descriptivos para las capas de salida que indiquen qué escenarios se comparan.

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

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

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

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

  • Para salidas dependientes del tiempo, asegúrese de comparar el mismo paso de tiempo de cada escenario.

Herramienta Setting TriMesh Elevation

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

Ventana de diálogo

Diálogo Setting TriMesh Elevation

Controles del diálogo

Control Tipo Descripción
FED File field Ruta al archivo FED que contiene datos de elevación para los elementos de la malla.
... button Abre un diálogo de archivos para buscar y seleccionar un archivo FED.
Progress Bar progress bar 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 comprueba primero que exista un proyecto OilFlow2D activo.

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

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

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

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

    • Compara el número de elementos del archivo FED con el número de entidades de la capa TriMesh para asegurarse de que coincidan.

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

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

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

  4. Si se produce un error durante el proceso (p. ej., no se encuentra la capa TriMesh o no coincide el número de elementos), se muestra un mensaje de error apropiado.

Requisitos

  • Se requiere un proyecto OilFlow2D activo.

  • Debe existir una capa TriMesh en el proyecto de QGIS.

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

  • El número de elementos del archivo FED debe coincidir con el número de entidades de la capa TriMesh.

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

Detalles técnicos

Requisitos del formato de archivo

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

  • 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 de encabezado (se omiten durante el procesamiento).

  • Datos de elementos: 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 a 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 aplicaron correctamente.

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

  • En mallas grandes con muchos elementos, el proceso de importación puede tardar. La barra de progreso proporciona información visual sobre el estado de la operación.

Herramienta Check Internal Angle of TriMesh's Cells

La herramienta Check Internal Angle of TriMesh's Cells permite identificar y localizar celdas problemáticas en una malla triangular cuyos ángulos internos son inferiores a 5 grados. Las mallas con ángulos extremadamente pequeños pueden causar inestabilidad computacional e imprecisiones en las 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, muestra el ID de la celda, pero como estas celdas no tienen geometría, no se pueden utilizar las herramientas de zoom y selección. Por lo tanto, la celda debe localizarse manualmente para determinar la causa, que normalmente son dos nodos con las mismas coordenadas.

Ventana de diálogo

Esta herramienta tiene una interfaz mínima, ya que ejecuta automáticamente el proceso de comprobación al iniciarse y muestra los resultados en un diálogo separado si encuentra celdas problemáticas.

Resultado negativo de Check Internal Angle of TriMesh's Cells

Controles del diálogo

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

Flujo de trabajo

  1. Al iniciarse, la herramienta comprueba automáticamente que haya una capa TriMesh activa en el proyecto.

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

  3. La herramienta examina cada celda triangular de TriMesh y calcula sus 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 mediante la ley de 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 diálogo de lista que muestra los IDs de todas las celdas problemáticas.

    • El usuario puede seleccionar una celda de la lista y utilizar el botón \"Zoom to cell\" 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 comprobación (lo que indica vértices superpuestos), se muestra un mensaje de error con el ID de la celda y el proceso termina.

Requisitos

  • Se requiere un proyecto OilFlow2D activo.

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

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

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

Detalles técnicos

Diálogo List of Cells

Si la herramienta identifica celdas con ángulos internos inferiores a 5 grados, muestra un diálogo secundario que las lista:

Lista de celdas con ángulos internos pequeños

Control Tipo Descripción
List of cells list view Muestra los IDs de las celdas de elementos triangulares con ángulos internos inferiores a 5 grados.
Zoom to cell button Hace zoom en el lienzo del mapa a la celda seleccionada para su inspección visual.
Close button Cierra el diálogo.

Método numérico

La herramienta utiliza el siguiente método para calcular y comprobar los ángulos internos:

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

  2. Calcule las distancias al cuadrado entre los 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. Calcule los ángulos internos mediante la ley de 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 es inferior a 5 grados (0.08726647 radianes).

Mejores prácticas

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

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

  • Cuando se identifiquen celdas problemáticas:

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

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

    • Si utiliza breaklines para controlar la generación de la malla, ajuste su ubicación para evitar crear triángulos delgados.

  • Para una simulación numérica óptima, todos los ángulos internos deberían estar idealmente entre 30 y 120 grados, aunque la herramienta solo señala los casos extremos inferiores a 5 grados.

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

Herramienta Oil Pipeline Break Model

La herramienta Oil Pipeline Break Model genera puntos de origen de derrames a lo largo de una polilínea Oilpipeline mediante el espaciamiento de las rupturas, las condiciones de entrada y las propiedades del petróleo. Calcula los caudales de salida del derrame para cada ruptura, muestrea las elevaciones a lo largo de la tubería y crea una capa Sources que puede utilizarse en simulaciones de OilFlow2D.

Ventana de diálogo

Diálogo Oil Pipeline Break Model

Controles del diálogo

Control Tipo Descripción
Calculation interval (seconds) field Paso de tiempo utilizado para calcular las fuentes de derrame.
Distance between spill points [Delta X] field Separación entre los puntos de ruptura a lo largo de la tubería.
Leak diameter field Diámetro de fuga utilizado para cada punto de ruptura; debe ser menor que el diámetro de la tubería.
Discharge coeff. (0-1) field Coeficiente de descarga para los cálculos del flujo de fuga.
Friction coeff. field Coeficiente de fricción de la tubería.
Density field Densidad del petróleo.
Kinematic viscosity field Viscosidad cinemática del petróleo.
Basic Model radio button Ejecuta el modelo básico sin temperatura de salida.
Heat Transfer Model radio button Ejecuta el modelo de transferencia de calor y habilita la temperatura de salida.
Output temp field Temperatura de salida para el modelo de transferencia de calor.
Initial pressure head at pipe end field Carga de presión inicial en el extremo de la tubería.
Initial flowrate field Caudal inicial en la tubería.
Valve closing time (seconds) field Tiempo de cierre de la válvula para las condiciones de contorno internas.
Oilpipeline nodes radio button Utiliza los valores Z de la geometría de Oilpipeline para asignar elevaciones.
DEM layer radio button Muestrea elevaciones de una capa ráster DEM.
DEM layer list dropdown Selecciona el ráster DEM que se muestreará.
Offset field Añade un desplazamiento de elevación al muestrear desde un DEM.
Get elevations from Multiple DEM Boundaries radio button Muestrea elevaciones utilizando la capa MultipleDemBoundaries.
Using local mesh checkbox Habilita las opciones de generación de malla local.
Cell Size field Tamaño de celda de la malla local alrededor de los puntos de derrame.
H/V Size field Proporción de la malla local relativa a las ubicaciones de derrame.
Run button Ejecuta la herramienta Oil Pipeline Break Model.
Close button Cierra el diálogo sin ejecutar la herramienta.

Flujo de trabajo

  1. Abra el menú OilFlow2D Tools y seleccione Run Oil Pipeline Break Model.

  2. Asegúrese de que la capa Oilpipeline esté cargada y contenga atributos válidos de diámetro y rugosidad.

  3. Opcional: cargue la capa OilPipelineValves si se necesitan puntos de válvula internos.

  4. Establezca el intervalo de cálculo, el espaciamiento de las rupturas (Delta X), el diámetro de fuga, el coeficiente de descarga y el coeficiente de fricción.

  5. Introduzca las propiedades del petróleo y elija el tipo de modelo (Basic o Heat Transfer). Si utiliza Heat Transfer, establezca la temperatura de salida.

  6. Proporcione la carga de presión inicial, el caudal inicial y el tiempo de cierre de la válvula.

  7. Seleccione cómo se asignarán las elevaciones: valores Z de Oilpipeline, capa DEM con desplazamiento u opción Multiple DEM Boundaries.

  8. Si es necesario, habilite las opciones de malla local y establezca Cell Size y H/V Size.

  9. Haga clic en Run. El plugin genera puntos de origen de derrame y agrega una capa Sources al grupo COMPONENTS.

  10. Guarde el proyecto de QGIS para conservar las fuentes generadas.

Requisitos

  • Debe estar configurado un proyecto OilFlow2D activo y su directorio de escenario.

  • La capa Oilpipeline debe existir y estar activa.

  • El diámetro de fuga debe ser menor que el atributo de diámetro de la tubería.

  • Si se utiliza el muestreo DEM, el ráster seleccionado debe cubrir la extensión de la tubería.

  • Si se selecciona Multiple DEM Boundaries, la capa MultipleDemBoundaries debe existir y contener entidades.

  • El ejecutable y la licencia del módulo Oil Pipeline deben estar disponibles.

Detalles técnicos

Cálculo del hidrograma del derrame

La herramienta escribe la geometría de la tubería y las entradas del usuario en datain.txt, output.txt y pointZ.txt, y luego ejecuta el módulo Oil Pipeline para calcular un hidrograma de descarga para cada punto de derrame generado. El módulo calcula primero la carga de energía estacionaria inicial a lo largo de la tubería a partir del caudal y la carga de presión introducidos, utilizando las pérdidas de tubería de Darcy-Weisbach y un factor de fricción procedente del ajuste del usuario o de la rugosidad de la tubería.

Para cada ruptura, la tubería se divide en un tramo contribuyente aguas arriba y otro aguas abajo. El tramo aguas abajo se trata como drenaje por gravedad desde la tubería. El tramo aguas arriba utiliza la ecuación del orificio de fuga

\[Q_l = C_d A_l \sqrt{2 g h_p}\]

donde \(Q_l\) es el caudal de la fuga, \(C_d\) es el coeficiente de descarga, \(A_l\) es el área de la fuga, \(g\) es la aceleración gravitatoria y \(h_p\) es la carga de presión local. Durante el período previo al cierre y de cierre de la válvula, la entrada aguas arriba se mantiene en el caudal inicial hasta la hora de inicio del cierre; después se reduce linealmente a cero durante el tiempo de cierre de la válvula. El volumen disponible de la tubería se actualiza en cada intervalo de cálculo y la carga de presión se reduce en proporción al volumen disponible restante.

Salidas

  • Crea archivos de fuentes de derrame en el directorio del escenario:

    • datain.txt, output.txt, pointZ.txt

    • opbmp.txt (parámetros guardados)

    • \<project>_spillSources.txt

  • Crea una capa Sources en shape/Sources.shp y la agrega al grupo COMPONENTS.

  • Al utilizar Multiple DEM Boundaries, escribe un archivo .MDPoly y convierte los rásteres a .asc cuando es necesario.

Notas de uso

  • Si falta la capa Oilpipeline, la herramienta no se ejecutará.

  • Si un DEM no cubre la tubería, la herramienta se detiene con un error.

  • Las advertencias de presión negativa aparecen en el panel de mensajes de registro de OF2D después del procesamiento.

  • Las unidades se basan en las unidades actuales del mapa del proyecto (metros o pies).

Herramienta HCA Impact Analysis

La herramienta HCA Impact Analysis calcula el impacto de los derrames de petróleo en las Áreas de Alta Consecuencia (HCA) mediante intersecciones espaciales entre los resultados de la simulación y los conjuntos de datos de HCA/líneas (NHD). El resultado incluye tablas de intersecciones y, opcionalmente, una capa de puntos con métricas del derrame para cada fuente.

Acceso a HCA Impact desde el menú Tools

Ventana de diálogo

Diálogo HCA Impact Analysis

Controles del diálogo

Control Tipo Descripción
HPA Area layer desplegable Selecciona la capa poligonal HPA (NHDArea).
HPA Area layer ID Field desplegable Campo identificador de la capa HPA (recomendado: OBJECTID).
OPA Area layer desplegable Selecciona la capa poligonal OPA.
OPA Area layer ID Field desplegable Campo identificador de la capa OPA (recomendado: OBJECTID).
ECO Area layer desplegable Selecciona la capa poligonal ECO.
ECO Area layer ID Field desplegable Campo identificador de la capa ECO (recomendado: OBJECTID).
DW Area layer desplegable Selecciona la capa poligonal DW.
DW Area layer ID Field desplegable Campo identificador de la capa DW (recomendado: OBJECTID).
CNW Polyline layer desplegable Selecciona la capa de polilíneas CNW (NHDLine).
CNW Polyline layer ID Field desplegable Campo identificador de la capa CNW (recomendado: OBJECTID).
Global Maximum Depth layer desplegable Mapa global integrado de profundidad máxima.
Global Arrival Time layer desplegable Mapa integrado del tiempo de llegada de la onda frontal.
Create Release Point Layer casilla Genera la capa releasePoint a partir de la capa Sources.
OK botón Ejecuta el análisis de impacto de HCA.
Close botón Cierra el diálogo sin ejecutarlo.

Flujo de trabajo

  1. Asegúrese de que los resultados de la simulación y los mapas integrados Global Maximum Depth y Global Arrival Time estén disponibles a partir de las herramientas de cartografía hidrodinámica.

  2. Abra OilFlow2D Tools → Oil Pipeline Break Model → HCA Impact.

  3. Seleccione las capas HPA/OPA/ECO/DW y la capa CNW, junto con sus campos de ID (se recomienda OBJECTID).

  4. Seleccione al menos un mapa de profundidad o de tiempo de llegada; el análisis requiere al menos uno de estos mapas.

  5. Opcionalmente, habilite Create Release Point Layer para generar la capa releasePoint.

  6. Haga clic en OK para ejecutar el análisis. Las capas y tablas de intersecciones se crean en el grupo TABLES.

Requisitos

  • Un proyecto OilFlow2D activo con resultados de derrames y una capa Sources.

  • Mapas integrados Global Maximum Depth y/o Global Arrival Time.

  • Capas NHDArea y NHDLine con un campo OBJECTID (o equivalente) para los identificadores.

  • Al menos una capa HCA/de líneas seleccionada, sin selecciones duplicadas en el diálogo.

  • Si las capas NHD proceden de una geodatabase/servicio REST, reproyéctelas al CRS del proyecto y convierta las geometrías curvas en segmentos rectos antes de ejecutar el análisis.

Detalles técnicos

Salidas

  • Crea tablas en el grupo TABLES: Spills-HPAAreas, Spills-OPAAreas, Spills-ECOAreas, Spills-DWAreas y Spills-CNWLine.

  • Opcionalmente, crea la capa releasePoint con métricas del derrame para cada fuente.

  • Vincula releasePoint con las tablas de HCA para las consultas Identify Features.

Resultados clave

Los campos clave de releasePoint incluyen: SPILLID, DRAINUPVOL, DRAINDWVOL, SPILLVOL, SPILLAREA, MAXQ, MEANQ, DRAINTIME y NHD_Intersected (yes/no). Las tablas Spills-NHDArea incluyen el volumen, el área y los tiempos de llegada mínimos y máximos por área; la tabla Spills-NHDLine incluye la longitud de intersección por segmento. Las unidades dependen del CRS del proyecto.

Consulta de relaciones desde releasePoint

Notas de uso

  • Si las capas NHDArea/NHDLine no tienen los nombres esperados, selecciónelas manualmente en el diálogo.

  • El análisis requiere al menos una capa HCA/de líneas y al menos una capa de profundidad o de tiempo de llegada.

  • No seleccione la misma capa en más de un campo del diálogo.

Herramienta de configuración de OilFlow2D

La herramienta de configuración de OilFlow2D proporciona una interfaz centralizada para configurar la carpeta de herramientas del modelo, las rutas del proyecto y las opciones de procesamiento de malla utilizadas por los proyectos OilFlow2D. El diálogo actual almacena la ruta de una carpeta y determina, a partir de esa carpeta, las rutas de los ejecutables del DIP y del motor; no solicita seleccionar un ejecutable individual.

Ventana de diálogo

Diálogo de configuración de OilFlow2D

La captura se conserva como referencia visual mientras está pendiente una captura de la versión actual. Utilice los nombres de los campos y el comportamiento descrito a continuación como la interfaz actual autorizada.

Controles del diálogo

Control Tipo Descripción
Model folder campo de texto Carpeta que contiene las herramientas del modelo de Hydronia, incluidos los ejecutables del DIP y del motor.
... (model folder) botón Abre un diálogo de carpetas para seleccionar la carpeta de herramientas del modelo.
OilFlow2D plugin folder campo de solo lectura Muestra la carpeta que contiene el complemento OilFlow2D activo.
Project Path campo de texto Directorio en el que se almacenan los archivos del proyecto.
Browse (project path) botón Abre un diálogo de directorios para seleccionar la carpeta del proyecto.
Scenario folder campo de solo lectura Muestra la carpeta del escenario asociada con el proyecto actual.
Resolution factor for gmsh campo de texto Valor numérico que determina el tamaño de los elementos de malla durante el procesamiento de gmsh. El valor predeterminado es 1.
Optimize mesh cell ordering casilla de verificación Al marcarla, habilita la optimización de la numeración de las celdas de malla para mejorar la eficiencia computacional.
OK botón Guarda la configuración y cierra el diálogo.
Cancel botón Cierra el diálogo sin guardar los cambios.

Flujo de trabajo

  1. Al iniciar la herramienta, comprueba que se haya configurado un proyecto OilFlow2D. Si no hay ningún proyecto configurado, aparece un mensaje de advertencia y el diálogo no se abre.

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

    • Los ajustes de la aplicación QGIS (para la carpeta de herramientas del modelo).

    • Los ajustes específicos del proyecto (para la ruta del proyecto, la carpeta del escenario y la configuración de la malla).

  3. El usuario puede modificar cualquiera de los siguientes ajustes:

    • Model folder: Carpeta que contiene las herramientas DIP y el motor del modelo de Hydronia, normalmente C:/Program Files/Hydronia/Models.

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

    • OilFlow2D plugin folder y Scenario folder: Valores de solo lectura que identifican el complemento activo y el escenario del proyecto actual.

    • Resolution factor for gmsh: Valor numérico que controla el tamaño de los elementos 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 malla con el fin de mejorar el rendimiento computacional.

  4. Después de realizar los cambios deseados, al hacer clic en \"OK\" se guarda toda la configuración:

    • La carpeta de herramientas del modelo se guarda en los ajustes de la aplicación QGIS.

    • La ruta del proyecto, el factor de resolución y el ajuste de optimización de la malla se guardan en el proyecto actual de QGIS; las carpetas del complemento y del escenario permanecen como información.

  5. Las opciones guardadas son utilizadas posteriormente por otras herramientas del plugin, incluida la generación de mallas, la ejecución de simulaciones y el procesamiento de resultados.

Requisitos

  • Se requiere una instalación válida de OilFlow2D con las herramientas del modelo de Hydronia.

  • El usuario debe tener los permisos adecuados para acceder a la carpeta de herramientas del modelo y ejecutar sus programas.

  • El directorio de la ruta del proyecto debe existir y el usuario debe poder escribir en él.

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

  • Utilice un factor de resolución numérico adecuado para el flujo de trabajo de la malla. El diálogo actual utiliza 1 como valor predeterminado y no documenta un rango universal válido; consulte las indicaciones de Hydronia antes de cambiarlo.

Detalles técnicos

Detalles de configuración

Carpeta del modelo

La carpeta del modelo se utiliza para localizar el Programa de Entrada de Datos (DIP) de Hydronia, el motor del modelo y las herramientas relacionadas. La carpeta predeterminada configurada es:

C:/Program Files/Hydronia/Models

El complemento resuelve RiverFlow2DDIP.exe (DIP clásico) y RiverFlow2Dm5.exe (el motor secundario del modelo) desde la carpeta del modelo seleccionada. La carpeta heredada C:/Program Files/Hydronia/RiverFlow2D puede utilizarse como compatibilidad. Introduzca la carpeta, no la ruta a ninguno de los ejecutables, en Model folder.

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 la 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 superiores a 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 las celdas de malla

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

  • La reordenación de las celdas de malla para minimizar el ancho de banda de la matriz del sistema.

  • La reducción de los requisitos de memoria durante la simulación.

  • La posible disminución del tiempo de simulación, especialmente en mallas grandes.

Mejores prácticas

Si se le indica que lo haga o está seguro de la configuración, puede cambiarla para ayudar a resolver un problema. Si no está seguro de la configuración, póngase en contacto con el soporte de Hydronia.

  • En ocasiones, QGIS puede ubicar incorrectamente la ruta del archivo del proyecto; establecerla aquí ayudará al plugin a encontrar el archivo del proyecto en esos casos.

  • Al trabajar con dominios grandes:

    • Para las pruebas y la calibración iniciales, utilice un factor de resolución conservador y compare la malla resultante con los requisitos del proyecto.

    • Ajuste gradualmente el factor de resolución para las ejecuciones finales de producción y compruebe la calidad de la malla y el tiempo de ejecución después de cada cambio.

  • Habilite la optimización de las celdas de malla cuando sea apropiado para el flujo de trabajo del proyecto o cuando lo recomiende el soporte de Hydronia. El diálogo actual no impone un umbral de número de celdas.

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

Herramienta Multi-hydrograph to Single-hydrograph Files

La herramienta Multi-hydrograph to Single-hydrograph Files ofrece una función especializada para convertir datos de hidrogramas de series temporales, almacenados en un formato combinado de archivo de múltiples fuentes, en archivos individuales de un solo hidrograma. Es especialmente útil para preparar entradas hidrológicas para simulaciones cuando se trabaja con múltiples fuentes de entrada almacenadas inicialmente en un archivo de datos unificado.

Ventana de diálogo

Diálogo Multi-hydrograph to Single-hydrograph Files

Controles del diálogo

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

Flujo de trabajo

  1. Al iniciarse, la herramienta establece automáticamente el directorio de salida predeterminado en el directorio del escenario del proyecto actual.

  2. El usuario selecciona un archivo de entrada de múltiples hidrogramas de una de estas formas:

    • Escribiendo la ruta completa en el campo \"Multiple hydrograph file\"; o

    • Haciendo clic en el botón \"Browse\" para buscar y seleccionar el archivo.

  3. La herramienta completa automáticamente el campo \"Output folder\" con el directorio que contiene el archivo de entrada seleccionado, aunque el usuario puede especificar otra ubicación de salida si lo desea.

  4. El usuario puede personalizar el prefijo de los archivos generados modificando el campo \"Prefix for single hydrograph files\". El prefijo predeterminado es \"Hydrog_\".

  5. El usuario selecciona el formato adecuado en el desplegable \"Format file\". Actualmente, la herramienta admite archivos con formato HEC-DSSVue.

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

    • Lee el archivo de entrada de múltiples hidrogramas.

    • Identifica el número de hidrogramas independientes que contiene.

    • Crea archivos individuales para cada hidrograma.

    • Asigna a cada archivo el prefijo especificado seguido de un número secuencial.

    • Muestra un mensaje de resumen con el número de archivos creados.

  7. La herramienta muestra un mensaje de finalización que indica el número de archivos de hidrograma creados correctamente.

Requisitos

  • Se recomienda un proyecto OilFlow2D activo para una gestión adecuada de las rutas de archivo, aunque no es estrictamente necesario.

  • El archivo de múltiples hidrogramas de entrada debe tener el formato correcto según el estándar HEC-DSSVue, con los valores de tiempo en las columnas esperadas.

  • El usuario debe tener permisos de escritura en 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 caudal para los distintos hidrogramas a partir de la columna 6.

Detalles técnicos

Detalles del procesamiento de archivos

La herramienta procesa archivos con formato HEC-DSSVue mediante el siguiente procedimiento:

  1. Se examina el archivo para determinar el número de filas y columnas de datos.

  2. La herramienta identifica cuántos hidrogramas independientes hay contando el número de columnas de datos posteriores a 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 nombres: [prefix][number].txt (por ejemplo, \"Hydrog_1.txt\", \"Hydrog_2.txt\").

  4. Cada archivo de salida se estructura 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 de caudal.

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

Mejores prácticas

  • Utilice esta herramienta al principio del proceso de configuración del proyecto OilFlow2D, al preparar los datos de entrada.

  • Compruebe que los archivos de un solo hidrograma generados tengan el número correcto de puntos de tiempo y los intervalos adecuados antes de utilizarlos en las simulaciones.

  • Conserve el archivo original de múltiples hidrogramas como copia de seguridad por si necesita volver a generar los archivos individuales con otros ajustes.

  • Al administrar múltiples fuentes de entrada, use prefijos descriptivos para identificar claramente el propósito de cada conjunto de hidrogramas (por ejemplo, \"Inflow_\", \"Tributary_\").

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

  • Después de generar los archivos de hidrogramas, utilice la herramienta Source de OilFlow2D para asignarlos correctamente a los puntos fuente del modelo.

Herramienta Import Single to Multi-scenario Project

Esta herramienta facilita la migración de proyectos OilFlow2D independientes al marco de múltiples escenarios, lo que permite organizar y comparar varios escenarios de simulación dentro de un único proyecto de QGIS.

Ventana de diálogo

Diálogo Import Single to Multi-scenario Project

Controles del diálogo

Control Tipo Descripción
.DAT File Name campo de texto Campo de solo lectura que muestra la ruta al archivo de proyecto OilFlow2D seleccionado (.dat).
Browse botón Abre un diálogo de archivos para seleccionar el archivo de proyecto OilFlow2D (.dat) que se importará.
OK botón Inicia el proceso de importación después de confirmar el archivo de proyecto seleccionado.
Cancel botón Cierra el diálogo sin importar ningún proyecto.

Flujo de trabajo

  1. Al iniciarse, la herramienta comprueba si ya existe una estructura de proyecto de múltiples escenarios. Si no existe, solicita al usuario que cree una primero.

  2. El usuario selecciona un archivo de proyecto OilFlow2D (.dat) haciendo clic en el botón de exploración, que abre un diálogo de selección de archivos. Solo 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 \"OK\", la herramienta realiza las siguientes operaciones:

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

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

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

    • Actualiza las rutas de archivo del proyecto para reflejar la nueva ubicación.

    • Registra el nuevo escenario en la configuración del proyecto de múltiples escenarios.

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

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

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

Requisitos

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

  • El proyecto de origen debe ser un proyecto OilFlow2D válido, con un archivo .dat correcto y los 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 para copiar todos los archivos del proyecto a la nueva ubicación.

  • El proyecto de QGIS debe guardarse antes de realizar la importación para garantizar que se conserven correctamente todos los ajustes actuales.

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 de múltiples escenarios 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 los escenarios existentes.

  3. Creación de directorios: Crea un nuevo directorio de escenario dentro de la estructura del proyecto de múltiples escenarios.

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

  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 las fuentes de las capas: Modifica las fuentes de datos de las capas de QGIS para que apunten a los archivos de la nueva ubicación.

La herramienta conserva toda la estructura del proyecto, incluidos:

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

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

  • Archivos de datos de entrada (hidrogramas, 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 proyecto independiente para evitar transferir problemas de configuración.

  • Al trabajar con proyectos grandes que contienen muchos datos de salida, considere eliminar los resultados de simulación innecesarios antes de importarlos para reducir el tiempo y los requisitos de almacenamiento.

  • Después de la importación, compruebe que todas las capas y referencias estén correctamente vinculadas en el nuevo escenario.

  • Conserve una copia de seguridad del proyecto independiente original hasta confirmar que el escenario importado funciona correctamente.