FAQ: Difference between revisions

124 bytes added ,  19:20, 10 April 2014
m
→‎Where does Cumulus get its this month and this year rainfall totals from?: Minor correction to description in 2nd bullet about adding to today's total. Also separation of final bullet into 2 points
m (→‎How do I upload my own pages or files once a day?: correcting format of cross-references)
m (→‎Where does Cumulus get its this month and this year rainfall totals from?: Minor correction to description in 2nd bullet about adding to today's total. Also separation of final bullet into 2 points)
Line 155: Line 155:
== Where does Cumulus get its this month and this year rainfall totals from?  ==
== Where does Cumulus get its this month and this year rainfall totals from?  ==
* 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]].
* Each time Cumulus reads records from the weather station it applies any change to the 'total rain count' against today's total in its memory.
 
* 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. To these are added today's total as currently in memory. Important, for the <#ryear> web tag Cumulus reads the dayfile 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 current year, that is also added into this year's total. There is no corresponding setting for 'this month'.
If you have set a 'year to date' value for the current year, that is also added into this year's total. There is no corresponding setting for 'this month'.
* The today's total so far at each reading time 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.


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.
5,838

edits