Year.ini: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
m (Mention diagnostic logs)
m (Minor editing, adding cross references to newly extended month.ini page)
Line 1: Line 1:
[[Category:Log Files]]
[[Category:Log Files]]
[[File:Cumulus_View_menu.jpg]]Used to hold the information that feeds the [[Webtags#Yearly]] for the 'thisyearT.htm' web template.
== 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.


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 (in Cumulus 1, there is no editor in Cumulus MX) using the ''This year's records'' screen on the '''Edit''' menu. Date, Time and Decimal formatting is as per your regional settings on the PC running Cumulus. If you cannot find the file [[FAQ#I_can.E2.80.99t_find_my_data_files.21|see this FAQ]].
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.


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). 
== Differences between Cumulus 1 and MX versions of file ==
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.
== 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


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 help file, in the section “Data log file format”.
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 [[month.ini|this page]]).

Revision as of 11:35, 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 1 and MX versions of file

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.

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