Herramientas de exportación¶

Este capítulo describe las opciones de exportación disponibles para el modelo activo y cómo se configuran los archivos de salida.

Exportar la hidrodinámica de OilFlow2D¶

Ventana del diálogo¶

El siguiente diálogo es la interfaz principal para configurar e iniciar el proceso de exportación del modelo OilFlow2D. Recopila información sobre las capas de entrada y los componentes específicos que se incluirán en la exportación.

Controles del diálogo¶

La siguiente tabla describe los controles disponibles en el diálogo de exportación.

Nombre del control	Tipo	Descripción
Project Directory	Campo de texto	Muestra la ruta completa al directorio de salida del escenario actual dentro del proyecto. (Solo lectura)
Scenario Name	Campo de texto	Muestra el nombre del escenario actual que se está exportando. (Solo lectura)
DEM (Single Raster)	Desplegable	Selecciona la única capa ráster que representa la topografía/elevación del lecho. Solo está habilitada si no está activa ninguna de las opciones 'Using TriMesh Elevation' ni 'Get elevations from Multiple DEM Boundaries'. Se rellena con las capas ráster disponibles.
Using TriMesh Elevation (not resampling elevations)	Casilla	Habilita el uso de los datos de elevación directamente de los vértices/nodos de la capa 'TriMesh' en lugar de remuestrearlos desde un ráster DEM. Deshabilita las opciones de selección de DEM. Se marca automáticamente si la malla se generó mediante la herramienta \"Generate TriMesh with Elevation\".
Get elevations from Multiple DEM Boundaries	Casilla	Habilita el uso de datos de elevación basados en los límites definidos en una capa 'MultipleDemBoundaries'. Deshabilita el desplegable 'DEM (Single Raster)'. Requiere que esté presente la capa 'MultipleDemBoundaries'.
Using Manning N Raster Layer	Casilla	Habilita el uso de valores de n de Manning muestreados de una capa ráster seleccionada en lugar de una capa vectorial. Habilita el desplegable 'Manning N Raster Layer'.
Manning N Raster Layer	Desplegable	Selecciona la capa ráster que contiene los valores de n de Manning. Solo está habilitada cuando está marcada 'Using Manning N Raster Layer'. Se rellena con las capas ráster disponibles.
Using Initial WSE Raster Layer	Casilla	Habilita el uso de valores iniciales de elevación de la superficie del agua (WSE) muestreados de una capa ráster seleccionada. Habilita el desplegable 'Initial WSE Raster Layer'.
Initial WSE Raster Layer	Desplegable	Selecciona la capa ráster que contiene los valores iniciales de WSE. Solo está habilitada cuando está marcada 'Using Initial WSE Raster Layer'. Se rellena con las capas ráster disponibles.
Rewrite .DAT file	Casilla	Habilita la regeneración y sobrescritura forzadas del archivo de control principal de OilFlow2D ('.dat').
Use external routine to sample cell elevations	Casilla	Habilita el uso del ejecutable externo ('ASCIISamplingC.exe') para muestrear los valores de elevación de las celdas/centroides de la malla. Esto puede ser más rápido o procesar grandes conjuntos de datos de forma diferente a los métodos internos de QGIS.
OK	Botón	Confirma las selecciones e inicia el proceso de exportación según las opciones elegidas y las capas detectadas.
Cancel	Botón	Cierra el diálogo sin exportar archivos.

Flujo de trabajo¶

El flujo de trabajo típico para usar la herramienta Export Files to OilFlow2D es el siguiente:

