Yesterday.ini: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
m (Update category)
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.
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.
Line 6: Line 6:


*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.
*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.
=== 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 ===
Most of 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, MX has introduced an extra section for Feels Like at version 3.6.0, and in the future it might change again.


= Format of the file =

This is as described at [[:Category:Ini_Files]], where some differences between the legacy Cumulus and MX are noted.

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.

== Differences between Cumulus 1 and Cumulus MX ==

Most of the sections are found in both versions of the software, and the contents are mostly identically formatted, as there is no date/time parameters in this log file.
Remember, the symbol for decimal point might vary:
Remember, the symbol for decimal point might vary:


Line 19: Line 25:
[[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 other files from your Cumulus 1 '''data''' folder to within your cumulus MX structure; but let MX create a new yesterday.ini log file.
However, MX introduced an extra section for ''Feels Like'' at release 3.6.0, and in the future it might change again.

== 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 only read if 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.




==Example yesterday.ini==
==Example yesterday.ini==

Revision as of 15:25, 8 June 2021

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 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.

  • 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.


Format of the file

This is as described at Category:Ini_Files, where some differences between the legacy Cumulus and MX are noted.

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.

Differences between Cumulus 1 and Cumulus MX

Most of the sections are found in both versions of the software, and the contents are mostly identically formatted, as there is no date/time parameters in this log file.

Remember, the symbol for decimal point might vary:

Badge vMx.pngDecimal formatting always uses a period/full stop in Cumulus MX.

Badge v1.png Decimal formatting is as per your regional settings on the PC running Cumulus.


However, MX introduced an extra section for Feels Like at release 3.6.0, and in the future it might change again.


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 only read if 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.


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), apart from the extra [FeelsLike] section introduced from version 3.6.0.

NOTE: Yesterday's total rainfall from weather station is stored in today.ini, but yesterday's total rainfall from RG-11 sensor is stored in yesterday.ini.

[General]
Date=28/04/2011

[Wind]
Speed=7.2
SpTime=09:00
Gust=15.9
Time=12:15
Bearing=315
Direction=NW
Windrun=35.3391151428223
DominantWindBearing=230

[Temp]
Low=5.6
LTime=05:34
High=21.0
HTime=14:46
HeatingDegreeDays=3.76118206977844
CoolingDegreeDays=0.702986478805542
AvgTemp=12.4447975158691

[Pressure]
Low=29.72
LTime=09:00
High=29.85
HTime=22:12

[Rain]
High=1.2
HTime=00:34
HourlyHigh=0.899999976158142
HHourlyTime=02:04
RG11Yesterday=0

[Humidity]
Low=49
High=99
LTime=14:34
HTime=00:34

[Solar]
SunshineHours=0
HighSolarRad=0
HighSolarRadTime=09:00
HighUV=0
HighUVTime=09:00

[HeatIndex]
High=21
HTime=14:46

[AppTemp]
Low=3.98110413551331
LTime=05:34
High=21.0052318572998
HTime=15:50

[WindChill]
Low=5.59999990463257
LTime=05:34

[Dewpoint]
Low=5.4555492401123
LTime=05:34
High=11.6547174453735
HTime=09:03