FAQ: Difference between revisions

514 bytes added ,  15 October 2018
m
== Where does Cumulus get its this month and this year rainfall totals from? ==
 
* The rainfall totals (for this month, year, and season), 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 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 shown on the ''This period'', ''This month'', and ''This year'' screens within the '''View''' menu in Cumulus 1 are generated by adding up the daily rainfall totals found in [[dayfile.txt]] for the selected period. So Using default settings via '''View''' menu in Cumulus 1, ''This month'' screen for this month excluding today, ''This year'' screen for this calendar year (this does always start on 1 January, unless you only started using Cumulus after that) excluding today. ''Note any rainfall for the current (meteorological) day is excluded as the latest dayfile.txt row is for yesterday.'' Totals can be shown for any past period, by selecting the required dates, the figures are recalculated when you press the ''Update display'' button and will include all days available in dayfile.txt for the chosen period. ''Important note: The view menu 'This year' screen always calculates the total for a selected calendar year starting in January.''
* The today's total so far at each reading time is also added to the 'recent tag' array allowing total values for the day-so-far at one minute intervals for up to a week ago to be added as web tags to a web template.
 
* The rainfall totals, are initialised when Cumulus is (re-)started by adding up the corresponding daily totals in dayfile.txt and storing those sums in memory. Two of the totals can be seen using default settings on '''View''' menu, ''This month'' screen for this month, ''This year'' screen for this calendar year, but the third total for the rain season (you can change starting month) is seen on the ''main'' Cumulus screen.
* 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 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 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.
**Today's rain is shown on the front screen in Cumulus 1, labelled ''Today''.
* The*Today's rain is added to the figures that(as Cumulusdescribed usesabove) derived from dayfile.txt for displayingwhat the front screen in Cumulus 1, labels '''This month''', and ''This year'' on(this last figure is the Cumulusseasonal ''maintotal, screen''you can choose for it to start on 1 January or any other month). Thus these figures are updated each time Cumulus receives a rain reading from the station, (they all include today-so-far), and these figures will not be displayed if Cumulus is unable to read rain information from your station.
** The today's total so far at each reading time is also added to the 'recent tag' array allowing total values for the day-so-far at one minute intervals for up to a week ago to be added as web tags to a web template.
 
* For the web tags, Cumulus takes its stored sums and adds today's latest total each time, to give the current totals for this month and this rain season (year so far) when processing 'thismonthT.htm' and 'thisyearT.htm' web templates.
**Important, for the <#ryear> web tag, and for the 'This year' display on the ''main'' Cumulus screen, the processing reads the ''dayfile.txt'' 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]] (its default is January).
5,838

edits