Asegúrese de que todas las capas de entrada requeridas (por ejemplo, 'TriMesh', 'Manning N'/'Nr'/'Nz', capas opcionales como 'Boundary Conditions', 'Weirs', 'Bridges', rásteres DEM, etc.) estén cargadas en el proyecto de QGIS y cumplan los requisitos (consulte la sección 2.1.4). Asegúrese de que la capa 'Domain Outline', si está presente, no esté en modo de edición.
Active la herramienta desde el menú o la barra de herramientas del complemento OilFlow2D. Esto abrirá el diálogo Export Files to OilFlow2D (Figura 2.2).
Verifique que Project Directory y Scenario Name se muestren correctamente y reflejen el proyecto actual y el escenario activo.
Haga clic en OK para iniciar el proceso de exportación o, si necesita configurar parámetros adicionales, revise el cuadro de grupo Options.
(Opcional) Configure si los datos de rugosidad de Manning deben obtenerse de una capa ráster.
(Opcional) Seleccione la casilla para usar un ráster para la elevación inicial de la superficie del agua.
(Opcional) Decida si desea usar la rutina externa de muestreo de elevaciones y si desea forzar la reescritura del archivo '.dat'.
Haga clic en OK.
La herramienta realiza comprobaciones de requisitos (por ejemplo, existencia de capas, compatibilidad de CRS y capas vacías).
Si las comprobaciones tienen éxito, la herramienta continúa con la exportación. Crea una capa de centroides, muestrea los datos necesarios (elevación, rugosidad y WSE inicial) según las opciones seleccionadas y exporta varios archivos de componentes ('.TGates', '.TWeirs', '.TBridges', '.TDams', '.THydnet', '.OBC', etc.) según la presencia de las capas correspondientes en el proyecto de QGIS (por ejemplo, 'Gates', 'Weirs', 'Bridges', 'DamBreach', 'Channels1D', 'Boundary Conditions', etc.).
Finalmente, genera los archivos principales de entrada del modelo: el archivo de geometría/malla ('.fed') y el archivo de datos de control ('.dat'). También pueden crearse otros archivos auxiliares como '.plt' y '.qgisunits'.
Todos los archivos exportados se guardan en un subdirectorio cuyo nombre es el del escenario actual, dentro del directorio principal del proyecto. Tras finalizar correctamente aparecerá un mensaje de confirmación; si se producen problemas, se mostrarán mensajes de error.

Requisitos¶

Antes de usar la herramienta de exportación, asegúrese de cumplir los siguientes requisitos:

Debe estar cargado un proyecto de QGIS.
El proyecto debe tener un escenario actual definido. Esto determina el subdirectorio de salida y los nombres de los archivos.
Debe existir una capa de malla llamada 'TriMesh' y estar activa en el panel de capas. Esta proporciona la geometría principal de la malla.
Debe haber al menos una fuente de rugosidad de Manning disponible y activa: una capa vectorial llamada 'Manning N' o capas ráster llamadas 'Manning Nr' o 'Manning Nz'.
- No se permite tener activas simultáneamente 'Manning N' (vectorial) y 'Manning Nz' (ráster).
- No se permite tener activas simultáneamente 'Manning N' (vectorial) y 'Manning Nr' (ráster).
Ninguna capa debe estar en modo de edición. Guarde las ediciones y desactive la edición de las capas antes de exportar.
Si se va a utilizar la opción 'Get elevations from Multiple DEM Boundaries', debe estar presente una capa llamada 'MultipleDemBoundaries'.
Todas las capas de entrada relevantes (malla, DEM, fuentes de rugosidad y capas de componentes) deben tener Sistemas de Referencia de Coordenadas (CRS) compatibles.
Las capas de entrada activas no deben estar vacías (sin entidades ni datos válidos).

El incumplimiento de estos requisitos probablemente dará lugar a mensajes de error en la barra de mensajes de QGIS e impedirá que se complete la exportación.

Detalles técnicos¶

Los principales archivos de salida generados son el archivo de geometría/malla del modelo ('.fed') y el archivo principal de datos de control de entrada ('.dat'). También suelen generarse un archivo de datos de gráficos ('.plt') y un archivo de unidades ('.qgisunits').
Se generan condicionalmente numerosos archivos de entrada específicos de componentes, según la presencia de capas con nombres específicos en el proyecto de QGIS. Estos incluyen: .dOut ('Domain Outline'), .TGates ('Gates'), .IRT ('InternalRatingTable'), .TWeirs ('Weirs'), .TDams ('DamBreach'), .TBridges ('Bridges'), .THydnet ('Channels1D'), .OBC/.OBCP ('Boundary Conditions'), .OBS ('Observation Points'), .source ('Sources'), .scour ('ScourFromPiers', 'ScourFromAbutment'), .lswmm ('LSWMM'), .MannN/.MannN2 ('Manning N' vector/raster), .Linf/.Lrain/.Wind/.initConc (capas relacionadas con la infiltración, la lluvia, el viento y la concentración inicial).
Todos los archivos exportados se guardan dentro de un subdirectorio cuyo nombre es el del escenario actual, ubicado dentro del directorio principal del proyecto identificado en el diálogo.
Durante el proceso se crea una capa temporal de centroides mediante centroide_layer().

