From f789f981be677d0e8dd4dac25fafbf9ec90bbd8c Mon Sep 17 00:00:00 2001 From: Sanchit Minocha Date: Mon, 9 Sep 2024 00:04:38 -0700 Subject: [PATCH] Updated docs to describe the working of 0 latency --- docs/Configuration/rat_config.md | 4 ++++ docs/Development/PatchNotes.md | 8 ++++---- docs/Development/RecentAdjustments.md | 4 ++-- docs/Model/ComputationalModel.md | 2 +- 4 files changed, 11 insertions(+), 7 deletions(-) diff --git a/docs/Configuration/rat_config.md b/docs/Configuration/rat_config.md index 2d0695bd..c57b370f 100644 --- a/docs/Configuration/rat_config.md +++ b/docs/Configuration/rat_config.md @@ -238,6 +238,10 @@ RAT config file has 12 major sections that defines several parameters which are end: 2022-08-31 ``` + !!! note + 1. Starting from [v3.0.14](../../Development/PatchNotes/#v3014), the end date can now be set to a date on or before the current day. + 2. For RAT runs that overlap with the period from three days prior to the current day up to the current day, meteorological data is sourced as nowcasts—precipitation data from the GEFS server and temperature and wind data from the GFS server. + *
*`vic_init_state_date`* :
Optional parameter diff --git a/docs/Development/PatchNotes.md b/docs/Development/PatchNotes.md index cba02325..aae1567b 100644 --- a/docs/Development/PatchNotes.md +++ b/docs/Development/PatchNotes.md @@ -3,10 +3,10 @@ ### v3.0.14 In this release, we have: -1. Enhanced Low-Latency Functionality: RAT can now run in operational mode with significantly reduced latency as low as 0. -2. Updated Forecasting Plugin: The forecasting plugin has been upgraded to allow forecast generation for multiple past dates. -3. Updated IMERG Precipitation Web Links: The web links for downloading historical IMERG data (prior to 2024) have been updated to match those for current data. This change reflects the revision of the IMERG product version for historical data to V07B, which is now the same as the version for recent IMERG data. These updates were implemented on June 1, 2024, on the IMERG web servers. -4. Updated RAT documentation: to reflect the changes in the forecasting plugin and the possibility of using low latency in operational mode. +1. **Enhanced Low-Latency Functionality:** RAT can now run in operational mode with significantly reduced latency as low as 0. +2. **Updated Forecasting Plugin:** The forecasting plugin has been upgraded to allow forecast generation for multiple past dates. +3. **Updated IMERG Precipitation Web Links:** The web links for downloading historical IMERG data (prior to 2024) have been updated to match those for current data. This change reflects the revision of the IMERG product version for historical data to V07B, which is now the same as the version for recent IMERG data. These updates were implemented on June 1, 2024, on the IMERG web servers. +4. **Updated RAT documentation:** To reflect the changes in the forecasting plugin and the possibility of using low latency in operational mode. !!!note 1. Previously, a latency of 3 or more days was recommended due to delays in retrieving meteorological data from servers. However, RAT can now operate with latencies of less than 3 days, including real-time data (0-day latency). This is a major improvement over earlier versions, enabling users to generate data for the current day and produce forecasts up to 15 days ahead from the current day. diff --git a/docs/Development/RecentAdjustments.md b/docs/Development/RecentAdjustments.md index 854362a8..4dd4c1cf 100644 --- a/docs/Development/RecentAdjustments.md +++ b/docs/Development/RecentAdjustments.md @@ -1,7 +1,7 @@ # Recent Adjustments -### September8, 2024 -From June 1 in 2024,all the historical IMERG data has been revised to Version 07B along with the current IMERG data being generated daily. In the last patch we updated the link to download IMERG for recent and current data while the link for the past historic data was not updated to V07B. This was raising the 'Connection Reset' error if one tries to run RAT from say 2020 to 2024. The problem has been resolved in the [developer version](../../Development/DeveloperVersion/) of RAT. It has been released in the version of RAT [v3.0.14](../../Development/PatchNotes/#v3014). To [update](https://conda.io/projects/conda/en/latest/commands/update.html) RAT, please use `conda update rat` in your RAT environment. +### September 8, 2024 +From June 1 in 2024, all the historical IMERG data has been revised to Version 07B along with the current IMERG data being generated daily. In the last patch we updated the link to download IMERG for recent and current data while the link for the past historic data was not updated to V07B. This was raising the 'Connection Reset' error if one tries to run RAT from say 2020 to 2024. The problem has been resolved in the [developer version](../../Development/DeveloperVersion/) of RAT. It has been released in the version of RAT [v3.0.14](../../Development/PatchNotes/#v3014). To [update](https://conda.io/projects/conda/en/latest/commands/update.html) RAT, please use `conda update rat` in your RAT environment. Due to the non-availability of IMERG data for April and May 2024 on the IMERG web server, users may encounter issues when running RAT for time periods that include these months. This issue is on the IMERG data provider's side, and we are hopeful it will be resolved soon. diff --git a/docs/Model/ComputationalModel.md b/docs/Model/ComputationalModel.md index b6a4d295..d779a715 100644 --- a/docs/Model/ComputationalModel.md +++ b/docs/Model/ComputationalModel.md @@ -22,7 +22,7 @@ The workflow diagram shown below summarizes the comprehensive process employed b ## Step-1 Downloading and Pre-processing of meteorological data
- Task: Downloading of real-time raw meteorlogical data from different servers (precipitation from IMERG, and temperature and wind data from NOAA). The downloaded data is then pre-processed (scaled, aligned and clipped to basin - shown in the figure below) for further use.

+ Task: Downloading of real-time raw meteorlogical data from different servers (precipitation from IMERG or GEFS, and temperature and wind data from NOAA or GFS). The downloaded data is then pre-processed (scaled, aligned and clipped to basin - shown in the figure below) for further use.

Input Files: No input file is required.

Output Files: 1. Global data for daily precipitation in geotif format. (`data_dir`>raw>precipitation)
2. Global data for minimum and maximum temperature, and wind speed at daily frequency with a NetCDF file for each year and each variable. (`data_dir`>raw>tmax/tmin/uwnd/vwnd)