FAQ: Difference between revisions

512 bytes added ,  08:01, 8 April 2015
m
m (→‎Cumulus takes a long time to download the data from my Davis station at start up: Sorry, used American spelling of 'Synchronise' with Z on previous edit (Forum editor marks British spelling as error))
Line 219: Line 219:
== 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?  ==


* 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.  
* 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 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 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 that Cumulus uses when processing 'thismonthT.htm' and 'thisyearT.htm' web templates, and for displaying in 'This month' and 'This year' on the Cumulus main screen, are initialised when Cumulus is (re-)started by adding up the corresponding daily totals in dayfile.txt and storing those sums in memory. For the web tags, Cumulus takes these stored sums and adds today's latest total each time, to give the current totals for this month and this year.
* 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 and '''View''' menu, ''This year'' screen for this calendar year, but the third total for the rain season (you can change starting month) is used for the <#ryear> web tag only.
**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]].   
* 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.
* The rain figures that Cumulus uses for displaying in 'This month' and 'This year' on the Cumulus ''main screen'' are updated each time Cumulus receives a rain reading from the station, so will not be displayed if Cumulus is unable to read rain information from your station.
* 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 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]] (its default is January).   
**If you have set a 'year to date' value and Cumulus is being re-started when the year specified beside that figure matches the current year, your year-to-date amount is also added into this year's total. This should normally only be relevant in your first rain season of operating Cumulus, but could be used if in any season you needed to add an extra amount because for some reason you had a gap in your recording period.
**If you have set a 'year to date' value and Cumulus is being re-started when the year specified beside that figure matches the current year, your year-to-date amount is also added into this year's total. This should normally only be relevant in your first rain season of operating Cumulus, but could be used if in any season you needed to add an extra amount because for some reason you had a gap in your recording period.
**There is no corresponding setting for calculating the total for the first 'this month' of Cumulus operation.
**There is no corresponding setting for calculating the total for the first 'this month' of Cumulus operation.
*Note that you need to stop and then restart Cumulus to update these initial values that are stored in memory and get any corrections you made to rogue values in the daily summary log (or year-to-date) reflected on the main Cumulus screen and in web tags.
*Note that you need to stop and then restart Cumulus to update these initial values that are stored in memory and get any corrections you made to rogue values in the daily summary log (or year-to-date) reflected on the main Cumulus screen and in web tags.
* 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.


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

edits