Wrapper repository to automate build + run + visualize WRF-Hydro v5 / NWM on R2
- I. Overview - brief description of repository
- II. Manifest - main repository structure
- III. Build - steps for building WRF-Hydro / NWM
- IV. Idaho NWM Cut-outs - Idaho cut-outs from NWM
- V. Routing Options - list of available routing configurations
- VI. Function Reference - reference list of defined function commands
- VII. Appendix - links to extended, internal documentation
- VIII. Links - links to external references
This container repository uses the NCAR NWM1 and rwrfhydro2 repositories as submodules. UNIX shell functions have been defined to automate core tasks and reduce them to a single command.
WRF_HYDRO-R2/
├── build/
│ ├── build_nwm_r2.sh
│ ├── env_nwm_r2.sh
│ └── README_BUILD.md
├── funcs/
│ └── wrf_hydro_run.sh
├── LICENSE
├── namelists/
│ ├── hydro.namelist.custom_forcing
│ ├── hydro.namelist.idealized_forcing
│ ├── hydro.namelist.lsm_ovr_chl
│ ├── namelist.hrldas.custom_forcing
│ ├── namelist.hrldas.idealized_forcing
│ ├── namelist.hrldas.lsm_ovr_chl
│ └── README_NAMELISTS.md
├── post_process/
├── pre_process/
│ ├── convert_wrf_to_wrfhydro.sh
│ ├── env_preprocess_r2.sh
│ ├── ncl_scripts/
│ │ ├── w2wh_esmf_generate_weights.ncl
│ │ └── w2wh_esmf_regrid_w_weights.ncl
│ ├── README_PREPROCESS.md
│ ├── wrf_gen_weights_wrfhydro.sh
│ ├── wrf_regrid_wrfhydro.sh
│ └── wrf_subset_wrfhydro.sh
├── README.md
├── rwrfhydro/
├── supplements/
│ └── submit.sh.template
└── wrf_hydro_nwm_public/git clone https://github.com/LEAF-BoiseState/WRF_HYDRO-R2 # clone repository
cd WRF_HYDRO-R2 # go into repository
source funcs/wrf_hydro_run.sh # load function definitions
wh_sub_mod # initialize / update submodules
wh_build # build NWM-offline executableSample output at the end of a successful build by username, auser, looks like the following
...
make[3]: Leaving directory '/home/auser/LEAF/WRF_HYDRO-R2/wrf_hydro_nwm_public/trunk/NDHMS/Land_models/NoahMP/run'
make[2]: Leaving directory '/home/auser/LEAF/WRF_HYDRO-R2/wrf_hydro_nwm_public/trunk/NDHMS/Land_models/NoahMP'
make[1]: Leaving directory '/home/auser/LEAF/WRF_HYDRO-R2/wrf_hydro_nwm_public/trunk/NDHMS'
*****************************************************************
Make was successful
*****************************************************************
The environment variables used in the compile:
HYDRO_D=0
NCEP_WCOSS=0
NETCDF=/cm/shared/apps/netcdf/intel/64/4.4.1
OLDPWD=/home/auser/LEAF/WRF_HYDRO-R2/wrf_hydro_nwm_public/trunk/NDHMS
PWD=/home/auser/LEAF/WRF_HYDRO-R2/wrf_hydro_nwm_public/trunk/NDHMS/Run
SPATIAL_SOIL=1
WRF_HYDRO=1
WRF_HYDRO_NUDGING=1
WRF_HYDRO_RAPID=0
WRFIO_NCD_LARGE_FILE_SUPPORT=1
** BUILD SUCCESSFUL!!! **
-------------------------
Executable: /home/auser/LEAF/WRF_HYDRO-R2/wrf_hydro_nwm_public/trunk/NDHMS/Run/wrf_hydro_NoahMP.exe
Log file: /home/auser/LEAF/WRF_HYDRO-R2/wrf_hydro_nwm_public/trunk/NDHMS/WH_R2_noahMP_compile.logNOTE: both the build log and executable location are listed at the end of the build output. If you received a 'BUILD UNSUCCESSFUL' message from the wh_build step (assuming the preceding steps were successful), try these steps to troubleshoot. First, assess what went wrong from looking at the build log file. Next, make any necessary changes to address the problem. Lastly, clean out the build directory and re-issue the build command.
wh_clean_nwm # remove previous NWM build
wh_build # build NWM-offline executableCurrently provided cut-outs from the National Water Model and their reference numbers can be displayed by calling
wh_list_dom NUM: Gauge ID - Description
----------------------------------------------------
1: 13139510 - Big Wood River at Hailey ID
2: 13168500 - Bruneau River near Hot Springs ID
3: 13185000 - Boise River near Twin Springs ID
4: 13186000 - SF Boise River near Featherville ID
5: 13235000 - SF Payette River at Lowman ID
6: 13237920 - MF Payette River near Crouch ID
7: 13258500 - Weiser River near Cambridge ID
8: 13316500 - Little Salmon River at Riggins IDThe routing options available and their reference numbers can be displayed by calling
wh_list_rto NUM: Routing option - Description
----------------------------------------------------
1: lsm - NoahMP LSM
2: lsm_sub - NoahMP LSM + Subsurface routing
3: lsm_ovr - NoahMP LSM + Overland surface flow routing
4: lsm_chl - NoahMP LSM + Channel routing
5: lsm_res - NoahMP LSM + Lake/reservoir routing
6: lsm_gwb - NoahMP LSM + Groundwater/baseflow model
7: lsm_ovr_chl - NoahMP LSM + Overland surface flow routing + Channel routingThe functions defined can be displayed by the command
wh_list_rtowh_dev <queue_name> <minutes> # slurm request interactive compute session
wh_sub_mod # init/update submodules
wh_build # compile the wrf-hydro/nwm executable
wh_clean_nwm # clean NWM repo build
wh_run_dir <run_id> # create wrf-hydro run (parent) directory
wh_run_dom <run_id> <domain_id> # create DOMAIN from cutout in run dir
wh_run_rto <run_id> <routing_opt> # copy exe + associated files to run dir
wh_run_frc <run_id> <input_dir> <geogrid_file> # subset + regrid forcing to FORCING
wh_run_job <run_id> <yyyy> <mm> <dd> <hh> <sim_days> # set namelist sim time and submit job
wh_list # list wrf-hydro defined functions
wh_list_dom # list wrf-hydro cutout domains
wh_list_rto # list routing/physics options- README_BUILD.md - details on build process
- README_CONVERT.md - details on data pre-processing scripts
- README_NAMELISTS.md - details on namelist options