Alltimelog.txt: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
m (Undo revision 4743 by Sfws (talk))
Tag: Undo
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
Cumulus keeps a log of changes to the 'all time records', called <tt>alltimelog.txt</tt>, 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 page applies to both [[File:Badge vMx.png]] and [[File:Badge v1.png]]. [[Category:Files_with_Comma_Separated_Values]][[Category:Cumulus 1]][[Category:Cumulus MX]]


This file is just a log of changes, it is not read by Cumulus. Editing it has no effect.
This file was introduced at Build 920 (28 Feb 2010) as a log of changes to the "alltime.rec" records, and it can be found in the data folder. From Build 924 (4 March 2010 beta version 1.8.9), the use of "alltime.rec" was discontinued, instead [[Alltime.ini]] was used, so this file now logs changes made in that file.
 
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 file is just a log of changes, it is not read by Cumulus, Cumulus just appends to it. Editing any existing content in this file has no effect on Cumulus being able to continue to append to it.


== Format of the file ==
== Format of the file ==
Line 15: Line 19:
*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==
  2010-02-24 05:19 -7.600 "Lowest temperature" 2009-02-09 04:50 -6.500
  2010-02-24 05:19 -7.600 "Lowest temperature" 2009-02-09 04:50 -6.500
[[Category:Log Files]]

Latest revision as of 21:30, 31 December 2021

This page applies to both Badge vMx.png and Badge v1.png.

This file was introduced at Build 920 (28 Feb 2010) as a log of changes to the "alltime.rec" records, and it can be found in the data folder. From Build 924 (4 March 2010 beta version 1.8.9), the use of "alltime.rec" was discontinued, instead Alltime.ini was used, so this file now logs changes made in that file.

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 file is just a log of changes, it is not read by Cumulus, Cumulus just appends to it. Editing any existing content in this file has no effect on Cumulus being able to continue to append to it.

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