Monthlyalltime.ini: Difference between revisions

2,583 bytes added ,  13:51, 18 March 2020
m
Changing to same format as other edits today, adding what I just removed from another section
m (→‎Editing monthlyalltime.ini outside Cumulus: removed text moving elsewher)
m (Changing to same format as other edits today, adding what I just removed from another section)
Line 1: Line 1:
[[Category:Log Files]]
[[Category:Log Files]]
== What is monthlyalltime.ini file? ==
== What is monthlyalltime.ini file and what format does it use? ==
The file '''monthlyalltime.ini''' was introduced in version 1.9.3 to support the Monthly Records feature that was added. For more information on this file see in the Cumulus help file, in the section “Data log file format”.  
The file '''monthlyalltime.ini''' was introduced in version 1.9.3 to support the Monthly Records feature that was added. For more information on this file see in the Cumulus help file, in the section “Data log file format”. The format consists of a number of sections (section title is delimited by square brackets [...]), with each section having a number of properties (consisting of attribute name, an equals sign and a value) each on a separate line. The sections (after the first [General]) can be in any order, Cumulus will maintain whatever order the sections are currently in. Each section has a number of parameters listed below it. Each parameter is in the format "attribute=value". 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.  


Put simply, it is just like the [[alltime.ini]] log file but each section in that is repeated 12 times in "monthlyalltime.ini" file as it contains the extremes recorded in all January periods, all February periods etc. The new feature in Cumulus allows you to compare the current month with the same month in earlier years and pick out which year had highest and lowest. The alltime.ini log file was heavily influenced by the seasonality of our weather, you might expect highest temperatures to be seen in a summer and lowest in a winter. The monthlyaltime.ini log file takes away that seasonality by limiting comparisons to a month by month basis.
Put simply, it is just like the [[alltime.ini]] log file but each section in that is repeated 12 times in "monthlyalltime.ini" file as it contains the extremes recorded in all January periods, all February periods etc. The format of monthlyalltime.ini is similar to alltime.ini but the sections are repeated for each month of the year, distinguished by a two-digit number at the end of the section name, representing the month for that section. For example, the rainfall records for September are held in section [Rain09].


The new feature in Cumulus allows you to compare the current month with the same month in earlier years and pick out which year had highest and lowest. The alltime.ini log file was heavily influenced by the seasonality of our weather, you might expect highest temperatures to be seen in a summer and lowest in a winter. The monthlyaltime.ini log file takes away that seasonality by limiting comparisons to a month by month basis.
There are differences between Cumulus 1 and MX.
[[File:Badge vMx.png]]Decimal formatting always uses a period/full stop in Cumulus MX. Cumulus MX shows date/time in ISO 8601 format of "yyyy-MM-ddTHH:mm:ss" (using the net specifiers that MX uses).
[[File:Badge v1.png]]Date, Time and Decimal formatting is as per your regional settings on the PC running Cumulus.
Thus if you want to swap from Cumulus 1 to Cumulus MX, you will copy your existing Cumulus 1 "data" folder to within your MX installation, but you will also need to manually edit your '''alltime.ini''' file so all the date/time entries are converted to the correct format. The following table shows just one section from the file, that dealing with wind, as an example of the two formats.
{| class="wikitable"
|-
! [[File:Badge v1.png]] !! [[File:Badge vMx.png]]
|-
| [Wind02] ||  [[Wind03]]
|-
| highwindvalue=44.0676460266113 || highwindvalue=9
|-
| highwindtime=09/02/2020 07:51:08 || highwindtime=2016-03-07T11:49:52
|-
| highgustvalue=62.0693855285645 || highgustvalue=29
|-
| highgusttime=09/02/2020 07:31:50 || highgusttime=2019-03-14T02:53:00
|-
| highdailywindrunvalue=477.365875244141 || highdailywindrunvalue=89.6165924072266
|-
| highdailywindruntime=09/02/2020 23:59:00 || highdailywindruntime=2014-03-26T23:59:00
|}
The wind speed and gust speed may be shown as integers if that is how your weather station outputs them, and you have not asked Cumulus to calculate them in different units.
The two columns shown represent different locations, that is why the contents do not match, this table is just to illustrate different formats.


== Initialisation ==
== Initialisation ==
5,838

edits