Dayfile.txt: Difference between revisions

1,822 bytes added ,  15:44, 9 July 2014
Line 1: Line 1:
Cumulus maintains a daily log file that holds the highs and lows of each day, as well as a few other nuggets of information.  The figures contained in the file are used for the 'This period' display accessed from the '''View''' menu and to build any graphs based on daily values.
Cumulus maintains a daily log file that holds the highs and lows of each day, as well as a few other nuggets of information.  The figures contained in the file are used for the 'This period' display accessed from the '''View''' menu and to build any graphs based on daily values.


== Viewing or Editing the daily log ==
 
To view the whole daily log use the ''dayfile.txt'' command in '''Edit''' [[Cumulus_Screenshots#File.2FEdit.2FHelp_Menu |menu]].  This is how you view, and optionally edit, the dayfile.txt from within Cumulus.  If you upload the file to your web site, then see [[AnnualDataSummary]] for information about one of the ways to show values from this file.
== How Cumulus uses the daily log ==
*Cumulus is frequently reading observations from your weather station. When it is restarted, depending on the make of weather station, it may read observations from the station's log into the Cumulus monthly log, otherwise the observations in the station's current measurements holder at the Cumulus logging interval are what gets written into the monthly log.
*It tracks the highs and lows in those observations by comparing read values against those it has stored in [[Today.ini]].
*(It also updates [[Alltime.ini]], [[Monthlyalltime.ini]], [[Year.ini]], and [[Month.ini]] when appropriate.  See the Wiki pages for these files or the Cumulus Help for more information, including the details of where the previous values are logged for updates to these highs and lows).
*When Cumulus processes the end of the (meteorological) day, the highs, lows and other information in 'today.ini' are used to create a new line in dayfile.txt, and a new today.ini is created initialised with the observations just read from the weather station.
*Back ups of all the files mentioned here are copied to the 'cumulus\backup\daily' folder.
*There are no updates to dayfile.txt at any other times, but the contents of the file are read and processed for many of the display and edit menu options selected from the main Cumulus screen.
 
== Viewing or Editing the daily log within Cumulus ==
To view the whole daily log use the ''dayfile.txt'' command in '''Edit''' [[Cumulus_Screenshots#File.2FEdit.2FHelp_Menu |menu]].  This is how you view, and optionally edit, the dayfile.txt from within Cumulus.   
 
== Using the daily summary log on your web-site ==
 
If you upload the file to your web site, then see [[AnnualDataSummary]] for information about one of the ways to show values from this file. Search the Cumulus support forum to see ways that others extract information from dayfile.txt to display on their web page a set of fields similar to those shown for 'Yesterday' web page for other dates in the past. Other people use dayfile.txt for updating databases stored on their web sites so that SQL can be used to display all sorts of statistics, again postings on the forum discuss this.


==Viewing summary figures for a month or period==
==Viewing summary figures for a month or period==
5,838

edits