Exportar archivo OILW¶

Este diálogo permite al usuario configurar y exportar el archivo de entrada necesario para ejecutar simulaciones de intemperismo y transporte de petróleo en OilFlow2D.

Controles del diálogo¶

La siguiente tabla describe los controles disponibles en el diálogo Export OILW File.

Nombre del control	Tipo	Descripción
Compute Evaporation	Casilla	Habilita la simulación del proceso de evaporación.
Compute Emulsification	Casilla	Habilita la simulación del proceso de emulsificación.
Compute Booms	Casilla	Habilita la simulación de barreras de contención. Requiere una capa 'Booms'.
Compute Shoreline	Casilla	Habilita la simulación de la interacción con la línea de costa.
Compute Dispersion	Casilla	Habilita la simulación del proceso de dispersión.
Compute Dissolution	Casilla	Habilita la simulación del proceso de disolución.
Compute Sedimentation	Casilla	Habilita la simulación del proceso de sedimentación.
SimulationTime (hr)	Campo de texto	Introduzca la duración total de la simulación en horas.
Output Interval (hr)	Campo de texto	Introduzca el intervalo de tiempo para escribir los resultados de salida en horas.
Time Step (sec)	Campo de texto	Introduzca el paso de tiempo de la simulación en segundos.
Velocity Field Path	Campo de texto (solo lectura)	Muestra la ruta al directorio que contiene los datos del campo de velocidad (normalmente el directorio del escenario actual).
Wind Velocity File	Campo de texto	Introduzca el nombre del archivo que contiene los datos de velocidad del viento. Use el botón de exploración para seleccionarlo.
... (Browse Wind)	Botón	Abre un diálogo de archivos para seleccionar Wind Velocity File.
Ambient Temperature File	Campo de texto	Introduzca el nombre del archivo que contiene los datos de temperatura ambiente. Use el botón de exploración para seleccionarlo.
... (Browse Temp)	Botón	Abre un diálogo de archivos para seleccionar Ambient Temperature File.
OK	Botón	Confirma la configuración e inicia el proceso de exportación.
Cancel	Botón	Cierra el diálogo sin exportar el archivo.

Flujo de trabajo¶

El flujo de trabajo típico para usar la herramienta Export OILW File es el siguiente:

Asegúrese de que la capa de puntos 'OilSpills' y/o la capa de líneas 'OilSpillsRelease' requeridas estén cargadas en el proyecto de QGIS y cumplan los requisitos (consulte la sección 2.2.3). Los atributos de estas capas definen las ubicaciones/fuentes de los derrames y sus propiedades.
Si va a simular barreras, asegúrese de que la capa de líneas 'Booms' requerida esté cargada.
Asegúrese de que los archivos principales de la simulación hidrodinámica de OilFlow2D (especialmente .dat) ya se hayan exportado para el escenario actual mediante la herramienta principal de exportación (sección 2.1).
Active la herramienta desde el menú o la barra de herramientas del complemento OilFlow2D (normalmente en un submenú como 'Modules' o similar).
Se abrirá el diálogo Export OILW File (Figura 2.3).
Marque o desmarque las distintas opciones 'Compute...' (Evaporation, Emulsification, Booms, Shoreline, Dispersion, Dissolution, Sedimentation) según los requisitos de la simulación.
Introduzca los valores deseados de 'SimulationTime', 'Output Interval' y 'Time Step'. Estos valores pueden estar precargados desde un archivo de parámetros ('Oilwparamxport.txt') si existe en el directorio del escenario.
Verifique que 'Velocity Field Path' sea correcto (debe apuntar al directorio del escenario actual).
Introduzca los nombres de archivo de 'Wind Velocity File' y 'Ambient Temperature File', o use los botones de exploración ('...') para seleccionarlos. Estos archivos deben existir en el directorio del escenario.
Haga clic en OK.
La herramienta realiza comprobaciones de requisitos (por ejemplo, existencia de capas, compatibilidad de CRS, campos de control no vacíos y existencia de archivos dentro de la carpeta del escenario).
Si las comprobaciones tienen éxito, la herramienta genera el archivo de entrada de intemperismo del petróleo ( OILW) en el directorio del escenario actual usando los datos del diálogo y los atributos relevantes de las capas de derrames/barreras.
Si está presente una capa 'OilSpillsRelease', se generan archivos de trayectoria de derrame ('.pth') separados para cada entidad mediante spillReleaseFile().
Si está marcada la opción 'Compute Booms' y está presente una capa 'Booms', se genera un archivo de datos de barreras ( booms) mediante spillBoomFile().
A continuación, la herramienta lee el archivo .dat existente del escenario, actualiza un indicador específico para señalar que la simulación de derrames de petróleo está activa (indicador establecido en 3) y reescribe el archivo .dat.
Se crea o actualiza un archivo de exportación de parámetros de petróleo ('Oilwparamxport.txt') en el directorio del escenario para guardar la configuración del diálogo.
El ejecutable de OilFlow2D (específicamente OilFlow2DDIP.exe) puede iniciarse automáticamente con los archivos generados.
Se mostrará un mensaje de confirmación o de error en la barra de mensajes de QGIS.

