5,838
edits
Yesterday.ini: Difference between revisions
m
New sub-headings and resequencing
m (Update category) |
m (New sub-headings and resequencing) |
||
|
[[Category:Ini Files]]
== Introduction ==
The files '''today.ini''' and '''yesterday.ini''' are used by Cumulus to store some counts, plus the Highs and Lows (and their timestamps) for key parameters as reached on each of the two days
You can view these figures, for Cumulus 1 these are source for figures that appear on the main screen, for Cumulus 2 and 3(MX) they appear in the admin interface pages you can view. These files are normally located in the "Data" sub-folder of the path where your Cumulus.exe is installed. See [[FAQ#I_can.E2.80.99t_find_my_data_files.21| FAQ on location of data log files]] for where else to look.
Refer to the article on [[today.ini]] for information on how Cumulus generates yesterday.ini from today.ini.▼
For those people who use a 9 am or 10 am rollover, the '''yesterday.ini''' file will be updated twice each day, at midnight (when the [Solar] section is updated) and at rollover (when other sections are updated from today.ini, as the corresponding fields for the new [[dayfile.txt]] line are worked out).
*Don't try to edit 'yesterday.ini' within a few minutes before or after Cumulus performs a rollover (either at rollover time or on restarting if it was not running at rollover time) as Cumulus needs exclusive access to delete the old file and create a new one. ▼
For those people who use midnight rollover, '''yesterday.ini''' is updated just one a day (when all sections are updated from today.ini, as the corresponding fields for the new [[dayfile.txt]] line are worked out).
▲
= Format of the file =▼
=File Content=
This is as described at [[:Category:Ini_Files]], where some differences between the legacy Cumulus and MX are noted.▼
It may be noticed that '''yesterday.ini''' is (apart from solar exception to be described below) simply duplicating information shown in the existing latest line in [[dayfile.txt]]. Consequently, if there is a rogue value within "yesterday.ini", the correction should actually be made to the latest line found in [[Amending dayfile|dayfile.txt]].
If you are moving from Cumulus 1 to Cumulus MX, then you might want to copy other files from your Cumulus 1 '''data''' folder to within your cumulus MX structure; but don't copy '''yesterday.ini'''. Instead, ▼
let MX create a new yesterday.ini log file when it does the next end of day process. You will find some data is missing (during remainder of your first day) from pages displaying yesterday's data, but in all other respects MX will be working well without this file.▼
▲Refer to the
== Differences between Cumulus 1 and Cumulus MX ==▼
The original purpose of introducing '''yesterday.ini''' was simply to provide an easier way for Cumulus 1 to display yesterday's extremes on its main screen. The file is re-created at each rollover time, and Cumulus 1 would only read the file when Cumulus is restarted and the main screen needed to be generated.
Remember, the symbol for decimal point might vary:▼
However, ''when version 1.9.0 added '''Sunshine Hours''' as field 25'' in "dayfile.txt", a new use of "yesterday.ini" emerged. Sunshine hours are counted from one minute past midnight to the subsequent midnight. For those using a 9 am or 10 am rollover, the sunshine hours count will be reset to zero during their meteorological day, this means somewhere is needed to hold the previous sunshine hour count, thus the [Solar] section was added to "yesterday.ini" as it holds what goes into the new line of "dayfile.txt" when rollover happens 9 or 10 hours later.
[[File:Badge vMx.png]]Decimal formatting always uses a period/full stop in Cumulus MX.▼
[[File:Badge v1.png]] Decimal formatting is as per your regional settings on the PC running Cumulus. ▼
▲= Format of the file =
▲
The sections (after the first [General]) can be in any order, Cumulus will maintain whatever order the sections are currently in.
For readability you can insert blank lines into this file anywhere, Cumulus will not mind.
Do not however introduce any punctuation, nor change the position or format of any parameter line within a section.
== Sections in yesterday.ini ==
Each section is headed with something in square brackets [], then a number of parameters in format "attribute=value".
The first section is [General], it contains just one parameter '''Date=xxxxx'''. The value for that Date attribute is just the date in Cumulus 1 using the Microsoft Windows Short Date Format, but in MX it is a time-stamp containing date and time in ISO 8601 format of "yyyy-MM-ddTHH:mm:ss" (using the net specifiers that MX uses) of when the file was last updated.
Some of the subsequent sections are shown in the file example at the end of this page.
Some releases add an extra section not included in the previous release, to reflect the way that as time goes by Cumulus is adding more functionality.
Most of the parameters correspond to fields in the [[dayfile.txt]] log file.
▲==Specific Differences for this file between Cumulus 1 and Cumulus MX ==
There are more sections in the current MX version of this file compared with that in Cumulus 1.9.4, just as functionality was added during the development of the legacy Cumulus, functionality has been added during the development of MX. As just one example, MX introduced an extra section for ''Feels Like'' at release 3.6.0.
▲
▲Instead, let MX create a new yesterday.ini log file when it does the next
▲Remember, the symbol for decimal point might vary:
▲[[File:Badge vMx.png]]Decimal formatting always uses a period/full stop in Cumulus MX.
▲[[File:Badge v1.png]] Decimal formatting is as per your regional settings on the PC running Cumulus.
==Example yesterday.ini==
| |||