Dayfile.txt: Difference between revisions

Dayfile.txt (view source)

Revision as of 05:08, 10 June 2021

1,614 bytes added , 05:08, 10 June 2021

m

Resequence

Sfws

5,838

edits

@@ Line 5: / Line 5: @@
 Cumulus maintains a daily log file that holds the highs and lows of each day, as well as a few other nuggets of information. In all flavours of Cumulus, this file is only updated (with exclusive lock) during the end of meteorological day process. In that process it is also read, if the generation of NOAA reports has been requested.
 Both Cumulus 1 and MX have ways to [[Amending dayfile|edit '''dayfile.txt''']] while Cumulus is running. Cumulus 2 does not even allow you to view this log file.
+==Creating dayfile.txt==
+This file is not included in any release distribution of Cumulus.
+Cumulus software creates the file, if the file does not exist, when the software does its first end of day action.
+Whenever Cumulus does an end of day action (either in normal processing or in catch-up on a restart of Cumulus while processing archive data), Cumulus will create a new line in '''dayfile.txt''' from what it has stored in [[Today.ini#When_Cumulus_is_running|today.ini]] and at that link you can read how the parameters in '''today.ini''' map across to fields in '''dayfile.txt'''.
+If you import historic data from before you started using Cumulus, and have this in [[Standard log files]], then the daily summary for imported data can be converted into dayfile.txt line format (and a dayfile.txt file created/updated) using any of the approaches described on [[Calculate_Missing_Values|calculate missing values]] page.
 ==[[File:Badge vMx.png]] WARNING==
@@ Line 106: / Line 117: @@
 === Variation by Cumulus version ===
+The number of fields in '''dayfile.txt''' has grown as time has gone by; simply because Cumulus's functionality has been extended both to cover more sensors and to calculate more derivatives. The only way that Cumulus can retain a daily summary for past days is by using this file.
+'''For your installed build please see ''dayfileheader.txt'' (stored within the folder that contains your Cumulus executable), as that will list which fields your Cumulus installation uses.'''
+If you have been using Cumulus for a while, you may wonder which of your log file lines might be shorter, so the table below shows fields grouped by the Cumulus version when those fields were added.
 For the original Cumulus software, each line of this file can contain anything from 15 to 45 fields, and having some lines shorter than others does not matter.
-For Cumulus MX, some early releases supported only 45 fields, one particular release supported 54 fields, but all recent releases expect exactly 52 fields, and if you have a line with fewer fields then it will have 52 fields when you edit it, and when you save that line.
+For Cumulus MX, several of the earliest releases supported only the same 45 fields as used by 1.9.4, a few early releases had 50 fields, just one particular release supported 54 fields (in error), then several releases supported exactly 52 fields, but from release 3.12.0 MX expects exactly 53 fields.
-The dayfile.txt has grown simply because Cumulus's functionality has been extended as time has gone by.  To help you, the table below shows fields grouped by the Cumulus version when those fields were added.
+If you have any lines with 15 to 52 fields then MX can still read that line, but if you edit that line using the editor in MX, it will show all fields when you edit it, and when you save that line.
-'''For your installed build please see ''dayfileheader.txt'' (stored within the folder that contains your Cumulus executable), as that will list which fields are available for you.'''
+Please note that if you use MX, then there is a utility program that can insert missing fields for you. Please see [[Calculate_Missing_Values#CreateMissing.exe|here]].
 == Information shown in the table ==