Today.ini: Difference between revisions

73 bytes added ,  21:07, 5 August 2022
m
→‎Dealing with rogue values: deal with more typing errors
m (→‎Restart and Catch-up: unmatched brackets)
m (→‎Dealing with rogue values: deal with more typing errors)
Line 302: Line 302:
If your weather station reports a rogue value, an incorrect update to a High, Low, or Total, may get stored in this file. At end of day, it will then be stored in [[dayfile.txt]].  Cumulus developer advice is that instead of manually editing "today.ini", you should wait until the day has been stored in "dayfile.txt" and then use the editor for that log file to make the desired changes.
If your weather station reports a rogue value, an incorrect update to a High, Low, or Total, may get stored in this file. At end of day, it will then be stored in [[dayfile.txt]].  Cumulus developer advice is that instead of manually editing "today.ini", you should wait until the day has been stored in "dayfile.txt" and then use the editor for that log file to make the desired changes.


The rogue value may also affect extreme records held for this month, this year, monthly-all-time, and/or all-time.  Cumulus does provide editing functionality for most (not all) entries in the files holding thgose extreme records and you can read instructions on [[Correcting Extremes]] Wiki page. Here it is sufficient to say it is worth looking in the diagnostics, to see if you can spot when the problem occurred, because that helps you work out what may be affected:
The rogue value may also affect extreme records held for this month, this year, monthly-all-time, and/or all-time.  Cumulus does provide editing functionality for most (not all) entries in the files holding those extreme records and you can read instructions on [[Correcting Extremes]] Wiki page. Here it is sufficient to say it is worth looking in the diagnostics, to see if you can spot when the problem occurred, because that helps you work out what may be affected:
* [[File:Badge vMx.png]] [[MXdiags folder]]
* [[File:Badge vMx.png]] [[MXdiags folder]]
* [[File:Badge v1.png]] [[Diags_folder]]
* [[File:Badge v1.png]] [[Diags_folder]]
Line 309: Line 309:
=== Manual editing of "today.ini" ===
=== Manual editing of "today.ini" ===


The developer advice to wait until next day has a flaw that every process that happens in the meantime sees wrong data, and that might include sending data to several external sites and a number of extra custom processes you might have in your system.
The developer advice to wait until next day has a flaw; every process that happens in the meantime sees wrong data, and that might include sending data to several external sites, and a number of extra custom processes you might have in your system.


Therefore this Wiki page will now give some advice on how to manually edit the file:
Therefore this Wiki page will now give some advice on how to manually edit the file:
# You must stop Cumulus (please see earlier in this page for details as reason depends on flavour you are running)
# You must stop Cumulus (please see earlier in this page for details as reason depends on flavour you are running)
# Take a back-up of existing file, or rename it (if you decide it easiest to create a new file rather than edit the existing one)
# Always take a back-up of existing file, or (if you decide it is easiest to create a new file rather than edit the existing one) rename it; your corrections may cause problems, so you must be able to revert
# Any plain text file editor can be used (that includes coding editors like Geany, Notepad++, NoteTab, and many others)
# Any plain text file editor can be used (that includes coding editors like Geany, Notepad++, NoteTab, and many others)
# Be careful to ensure any change maintains existing format (integer, decimal,time, date/time, text) paying attention to any punctuation (including decimal commas or decimal points, direction type of any slashes)
# Be careful to ensure any change maintains existing format (integer, decimal,time, date/time, text) paying attention to any punctuation (including decimal commas or decimal points, direction type of any slashes)
Line 350: Line 350:


Other derivatives like "maximum hourly rain", "highest rainfall rate", or "highest 24 hour rainfall", all will have to be guessed or recalculated manually, there is no easy way to work these out as past values for the day are not logged anywhere.
Other derivatives like "maximum hourly rain", "highest rainfall rate", or "highest 24 hour rainfall", all will have to be guessed or recalculated manually, there is no easy way to work these out as past values for the day are not logged anywhere.


==Cross-references for explanations of key parameters==
==Cross-references for explanations of key parameters==
5,838

edits