Addressing review comments

components/mosart/docs/dev-guide/index.md

@@ -1,5 +1,5 @@
 # MOSART Developer's Guide
 
-This guide provides MOSART data structures and how to develop new code for MOSART. 
+This guide provides MOSART data structures and how to develop new code for MOSART.
 
 Coming soon...

components/mosart/docs/index.md

@@ -1,6 +1,6 @@
 #Model for Scale Adaptive River Transport (MOSART)
 
-MOSART is the river model of E3SM. It routes the runoff genrated by ELM and provides freshwater input to the ocean model. 
+MOSART is the river model of E3SM. It routes the runoff genrated by ELM and provides freshwater input to the ocean model.
 
 * The [MOSART User's Guide](user-guide/index.md) explains how to control MOSART when its running within E3SM
 * The [MOSART Developer's Guide](dev-guide/index.md) explains MOSART data structures and how to develop new code.

components/mosart/docs/tech-guide/index.md

@@ -4,7 +4,7 @@ This guide provides scientific and technical details about MOSART.
 
 ## Physics
 
-MOSART is a one-dimension river transport model that is designed for river routing at local, regional, and global scales ([Li et al., 2013](https://doi.org/10.1175/JHM-D-12-015.1)). Its primary function is to supply freshwater inputs to ocean models within coupled Earth System Models. 
+MOSART is a one-dimension river transport model that is designed for river routing at local, regional, and global scales ([Li et al., 2013](https://doi.org/10.1175/JHM-D-12-015.1)). Its primary function is to supply freshwater inputs to ocean models within coupled Earth System Models.
 
 MOSART divides each spatial unit, such as a latitude/longitude grid or a sub-basin, into three hydrologic categories: hillslopes, tributaries, and a main channel (see figure below). The hillslopes receive runoff and send into tributaries, which then converge into a single main channel. This main channel connects adjacent upstream and downstream units through the river network. MOSART simplifies the multiple tributaries within a spatial unit into a single hypothetical sub-network channel, which has a transport capacity equivalent to all combined tributaries.
 
@@ -44,4 +44,4 @@ MOSART divides each spatial unit, such as a latitude/longitude grid or a sub-bas
 
 ### Parameters required by additional MOSART features
 
-Coming soon.
+Coming soon.

components/mosart/docs/user-guide/index.md

@@ -10,15 +10,15 @@ MOSART in the water cycle campaigns of E3SM v1, v2, and v3 was.
 
 ### Scientifically supported compsets
 
-The mosart-only compsets are supported for multiple runoff forcing datasets that covers different domain and time:
+The mosart-only compsets are supported for multiple runoff forcing datasets that covers different domains and time periods:
 
 1. `RMOSQIAN`: A 57-year (1948-2004, no leap year) global Qian runoff forcings. The native resolutions are 192*288 at daily time scale. The path to the stream file is `$input_data_dir/lnd/dlnd7/hcru_hcru/QIAN.daily.1948-2004.nc`
 2. `RMOSGPCC`: A one-year (1979) global GPCC runoff forcing. The native resoultions are 192*288 at daily time scale. The path to the stream file is `$input_data_dir/lnd/dlnd7/hcru_hcru/GPCC.daily.nc`
 3. `RMOSNLDAS`: A one-year (1975) CLM runoff forcing for [NLDAS](https://ldas.gsfc.nasa.gov/nldas) domain (North America between 25N and 53N) and spatial resolution (1/8th degree). The time scale is 3-hourly. The path to the stream file is `$input_data_dir/lnd/dlnd7/NLDAS/mosart_nldas_hist_1975.clm2.h1.1975-01-01-00000.nc`.
 
 ### Supported grid
 
-The `r05_r05` and `NLDAS_NLDAS` are the supported grid resolutions for performing offline MOSART simulations.
+The `r05_r05`, `NLDAS_NLDAS`, and `MOS_USRDAT` are the supported grid resolutions for performing offline MOSART simulations.
 
 ### User-defined runoff forcing
 
@@ -113,14 +113,20 @@ There are some options only made available for specific features. They can be de
 
 - `damconstructionflag`: `0` - dam always exist; `1` - dam construction year is considered.
 
-### Flood inundation
+- `externaldemandflag`: `0` - no external water demand for the WM scheme; `1` - external water demand files are required.
 
-- `opt_eleprof`: `1` - elevation profiles defined in the MOSART parameter file; `2` - hypothetical elevation profile.
+  - Note if `externaldemandflag` is set to `1`, paths to monthly water demand files are requried in the `usr_nl_mosart` file through `demandpath = '/path/to/demand/files/`.
 
-### Heat transport
+### Flood inundation
 
-- to be added
+- `opt_eleprof`: `1` - use actural elevation profiles derived from DEM; `2` - use hypothetical elevation profile.
+
+  - Note if `opt_eleprof` is set to `1`, the elevation profile data must be included in the MOSART parameter file.
 
 ### Sediment transport
 
+- If sediment feature is activated, D50 data must be included in the MOSART parameter file. In addition, `rof_sed = .true.` has to be defined in `./user_nl_cpl` to allow sediment flux passing into the river model through the coupler.
+
+### Heat transport
+
 - to be added