Requisitos¶

Antes de usar la herramienta Export OILW File, asegúrese de cumplir los siguientes requisitos:

Debe estar cargado un proyecto de QGIS con un escenario actual definido.
La exportación hidrodinámica principal de OilFlow2D (sección 2.1) debe haberse ejecutado previamente para el escenario actual y haber creado los archivos base necesarios, como .dat y .OUTFILES.
Debe estar presente y activa al menos una capa de fuente de petróleo: 'OilSpills' (capa de puntos para derrames instantáneos) o 'OilSpillsRelease' (capa de líneas para trayectorias de liberación continua). Estas capas deben contener entidades con los atributos específicos requeridos por la función fileOilSpills() (por ejemplo, parámetros de densidad, viscosidad, tiempo, dispersión y evaporación, entre otros).
Si está marcada la opción 'Compute Booms' ( cBox_booms), debe estar presente y activa una capa vectorial de líneas llamada 'Booms'. Debe tener los atributos adecuados para las propiedades de las barreras.
Las capas de fuentes ('OilSpills', 'OilSpillsRelease', 'Booms') no deben estar vacías si están presentes.
Todas las capas involucradas deben tener Sistemas de Referencia de Coordenadas (CRS) compatibles. La herramienta realiza una comprobación.
Los campos de entrada requeridos en el diálogo (SimulationTime, Output Interval, Wind Velocity File, Ambient Temperature File) no deben estar vacíos.
Los archivos seleccionados Wind Velocity File y Ambient Temperature File deben residir dentro del directorio del escenario actual.

El incumplimiento de estos requisitos generará mensajes de error e impedirá que se complete la exportación.

Detalles técnicos¶

El principal archivo de salida generado por esta herramienta es el archivo de entrada de intemperismo del petróleo ( OILW).
Si se definen derrames continuos mediante una capa 'OilSpillsRelease', también se generan los archivos de trayectoria correspondientes ( pth) para cada fuente de liberación.
Si la función de barreras está habilitada y existe una capa 'Booms', se genera un archivo booms.
La herramienta modifica el archivo de datos de control principal existente de OilFlow2D leyéndolo ( readDAT()) y reescribiéndolo ( rewriteDAT()) con un indicador específico (índice 15) establecido en 3 para habilitar el módulo de derrames de petróleo en el motor de OilFlow2D.
El archivo .OILW es generado por la función fileOilSpills(), que lee los datos de control del diálogo y la información detallada de los derrames de los atributos de las entidades de las capas 'OilSpills' y/o 'OilSpillsRelease'. Incluye secciones para los parámetros [Trajectory], [Evaporation], [Emulsification], [Dissolution], [Dispersion], [Sedimentation] y [Shoreline] según los atributos y la configuración del diálogo.
La función oilwParameterFile() (llamada desde tools.py) guarda un archivo de parámetros ('Oilwparamxport.txt') en el directorio del escenario para conservar la configuración del diálogo (tiempo, intervalo de salida, archivo de viento y archivo de temperatura).
La herramienta intenta iniciar automáticamente el ejecutable de OilFlow2D (específicamente OilFlow2DDIP.exe, que gestiona los derrames de petróleo) usando los archivos .OILW y .dat modificados mediante la función callRiverFlow().