River routing for GEOSldas

[zyj8881357]

Pull Request Overview

This pull request initiates the implementation of a river routing process within GEOS, starting with an offline model.

Current Implementation: Only the offline version of the river routing model is introduced at this stage.

All model code is located in the directory:
GEOSgcm_GridComp/GEOSagcm_GridComp/GEOSphysics_GridComp/GEOSsurface_GridComp/GEOSland_GridComp/GEOSroute_GridComp

The model reads runoff data from the Catchment model outputs (variables RUNOFF and BASEFLOW, with type tavg24_2d_lnd_Nx) and generates daily river-related outputs for each catchment area.

For detailed information on configuring and running the offline model, please refer to readme.txt in the above directory.

Next Steps:
This is an initial implementation, and many aspects require further discussion with relevant members to plan the next steps.

Additionally, work is ongoing to develop a pre-processing package for creating input data for the routing model.

[zyj8881357]

New Updates:

1. The river routing model (excluding the reservoir and lake components) is now integrated into GEOSldas.
2. Currently, the model supports EASEv2 M09 and M36 grids. To enable the river routing feature, set RUN_ROUTE to 1 in the exeinp file.
3. Output Details
    River Discharge [m3 s-1]: Daily river discharge data is saved in the "river" directory (created automatically) within the experiment folder.
    The output is in vector format (*.txt files), where each file contains 291,284 values. These values correspond to catchments indexed from 1 to 291,284.
    To convert the vector data into spatial maps, use the 1-minute resolution catchment distribution map available in the CatchIndex variable of the SRTM_PfafData.nc file at:
    /discover/nobackup/projects/gmao/bcs_shared/make_bcs_inputs/land/topo/v1/SRTM-TopoData/SRTM_PfafData.nc
4. Restart Files: Restart files are generated monthly in the restart folder and can be read automatically as it exists. If there is no restart file, zero water storage will be used at the start.
5. The source code of offline routing model has been moved to the "offline" directory under GEOSgcm_GridComp/GEOSagcm_GridComp/GEOSphysics_GridComp/GEOSsurface_GridComp/GEOSland_GridComp/GEOSroute_GridComp/


For questions or further assistance, please contact Yujin Zeng at:
Email: [email protected]