Today.ini: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
726 bytes added ,  10:17, 15 March 2020
m
(→‎Introduction: Rewrite to cover MX as well as Cumulus 1)
Line 33: Line 33:
***consecutive wet/dry days ("ConsecutiveRainDays=" and "ConsecutiveDryDays=") - remember these counts are to last roll-over, they exclude today
***consecutive wet/dry days ("ConsecutiveRainDays=" and "ConsecutiveDryDays=") - remember these counts are to last roll-over, they exclude today
**If you do edit any parameter values remember to ensure the replacement is in exactly same format as before (whether integers, real numbers or a particular format for time-stamps)
**If you do edit any parameter values remember to ensure the replacement is in exactly same format as before (whether integers, real numbers or a particular format for time-stamps)
**This edit does not affect any derived rainfall values (such as totals for the month or year that are displayed (and output via web-tags)), unless you subsequently close and restart Cumulus the same day to force recalculation of the longer period totals, and to ensure that dayfile.txt is updated correctly at next roll-over.
*This edit does not affect any derived rainfall values (such as totals for the month or year that are displayed (and output via web-tags)), unless you subsequently close and restart Cumulus the same day to force recalculation of the longer period totals.
**Although rainfall since midnight is stored in the last field of the Cumulus [[Monthly_log_files |log file]] for the current month, manually editing there will not help as Cumulus does not read it from there. If you want to correct it there because you have processes that read this file, then remember you can only safely edit (using a specialist CSV editor,  a good text editor, or a programmer's editor like 'Notepad++) that file with Cumulus stopped, as Cumulus demands full access to this file for periodic updating.
* You don't need to restart Cumulus after a change to today's rain to ensure that [[dayfile.txt]] has correct new line added at next roll-over.
* This edit does not change any lines already in the [[Monthly_log_files |log file]] for the current month, so any process you have that reads those will read some wrong values and this can distort for example graphs attempting to portray rainfall within a day. Although ''rainfall since midnight'' is stored in the last field of the Cumulus [[Monthly_log_files |log file]] for the current month, manually editing there will not help as Cumulus does not read it from there. Cumulus works out rainfall since midnight by looking at the entry at (or first just after) midnight, and that past line has not been updated. If you want to correct rainfall since midnight there because you have processes that read this file, then remember you can only safely edit (using a specialist CSV editor,  a good text editor, or a programmer's editor like 'Notepad++) that file with Cumulus stopped, as Cumulus demands full locked access to this file for periodic updating.  Editing this file is difficult, because you have to work backwards through time working out what needs to be subtracted from the rain counter value from what increment the old value had from the one immediately earlier.


=== Editing today.ini or yesterday.ini outside Cumulus ===  
=== Editing today.ini or yesterday.ini outside Cumulus ===  
5,838

edits

Navigation menu