5,838
edits
Month.ini: Difference between revisions
From Cumulus Wiki
Jump to navigationJump to search
m
→Viewing and Editing in MX
| (5 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
== Introduction == | == Introduction == | ||
The log file "month.ini" is where Cumulus software tracks the extremes for this month, the file is divided into a number of sections headed by a name in square brackets []. 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 | The log file "month.ini" is where Cumulus software tracks the extremes for this month, the file is divided into a number of sections ''headed by a name in square brackets []''. | ||
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''' introduce any ''punctuation'' into this file. '''Do not''' change the ''format of any parameter'' line. | |||
This log file holds the information that feeds the [[Webtags#Monthly]] for the 'thismonthT.htm' web template. So you won't find the monthly rainfall total in this file, that is not in that template. | This log file holds the information that feeds the [[Webtags#Monthly]] for the 'thismonthT.htm' web template. So you won't find the monthly rainfall total in this file, that is not in that template. | ||
==DEPENDENCY ON BUILDS == | |||
=== Prior to Cumulus 1.9.2 (build 1002 - 5 July 2011) === | === Prior to Cumulus 1.9.2 (build 1002 - 5 July 2011) === | ||
There was no monthly functionality in Cumulus. | There was no monthly functionality in Cumulus. This monthly log ini file did not exist. | ||
===Cumulus builds 1041 to 1088=== | ===Cumulus builds 1041 to 1088=== | ||
Cumulus stores the '''Month.ini''' for the month just finishing when it does end of month roll-over. | Month.ini is one of the files that is included in the back up made each time there is a roll-over at the end of a meteorological day. All the files stored reflect the position as the day ended, not always the position as the new day starts. For example, Cumulus stores the '''Month.ini''' for the month just finishing when it does end of month roll-over. | ||
=== Prior to Cumulus 1.9.3 beta build 1048 === | === Prior to Cumulus 1.9.3 beta build 1048 === | ||
Month.ini contains the highest daily value for certain derivatives in the month, those daily values are supposed to be accumulated over a meteorological day, so the accumulation resets at rollover time. Due to a programming bug, some were reset at midnight irrespective of actual rollover time. Prior to build 1048 this meant that for those using 9am/10am rollover, wind run accumulated between midnight and rollover was assigned to the following day. Equally, some values where peaks at a particular time were tracked in this file, the date logged was adjusted to the correct calendar day, but between midnight and rollover it should be assigned to meteorological date (the previous calendar date) to ensure peaks were not assigned to wrong month. The full description of bugs was not recorded as it was assumed everyone updated to fixed build, and people did not care about past records (Cumulus 1 at this stage discarded records for past months). It was subsequently discovered that the bugs were not fixed completely in build 1048! | |||
=== Prior to Cumulus 1.9.3 beta build 1053 === | === Prior to Cumulus 1.9.3 beta build 1053 === | ||
| Line 29: | Line 39: | ||
From build 3035 onwards, MX archives the month.ini and year.ini file at the end of the month/year as monthYYYYMM.ini and yearYYYY.ini. | From build 3035 onwards, MX archives the month.ini and year.ini file at the end of the month/year as monthYYYYMM.ini and yearYYYY.ini. | ||
This means that although the file saved in the back up daily folder contains the month.ini for the new month | This means that although the file saved in the back up daily folder contains the month.ini for the new month and so does not back up the end of month position, the old monthly log ini file is preserved for true end of month state in the data folder with a new name. | ||
==Cumulus 1== | |||
=== Viewing month.ini in Cumulus 1 === | |||
[[File:Cumulus_1_View_menu.png]] | |||
These lows and highs and their timestamps can be seen (in Cumulus 1) by picking the ''Highs and Lows - This month'' screen from the '''View''' menu, see screenshot above. Like [[alltime.ini]] the file has section headings with lists of properties (attribute = value). For more information on this file see in the Cumulus help file, in the section “Data log file format”. | |||
===Editing in Cumulus 1=== | |||
This monthly ini log file can be edited in Cumulus 1 using '''Edit''' menu ''This month's records'' screen. | |||
==Viewing and Editing in MX== | |||
There is limited viewing functionality prior to version 3.2.2 build 3058. From then onwards there is a monthly records viewer (that also works as editor) in the admin interface for each month in all years, consequently in first year of operation this effectively allowed editing of any single month. An editor specifically for this file for the current month is not available in MX until version 3.2.5 build 3061. | |||
[[Category:Log Files]] | |||
== Differences between Cumulus 1 and MX versions of file == | == Differences between Cumulus 1 and MX versions of file == | ||
Any date/time entries are in different formats as this example from the wind section shows. | Any date/time entries are in different formats as this example from the wind section shows. | ||
| Line 84: | Line 112: | ||
If you cannot find the file [[FAQ#I_can.E2.80.99t_find_my_data_files.21|see this FAQ]]. | If you cannot find the file [[FAQ#I_can.E2.80.99t_find_my_data_files.21|see this FAQ]]. | ||
