Category:Log Files: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
m (Adding more about BOM)
m (→‎TYPES: update count)
 
(25 intermediate revisions by the same user not shown)
Line 1: Line 1:
Below is a list of the Log files within Cumulus.  
This category is to be deprecated. Currently, it is only for legacy Cumulus 1
   
[[Category:Cumulus 1]]


Descriptions, and tips, can also be found in the Help file within the Cumulus software.


Remember, if you edit any of these log files to obey cautions in the individual articles:
=Explanation=
* stop cumulus before editing any file that Cumulus might be updating,
* don't use a word processor (that adds lots of unwanted control characters),
* don't change the format of files for example don't change format of dates or real numbers (using a spreadsheet, like Microsoft Office Excel or Libre Office Calc, don't let dates or special numbers be recognised),
* don't add 'Byte Order Mark' (many pieces of software on Microsoft Windows such as Notepad treat a BOM as a required magic number and add a BOM when saving text as UTF-8. Google Docs also adds a BOM when converting a document to a plain text file for download.),
* don't add blank lines (the only 'blank' line in a log file is the final one, where Cumulus will later append the next item),
* don't add headers to files where Cumulus needs to read the file as well as update it (Cumulus reads all log files except Alltimelog.txt).


Essentially, there are 4 types:
*This sub-category provides links to pages that give explanations for all of the Log files within Cumulus 1. 
# .ini files - these hold values that represent sums, counts, or extremes, for cumulus to read, and update, as it reads the weather observations.
*Descriptions, and tips, can also be found in the Help file within the Cumulus 1 software.
# .txt files - these are the logs that Cumulus updates at defined intervals to hold details of what has happened, but it can also read these files when requested.
 
# .xml file - this holds the [[Weather_Diary]]. Although it uses standard XML, the component that Cumulus 1 uses also writes a special value that other XML editors will not understand.
= Correcting Log files =
# .log file - cumulus writes either "Logging Disabled" messages or logs its actions in detail for debugging purposes into [[debug.log]].
 
[[Calculate Missing Values]], [[Amending dayfile]], and [[Correcting Extremes]], are the pages to look at.  


These files apply to both Cumulus 1 and Cumulus MX.  Note that file names are case-sensitive, read documentation to see where capital letters are required.
= TYPES =


Cumulus MX also has some JSON files with data for its trends web page.
Essentially, there are 4 types:
[[Category:Cumulus Files]]
# '''.ini''' files - these hold values that represent sums, counts, or extremes, for cumulus to read, and update, as it reads the weather observations, click on links below for details
# '''.txt''' files - these are the logs that Cumulus updates at defined intervals to hold details of what has happened, but it can also read these files when requested, click on links below for details
#* '''[[Speciallog.txt]]'''  is only Cumulus 1.
# '''.xml''' file - this holds the Cumulus 1 [[Weather_Diary]]. Although it uses standard XML, the component that Cumulus 1 uses also writes a special value that other XML editors will not understand.
#  '''.log''' files, see both [[Debug.log|this page]] and [[Diags_folder|this page]] for Cumulus 1 diagnostics

Latest revision as of 10:03, 11 June 2021

This category is to be deprecated. Currently, it is only for legacy Cumulus 1


Explanation

  • This sub-category provides links to pages that give explanations for all of the Log files within Cumulus 1.
  • Descriptions, and tips, can also be found in the Help file within the Cumulus 1 software.

Correcting Log files

Calculate Missing Values, Amending dayfile, and Correcting Extremes, are the pages to look at.

TYPES

Essentially, there are 4 types:

  1. .ini files - these hold values that represent sums, counts, or extremes, for cumulus to read, and update, as it reads the weather observations, click on links below for details
  2. .txt files - these are the logs that Cumulus updates at defined intervals to hold details of what has happened, but it can also read these files when requested, click on links below for details
  3. .xml file - this holds the Cumulus 1 Weather_Diary. Although it uses standard XML, the component that Cumulus 1 uses also writes a special value that other XML editors will not understand.
  4. .log files, see both this page and this page for Cumulus 1 diagnostics

Pages in category "Log Files"

The following 5 pages are in this category, out of 5 total.

C

D

F

R

Retrieved from "https://www.cumuluswiki.org/index.php?title=Category:Log_Files&oldid=9145"