FAQ: Difference between revisions

519 bytes added ,  08:37, 6 March 2015
m
m (→‎How do I upgrade to a new release?: add that you can skip in-between versions)
m (→‎Where does Cumulus get its this month and this year rainfall totals from?: update explanation of 'year' for 'year-to-date')
Line 194: Line 194:


* 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 values 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 as '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. To these are added today's total each time new data is read, to give the current totals for this month and this year.
* 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.
**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]].   
**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 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.
*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.
**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.
* 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 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.


5,838

edits