Today.ini: Difference between revisions

1,458 bytes added ,  22 June 2017
m (→‎Example today.ini file: cross-ref to FAQ added, reference to ISO format added)
*If you do decide to edit 'today.ini' outside Cumulus, you must close Cumulus down first!
*Don't try to edit 'yesterday.ini' within a few minutes before or after Cumulus performs a rollover (either at rollover time or on restarting if it was not running at rollover time).
=== Editing rainfall in today.ini within Cumulus ===
This applied to Cumulus 1 and Cumulus MX. Both contain an editor for 'today's rain'.
*You may wish to [[FAQ#My_station_invented_some_rain_that_didn.27t_really_occur.2C_and_I_want_to_set_it_to_zero_.28or_some_other_figure.29 | edit the rain data]] if there has been a quirk in your weather station sensor for rain (or in figure reporting) during the day and the figure is abnormally inflated (or indeed under-reported). The stored rainfall today start ''count'' value in today.ini may be edited within Cumulus via ''Today's rain'' screen on the '''Edit''' menu. This edit does not affect any false derived rainfall values for the month or year, unless you subsequently close and restart Cumulus the same day to force recalculation of the longer period totals.
*The stored rainfall today start ''count'' value in today.ini may be edited via ''Today's rain'' screen on the '''Edit''' menu.
**This edit purely changes the ''Start='' line within the '[rain]' section, i.e. changes the ''Total rainfall counter (content depends on weather station type, might be rainfall total so far this year; it is not intended to be useful in itself, it may vary for no apparent reason)'' value that is stored within today.ini.
**Consequently, using this feature creates a sudden increase or decrease in the 'Total rainfall counter (content depends on weather station type, might be rainfall total so far this year)' figure stored the next time Cumulus updates its [[Monthly_log_files |log file]] for the current month.
**You still need to manually edit (using an external text editor) the other parameters within that [Rain] section to correct the other rain statistics held in 'today.ini':
***last tip time-stamp
***hourly high amount and time-stamp
***consecutive wet/dry days
**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.
**Also rainfall since midnight is stored in the Cumulus [[Monthly_log_files |log file]] for the current month, 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.
 
=== Editing today.ini or yesterday.ini outside Cumulus ===
5,838

edits