-------------------
GENERAL INFORMATION
-------------------

 Dataset title: Supplementary data to publication: 
                "Investigating the Relationship between Simulation Parameters and Flow Variables in Simulating Atmospheric Gravity Waves in Wind Energy Applications"

 Authorship: 
            Name: Mehtab Ahmed Khan
            Institution: Delft University of Technology 
            Email: m.a.khan-2@tudelft.nl
            ORCID: https://orcid.org/0000-0001-7953-0941

-------------------
 DESCRIPTION
-------------------

 This is a README file for a numerical data repository on 4TU DOI: 10.4121/6737d3a7-cdeb-41d3-b0b2-11915e4b6cec. The repository contains analyzed and example raw data acquired from 

 numerical simulation of flow over a bell-shaped hill (WOA) and through wind farm canopy (WFC) under idealized linearly stratified temperature conditions.

 A simulation setup of each scenario from SOWFA-6, the large eddy simulation code used for this study, is also provided.

 The analyzed data is numerical results, mainly line plots, presented in the manuscript titled 

 "Investigating the Relationship between Simulation Parameters and Flow Variables in Simulating Atmospheric Gravity Waves in Wind Energy Applications". 

 The folder tree and the data contained in it are described below.

 

 anlysed_data: A .xlsx file containing 4 sheets containing the data and line plots in the journal article.

 example_code_data: A set of .vtk files each containing the velocity field for the WOA scenario, and a jupyter notebook that reads these files for estimating 

        reflection coefficient (Cr) and relative-root mean square error (R-RMSE) from the vertical velocity component.  

 example_setups: Example model setup files from SOWFA-6, one each for WOA and WFC simulations under linearly stratified conditions, and a successor WFC case for conventionally neutral boundary layer conditions from TOSCA.
 -----------------------------------
 Description of "analysed_data.xlsx"
 -----------------------------------
 This excle file has tabulated processed data and associated line plots given in the journal article. 
 
 Sheet "General_plots_WOA" has data and plots from the WOA scenario for figures 3, 6, and 8 that are about wavelengths as a function of Froude Number, dynamic similarity, 
 and reflection coefficeint as a function of damping coefficeint for a range of Froude number, respectively. 
 
 Sheet "DampingCharacteristics" contains data and plots from WOA and WFC simulations for reflection coefficeint as a function of damping thickness and damping coefficeint 
 for Froude number 0.1 and 0.5. This sheet concerns plots in figures 9 and 11.

 Sheet "DomainLength" contains data and plots from WOA and WFC simulations for reflection coefficeint as a function of domain length normailised with effective horizontal 
 wavelength for Froude number 0.1 and 0.5. Similar data and plots are given from WOA case for conventionally neutral boundary layer (CNBL) presented in the conference paper 
 "Recommendations on setup in simulating atmospheric gravity waves under conventionally neutral boundary layer conditions." This sheet concerns plots in figure 10a and 13a.
 
 Sheet "DampingHeight" contains data and plots from WOA and WFC simulations for reflection coefficeint as a function of non-damped domain height nomalised with effective
 vertical wavelength and for Froude number 0.1 and 0.5. This sheet concerns plots in figure 10b and 13b.
 ----------------------------------
 Description of 'example_code_data'
 ----------------------------------
 This folder contains example code and example raw data that demostrates the analysis.
 
 The jupyter notebook "example_code_for_analysis.ipynb" has the code to read and process the vertical velocity from the ".vtk" files. The modules required for reading and analyses are given in the first cell.
 The function used to estimate reflection coefficeint and relative-root mean square error are also provided. 
 
 The zip folder "example_data" contains the an exmaple set of ".vtk" files from the LES-simulations of flow over the WOA. The file naming convention includes the Froude number, inflow velocity,
 Brunt Vaisala frequency, half-hill width, damping coefficeint, and damping thickness normalised with vertical wavelength. Each parameter is followed by its value used in the simulation but doesn't 
 mention the units, i.e., "fr_0.1_U_2.5_N_0.01_L_2.5_dc0.01_Ld1.0.vtk", where L is in kilometers, 2.5km in this case, and the rest are in SI units. 

 -------------------------------
 Description of "example_setups"
 -------------------------------
 This folder contains a model setup each for the WOA and WFC simulations performed with SOWFA-6. Note that the WFC was implemented in SOWFA-6 for the WFC simulations. This SOWFA-6
 version can be pulled from "https://github.com/mchurchf/SOWFA-6.git" and switching to the brunch "f/windFarmCanopy". 

 WOA_linearlyStratified.zip has a sample SOWFA-6 setup to simulate flow over the WOA under linearly stratified conditions similar to descriptions in the journal article.
 
 WFC_linearlyStratified.zip has a sample SOWFA-6 setup to simulate flow through a WFC under linearly stratified conditions similar to descriptions in the journal article.

 WFC_CNBL.zip has a sample setup to simulate flow through a WFC under conventionally neutral boundary layer conditions similar to descriptions in the conference article. This is a TOSCA successor setup
 without the inflowDatabase from the offline precursor due to lack of storage. The precursor data can be created using a relevent test case from https://github.com/sebastipa/TOSCA/tree/master/tests.

