Dayfile.txt: Difference between revisions

665 bytes added ,  10:51, 5 January 2013
m
Clarification of storage formats, introduction of cross references to terminology
m (→‎Format of the file: gust bearing)
m (Clarification of storage formats, introduction of cross references to terminology)
Line 1: Line 1:
Cumulus maintains a daily file of the highs and lows of each day, as well as a few other nuggets of information.  The data contained in the file are used to build the graphs.
Cumulus maintains a daily file of the highs and lows of each day, as well as a few other nuggets of information.  The data contained in the file are used to build the graphs.
==Editing in Cumulus==
The last command in '''Edit''' menu is ''dayfile.txt''.  This is a text editor, and works best when at full screen. Click the ''Help'' button for detailed instructions.
==Manipulation outside Cumulus==
The file is called <tt>dayfile.txt</tt> which can be viewed in a text editor or imported into various database systems or spreadsheets to manipulate as you wish.  Just remember that Cumulus updates it as part of the rollover process, so it is not a good idea to work on it when Cumulus has just been restarted or around the midnight/9am/10am local rollover time.


The file is called <tt>dayfile.txt</tt> which can be viewed in a text editor or imported into various database systems or spreadsheets to manipulate as you wish.
Tip -- take a copy of the file before you work on it outside Cumulus (perhaps call it dayfile.csv).


 
'''Important''': The (meteorological) date format uses two digits for the year. Edit this file using an editor that treats all fields as text (a text editor or a spreadsheet program that can be instructed ''not'' to recognise special field types).  -  ''Do not edit this file using Excel'' or any similar tool that recognizes dates, as it is likely to change the dates to have four figure years, and then Cumulus will no longer be able to use the file. Times are in format hh:mm, and most value fields are in format x.y using your system decimal notation. Also, make sure that any editing does not create any blank lines in the file, all must start with date and include some of the parameters listed in correct sequence (i.e. nulls ',,' are not allowed in the line, but since new builds add to number of fields, Cumulus can accept lines without the more recent fields at the end).
Tip -- take a copy of the file to work on it elsewhere.
 
'''Important''': The date format uses two digits for the year. Edit this file using an editor that treats all fields as text (a text editor or a spreadsheet program that can be instructed ''not'' to recognise special field types).  -  ''Do not edit this file using Excel'' or any similar tool that recognizes dates, as it is likely to change the dates to have four figure years, and then Cumulus will no longer be able to use the file. Also, make sure that editing does not create any blank lines in file, all must start with date and include some of the parameters listed in correct sequence (i.e. nulls ',,' are not allowed in the line, but since new builds add to number of fields, Cumulus can accept lines without the more recent fields at the end).




Line 36: Line 37:
* 23: Total evapotranspiration
* 23: Total evapotranspiration
* 24: Total hours of sunshine
* 24: Total hours of sunshine
* 25: High heat index
* 25: High [[Heat index]]
* 26: Time of high heat index
* 26: Time of high heat index
* 27: High apparent temperature
* 27: High [[Apparent temperature]]
* 28: Time of high apparent temperature
* 28: Time of high apparent temperature
* 29: Low apparent temperature
* 29: Low apparent temperature
Line 44: Line 45:
* 31: High hourly rain
* 31: High hourly rain
* 32: Time of high hourly rain
* 32: Time of high hourly rain
* 33: Low wind chill
* 33: Low [[wind chill]]
* 34: Time of low wind chill
* 34: Time of low wind chill
* 35: High dew point
* 35: High dew point
Line 50: Line 51:
* 37: Low dew point
* 37: Low dew point
* 38: Time of low dew point
* 38: Time of low dew point
* 39: Today's dominant/average wind direction
 
* 40: Heating degree days
The next 3 entries were added in version 1.9.2 Build 1004
* 39: Today's dominant/average wind direction (integer)
* 40: Heating degree days (see [[Heat/cold degree days and Chill hours]])
* 41: Cooling degree days
* 41: Cooling degree days
The last 3 entries were added in version 1.9.2 Build 1004


>>> Beta 1.9.3 b1036 Additions <<<
>>> Beta 1.9.3 b1036 Additions <<<
5,838

edits