The WRF-Hydro GIS Pre-processor provides various scripts and tools for building the geospatial input files for running a WRF-Hydro simulation.
The scripts for the WRF-Hydro GIS Pre-processor rely on several python modules a user will need to install such as numpy, gdal, and Whitebox-Tools. It is highly recommended to use a python distribution such as Miniconda (https://docs.conda.io/en/latest/miniconda.html). An example environment is given below, using the conda package manager to install necessary python modules. The essential packages and versions used in development of this repository are listed below (Windows 64-bit and Python 3.6.10):
| Package | Version |
|---|---|
| gdal | 3.6.3 |
| netcdf4 | 1.6.3 |
| numpy | 1.24.2 |
| packaging | 23.0 |
| pyproj | 3.4.1 |
| python | 3.10.9 |
| whitebox | 2.3.5 |
| shapely | 2.0.1 |
If you are using Anaconda, creating a new, clean 'wrfh_gis_env' environment with these needed packages can be done easily and simply one of several ways:
-
In your conda shell, add one necessary channel (conda-forge) and then download the component libraries from the Anaconda cloud:
conda config --add channels conda-forgeconda create -n wrfh_gis_env -c conda-forge python=3.10 gdal netCDF4 numpy pyproj whitebox=2.3.5 packaging shapely
-
To activate this new environment, type the following at the conda prompt
activate wrfh_gis_env
The scripts make use of a function script '\wrfhydro_gis\wrfhydro_functions.py' to pass all functions and selected global parameters parameters to the primary script:
In turn, these scripts rely on a set of functions in wrfhydro_functions.py.
Use -h when calling any of the scripts on the command-line, for help information. Provide the required and any optional parameters as arguments. The following steps will excecute a process to generate a minimal set of routing grids for the desired domain. This example assumes use of a Bash shell.
python Build_Routing_Stack.py -i geo_em.d01.nc -d NED_30m_Croton.tif -R 4 -t 20 -o croton_test.zip
The National Center for Atmospheric Research (NCAR) GitHub project code is provided on an "as is" basis and the user assumes responsibility for its use. NCAR has relinquished control of the information and no longer has responsibility to protect the integrity , confidentiality, or availability of the information. Any reference to specific commercial products, processes, or services by service mark, trademark, manufacturer, or otherwise, does not constitute or imply their endorsement, recommendation or favoring by NCAR. The NCAR seal and logo shall not be used in any manner to imply endorsement of any commercial product or activity by NCAR or the National Science Foundation (NSF).