Dayfile.txt: Difference between revisions

1,208 bytes added ,  20:16, 12 February 2021
m
Line 84: Line 84:
= List of fields in dayfile.txt =
= List of fields in dayfile.txt =


== Variation by Cumulus version ==
==The number of fields in a line==


The dayfile.txt has grown as Cumulus's functionality has been extended, the table below shows fields grouped by the Cumulus version when those fields were added.  
'''dayfile.txt''' is different to most log files maintained by Cumulus as a single file can contain lines created over a long period of time. For some people, the file was first created  by Cumulus 1 (at various versions over time), and then moved to MX.  Such files may have different numbers of fields depending on when each line was either created or last updated. Cumulus does not in normal operation modify earlier lines, but both Cumulus 1 and MX provide editors where it is possible to modify any line.


If you have been using Cumulus for a while, then some lines will be shorter than others, the number of fields per line growing when a new release adds new fields, Cumulus does not in normal operation modify earlier lines, but both Cumulus 1 and MX provide editors where it is possible to modify any line.
There is advice on editing the file on [[Calculate_Missing_Values#Missing_fields_.28or_missing_lines.29_in_dayfile.txt|Calculate Missing Values page]], using the Cumulus in-built editor. Should you want  to edit the file outside Cumulus, a "Comma Separated Value" editor has advantage of being able to maintain the differing existing lengths for each line.  One example of such a tool in the Microsoft Windows environment is [https://csved.sjfrancke.nl/ freeware CSV editor software by Sam Francke for Windows].  If you do edit the file (within Cumulus or outside), there are [[Calculate_Missing_Values#Rules_when_editing_daily_summary_log|Rules to follow]].


There is information earlier in this article about how you might be able to recalculate values to put in for fields that did not exist when any particular line was created.
=== Variation by Cumulus version ===
 
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.
 
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.


'''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.'''
'''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.'''
5,838

edits