|
|
|
# Benchmark
|
|
|
|
HERMESv3_GR contains data and scripts to execute a benchmark run that demonstrates the model and ensures that the installation process was successfull.
|
|
|
|
The proposed benchmark case produces 24 hour emissions for a global 1*1.4 degree horizontal resolution grid with 15 vertical layers.
|
|
|
|
|
|
|
|
![NO2_benchamrk_case](img_Benchmark_NO2_2018010100.png)
|
|
|
|
![NO2_benchamrk_case](img_Benchmark_NO2_2018010121.png)
|
|
|
|
|
|
|
|
To execute the benchmark case, the following steps need to be followed:
|
|
|
|
|
|
|
|
1. Install HERMESv3_GR
|
|
|
|
|
|
|
|
HERMESv3_GR should be installed following the instructions of the [installation page](../user_guide/user_guide_how_to_install).
|
|
|
|
Once all the executables are installed we are able to start the benchmark process.
|
|
|
|
|
|
|
|
2. Copy configuration and profile files
|
|
|
|
|
|
|
|
The second step is to copy the profiles and configuration files. To do that we use the ```hermesv3_gr_copy_config_files``` executable
|
|
|
|
|
|
|
|
```bash
|
|
|
|
hermesv3_gr_copy_config_files '/home/user/HERMES/HERMES_IN'
|
|
|
|
```
|
|
|
|
|
|
|
|
Now the data is stored in the defined __HERMES_IN__ folder.
|
|
|
|
|
|
|
|
3. Download the emission inventory files and the HERMESv3_GR benchmark output
|
|
|
|
|
|
|
|
This step allows to download a set of emission input files that have already been pre-processed to be used as HERMESv3_GR input files.
|
|
|
|
|
|
|
|
```hermesv3_gr_download_benchmark``` allows the user to download that files into a specific folder
|
|
|
|
```bash
|
|
|
|
hermesv3_gr_download_benchmark '/home/user/HERMES/'
|
|
|
|
```
|
|
|
|
|
|
|
|
Now we have the input data in the '/home/user/HERMES/datasets' path and the benchmark output in the '/home/user/HERMES/HERMES_OUT' path.
|
|
|
|
|
|
|
|
4. Modify the configuration file
|
|
|
|
|
|
|
|
We have to specify to HERMESv3_GR where are all that data that we have prepared before. The way to do that is passing it through argument of editing the configuration file. In that tutorial we are going to modify the configuration file.
|
|
|
|
|
|
|
|
Open the configuration file using a text editor (e.g. vi)
|
|
|
|
```bash
|
|
|
|
vi /home/user/HERMES/HERMES_IN/conf/hermes.conf
|
|
|
|
```
|
|
|
|
Once open we have to modify the _input_dir_, _data_path_ and _output_dir_ parameters:
|
|
|
|
|
|
|
|
```text
|
|
|
|
input_dir = /home/user/HERMES/HERMES_IN
|
|
|
|
data_path = /home/user/HERMES/HERMESv3_GR_Benchmark/EmissionInventories
|
|
|
|
output_dir = /home/user/HERMES/HERMES_OUT
|
|
|
|
```
|
|
|
|
|
|
|
|
Once we have modified that parameters HERMESv3_GR is ready to run
|
|
|
|
|
|
|
|
5. Run HERMESv3_GR Model
|
|
|
|
|
|
|
|
To run the HEMRESv3_GR model is available the executable hermesv3_gr.
|
|
|
|
|
|
|
|
Calling the executable and passing the configuration file through argument is the only needed to run the benchmark:
|
|
|
|
```bash
|
|
|
|
hermesv3_gr -c '/home/user/HERMES/HERMES_IN/conf/hermes.conf'
|
|
|
|
```
|
|
|
|
|
|
|
|
That test, and all the HERMESv3_GR simulations, can be run in parallel and is recommended to run the benchmark in the parallel mode.
|
|
|
|
```bash
|
|
|
|
mpirun -np 24 hermesv3_gr -c '/home/user/HERMES/HERMES_IN/conf/hermes.conf'
|
|
|
|
```
|
|
|
|
|
|
|
|
In the output folder will be created a new 'logs' folder to store the logs provided by each processor and follows the execution of HERMESv3_GR.
|
|
|
|
|
|
|
|
You have to know that the first simulation of HERMESv3_GR will take lot of time because all the auxiliary files have to be created, once created HERMESv3_GR will use them in future simulations of the same domain.
|
|
|
|
|
|
|
|
6. Compare the results
|
|
|
|
|
|
|
|
Once finished the simulation you have to compare the results obtained with the benchmark one stored at /home/user/HERMES/HERMES_OUT/benchmark.nc path.
|
|
|
|
Note that the benchmark output was created using the Python library pytz version 2017.2. The execution of HERMESv3 using a different version of this library may produce slightly different results in certain countries due to the updates in the local time zone descriptions introduced in this library.
|
|
|
|
|
|
|
|
\ No newline at end of file |