5,838
edits
Dayfile.txt: Difference between revisions
m
Resequence
m (→List of Fields: update for release 3.12.0) |
m (Resequence) |
||
|
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==
=== 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
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,
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.
▲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.
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]].
▲'''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.'''
== Information shown in the table ==
| |||