FAQ: Difference between revisions

158 bytes added ,  08:12, 3 March 2014
Line 150: Line 150:
* The rainfall totals shown on the ''This period'', ''This month'', and ''This year'' screens within the '''View''' menu are generated by adding up the daily rainfall totals found in [[dayfile.txt]] for the selected period. So for the default dates on those three screens, any rainfall for the current (meteorological) day is excluded as the latest dayfile.txt row is for yesterday. Totals are recalculated when you press the ''Update display'' button. Important note: The view menu 'This year' screen always calculates the total for a selected calendar year starting in January.
* The rainfall totals shown on the ''This period'', ''This month'', and ''This year'' screens within the '''View''' menu are generated by adding up the daily rainfall totals found in [[dayfile.txt]] for the selected period. So for the default dates on those three screens, any rainfall for the current (meteorological) day is excluded as the latest dayfile.txt row is for yesterday. Totals are recalculated when you press the ''Update display'' button. Important note: The view menu 'This year' screen always calculates the total for a selected calendar year starting in January.
* The rainfall totals that Cumulus uses when processing 'thismonthT.htm' and 'thisyearT.htm' web templates are initialised when Cumulus is (re-)started by adding up the corresponding daily totals in dayfile.txt and storing those sums in memory. Each time Cumulus processes the 2 templates it adds today's total so far to the values in memory. The today's total so far is also added to the 'recent tag' array allowing values for up to a week ago to be added as web tags to a web template. Important, for the <#ryear> web tag Cumulus calculates the total for the rainfall season starting with the month set on the station settings screen and stored as the value for attribute ''RainSeasonStart'' in [[Cumulus.ini#Section:_Station]].
* The rainfall totals that Cumulus uses when processing 'thismonthT.htm' and 'thisyearT.htm' web templates are initialised when Cumulus is (re-)started by adding up the corresponding daily totals in dayfile.txt and storing those sums in memory. Each time Cumulus processes the 2 templates it adds today's total so far to the values in memory. The today's total so far is also added to the 'recent tag' array allowing values for up to a week ago to be added as web tags to a web template. Important, for the <#ryear> web tag Cumulus calculates the total for the rainfall season starting with the month set on the station settings screen and stored as the value for attribute ''RainSeasonStart'' in [[Cumulus.ini#Section:_Station]].
If you have set a 'year to date' value for the currrent year, that is also added into this year's total. There is no corresponding setting for 'this month'.


The built-in dayfile.txt editor is used if it is necessary to amend the daily totals (to correct any monthly, rain season, or calendar year, totals); the built-in all-time (or monthly records) editor(s) in Cumulus is used if it is necessary to regenerate the extreme records from dayfile.txt; see [[#My_station_invented_some_rain_that_didn.27t_really_occur.2C_and_I_want_to_set_it_to_zero_.28or_some_other_figure.29 |FAQ about correcting incorrect rainfall displays]].  Note that you need to stop and then restart Cumulus to update the initial values stored in memory and get any corrections to rogue values reflected on the main Cumulus screen and in web tags.
The built-in dayfile.txt editor is used if it is necessary to amend the daily totals (to correct any monthly, rain season, or calendar year, totals); the built-in all-time (or monthly records) editor(s) in Cumulus is used if it is necessary to regenerate the extreme records from dayfile.txt; see [[#My_station_invented_some_rain_that_didn.27t_really_occur.2C_and_I_want_to_set_it_to_zero_.28or_some_other_figure.29 |FAQ about correcting incorrect rainfall displays]].  Note that you need to stop and then restart Cumulus to update the initial values stored in memory and get any corrections to rogue values reflected on the main Cumulus screen and in web tags.