From 4cb2b6e92dbb5e04b3c6a16302b665a57578155a Mon Sep 17 00:00:00 2001
From: Stefano Serafin <serafin@srvx1.img.univie.ac.at>
Date: Fri, 5 May 2023 16:01:48 +0200
Subject: [PATCH] added link to config files in WRF.md

---
 WRF.md | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/WRF.md b/WRF.md
index a27fd93..84378d1 100644
--- a/WRF.md
+++ b/WRF.md
@@ -67,11 +67,19 @@ The WRF source code is available on [Github](https://github.com/wrf-model/WRF),
 
 ## Quick start with WRF
 
+### Setting up your environment
+
+You need to make the operating system aware of the software libraries required to compile and run WRF, both at compile time and at run time.
+
+This is done by loading environment modules, with `module load` on srvx1/jet/VSC4, and with `spack load` on VSC5.
+
+It is useful to save the information about a specific environment in a simple bash shell script (for instance: `modules_srvx1.sh`). Then, before compiling or running WRF, type `source modules_srvx1.sh`). See [here](WRF/config_files) for a few examples.
+
 ### Compiling
 
 If you already have a compiled version of WRF, go to the next step.
 
-Compiling WRF for an idealized simulation (LES):
+Compiling WRF for an idealized simulation (LES), assuming that you have a properly set software environment:
 
 ```sh
 ./configure
@@ -80,7 +88,7 @@ Compiling WRF for an idealized simulation (LES):
 
 The process is similar for other idealized test cases. Just change the compile targe (e.g., `em_hill2d_x`).
 
-Compiling WRF for a real-case simulation:
+Compiling WRF for a real-case simulation, assuming that you have a properly set software environment:
 
 ```sh
 ./configure
@@ -89,7 +97,7 @@ Compiling WRF for a real-case simulation:
 
 ### Running
 
-Running WRF for an idealized simulation (LES):
+Running WRF for an idealized simulation (LES), assuming that you have a properly set software environment:
 
 ```sh
 cd ./test/em_les
@@ -99,7 +107,7 @@ cd ./test/em_les
 
 For other test cases, compilation might create a `run_me_first.csh` script in the same directory as the executables. If there is one, run it only once, before any other program. It will link any necessary lookup tables needed for the simulation (land-use, parameterizations, etc.).
 
-Running WRF for a real_case simulation: 
+Running WRF for a real_case simulation, assuming that you have a properly set software environment: 
 
 ```sh
 cd test/em_real
-- 
GitLab