Yesterday.ini: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search

Yesterday.ini (view source)

Revision as of 09:06, 10 June 2021

2,572 bytes added ,  09:06, 10 June 2021
m
Further resequencing to improve readability
(This page previously just sent you to today.ini. It now has the content specific to this log file)
m (Further resequencing to improve readability)
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[Category:Log Files]]
[[Category:Ini Files]]
== Introduction ==
== 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, for Cumulus 1 these are source for figures that appear on the main screen, for Cumulus 2 and 3(MX) they appear on the dashboard 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).
 
=== Sections in yesterday.ini ===
See example at end of page. Each section is headed with something in square brackets [], then a number of parameters in format "attribute=value". Most of the parameters correspond to fields in the [[dayfile.txt]] log file, yesterday.ini exists only 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 read whenever Cumulus is restarted. This means that there will not normally be a conflict if you access the file outside Cumulus, although there is no point in editing the file as its contents are already in dayfile.txt, that is where any edits to remove rouge values from yesterday should be made. 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, Cumulus will not mind. Do not however introduce any punctuation nor change the format of any parameter line.


=== Differences between Cumulus 1 and Cumulus MX ===
:Don't try to edit 'yesterday.ini' within a few minutes before or after these updating times as Cumulus needs exclusive access to delete the old file and create a new one.
All the sections are found in both versions of the software, and the contents are identically formatted, as there is no date/time parameters in this log file.  
 
However, the symbol for decimal point might vary:
=File Content=
 
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]].
 
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.
 
Refer to the [[today.ini]] page for full information on how Cumulus generates yesterday.ini from today.ini. Here we just make a few comparisons:
* See [[Average_temperature]] for one key transformation between '''today.ini''' and ''yesterday.ini''.
* Please note, no ET parameters are retained, plus there are some wind and some rain parameters not copied from '''today.ini''' to ''yesterday.ini''.
* NOTE: Yesterday's total rainfall from weather station is stored in '''today.ini''', but yesterday's total rainfall from [[Rain_measurement#Optical_Rain_Gauges|RG-11]] sensor is stored in ''yesterday.ini''.
 
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.
 
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.
 
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.
 
= Format of the file =
 
The format for all [[:Category:Ini_Files|.ini files is described here]], where some differences between the legacy Cumulus and MX are noted.
 
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.
 
It may be best not to copy your Cumulus 1  '''yesterday.ini''' file into MX when you are copying other files from your Cumulus 1 '''data''' folder to within your cumulus MX structure.
 
Instead, let MX create a new yesterday.ini log file when it does the next update (see [[#Introduction]]). 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.
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 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.  
[[File:Badge v1.png]] Decimal formatting is as per your regional settings on the PC running Cumulus.  
If you are moving from Cumulus 1 to Cumulus MX, then you might want to copy your Cumulus 1 '''data''' folder to within your cumulus MX structure; let MX create a new yesterday.ini log file.


==Example yesterday.ini==
==Example yesterday.ini==
See [[Average_temperature]] for one key transformation between today.ini and yesterday.ini, no ET parameters are retained, plus there are some wind and some rain parameters not copied from today.ini to yesterday.ini. This log file is exactly same in Cumulus 1, 2, and 3 (MX).


NOTE: Yesterday's total rainfall from weather station is stored in today.ini, but yesterday's total rainfall from [[Rain_measurement#Optical_Rain_Gauges|RG-11]] sensor is stored in yesterday.ini.
This is a Cumulus 1 example.
<pre>
<pre>
[General]
[General]
Sfws
5,838

edits

Retrieved from "https://www.cumuluswiki.org/a/Special:MobileDiff/4763...9136"

Navigation menu