Year.ini: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
m (Minor editing, adding cross references to newly extended month.ini page)
Line 5: Line 5:
This log file holds the information that feeds the [[Webtags#Yearly]] for the 'thisyearT.htm' web template. So you won't find the yearly rainfall total in this file, that is not in that template.
This log file holds the information that feeds the [[Webtags#Yearly]] for the 'thisyearT.htm' web template. So you won't find the yearly rainfall total in this file, that is not in that template.


== Differences between Cumulus 1 and MX versions of file ==
== Differences between Cumulus versions for this log file ==
The year functionality is not present prior to Cumulus 1.9.2 (build 1002 - 5 July 2011).
Any date/time entries are in different formats as illustrated for [[month.ini]]. That page also tells you what you need to do if you move from Cumulus 1 to Cumulus MX and wish to keep using existing files in the "data" folder.

Some Cumulus 1 builds did not store correct values for those using 9am/10am rollover, see [[alltime.ini]] for some examples.

Any date/time entries are in different formats for Cumulus 1 and Cumulus MX as illustrated for [[month.ini]]. That page also tells you what you need to do if you move from Cumulus 1 to Cumulus MX and wish to keep using existing files in the "data" folder.

== Dealing with errors ==
== Dealing with errors ==
The diagnostic logs in the 'diags' sub-folder record before and after values for updates to highs and lows for monthly and annual extreme records, and can help if this file is corrupted by a false extreme. The stored values can be corrected using the functionality available in both Cumulus 1 and MX
The diagnostic logs in the 'diags' sub-folder record before and after values for updates to highs and lows for monthly and annual extreme records, and can help if this file is corrupted by a false extreme. The stored values can be corrected using the functionality available in both Cumulus 1 and MX

Revision as of 14:00, 18 March 2020

Introduction

The log file "year.ini" is where Cumulus software tracks the extremes for this year. Like alltime.ini this log file has section headings with lists of properties (attribute = value). For more information on this file see in the Cumulus 1 help file, in the section “Data log file format”. 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.

This log file holds the information that feeds the Webtags#Yearly for the 'thisyearT.htm' web template. So you won't find the yearly rainfall total in this file, that is not in that template.

Differences between Cumulus versions for this log file

The year functionality is not present prior to Cumulus 1.9.2 (build 1002 - 5 July 2011).

Some Cumulus 1 builds did not store correct values for those using 9am/10am rollover, see alltime.ini for some examples.

Any date/time entries are in different formats for Cumulus 1 and Cumulus MX as illustrated for month.ini. That page also tells you what you need to do if you move from Cumulus 1 to Cumulus MX and wish to keep using existing files in the "data" folder.

Dealing with errors

The diagnostic logs in the 'diags' sub-folder record before and after values for updates to highs and lows for monthly and annual extreme records, and can help if this file is corrupted by a false extreme. The stored values can be corrected using the functionality available in both Cumulus 1 and MX

These lows and highs and their timestamps can be seen by picking the Highs and Lows - This year screen from the View menu (Cumulus 1 only - see picture on this page).