Alltimelog.txt: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
m (typo)
(new value field was missing)
Line 5: Line 5:




==Format of the file==
== Format of the file ==


each line in the text file is made up of the following detail, delimited with a space
each line in the text file is made up of the following detail, delimited with a space


*date
*new date
*time
*new time
*new value
*"item name"
*"item name"
*old date
*old date
*old time
*old time
*old value
*old value


The dates are in ISO format (yyyy-mm-dd) and the times are in hh:mm 24-hour format (the separator is always a colon, irrespective of system settings), and the values are always to three decimal places. You should round the values appropriately when using them. The quotes are present with the item names.
The dates are in ISO format (yyyy-mm-dd) and the times are in hh:mm 24-hour format (the separator is always a colon, irrespective of system settings), and the values are always to three decimal places. You should round the values appropriately when using them. The quotes are present with the item names.



==Example line of the file==
==Example line of the file==

Revision as of 15:12, 31 October 2011

Cumulus keeps a log of changes to the 'all time records', called alltimelog.txt, which can be found in the data folder. An entry is added to this file every time an all-time record changes, with details of the old and new records. This log can then be used to 'backtrack' if spurious data causes an all-time record to be broken incorrectly. It is also a useful log of when records were actually broken.


This feature was introduced in Build 920 of Cumulus (version 1.8.9) so earlier versions will not have this file. Also worth noting that if you are on the current version you may not have the file as none of your previous Records have been exceeded yet.


Format of the file

each line in the text file is made up of the following detail, delimited with a space

  • new date
  • new time
  • new value
  • "item name"
  • old date
  • old time
  • old value

The dates are in ISO format (yyyy-mm-dd) and the times are in hh:mm 24-hour format (the separator is always a colon, irrespective of system settings), and the values are always to three decimal places. You should round the values appropriately when using them. The quotes are present with the item names.

Example line of the file

2010-02-24 05:19 -7.600 "Lowest temperature" 2009-02-09 04:50 -6.500