Monthly log files: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
mNo edit summary
m (changed sequence)
Line 1: Line 1:
Please see [[Standard log files]],  [[Extra Sensor Files]], [[Month.ini]], or [[Monthlyalltime.ini]], as relevant.
Please see [[Standard log files]],  [[Extra Sensor Files]], [Air_Link_Log.txt]], [[Month.ini]], or [[Monthlyalltime.ini]], as relevant.


Please be aware that all of above may be described as ''monthly log files'' when reading individual Cumulus forum and wiki references. Prior to MX, the name "monthly log" was most often used as a collective term for the last two files linked above.  
Please be aware that all of the above links lead to documentation about files that may be described as ''monthly log files'' when reading individual Cumulus forum and wiki references.  


The original Steve Loft terminology for each of the log files, when they were first introduced in Cumulus 1 has been adopted here to avoid possible future confusion for those looking at older articles in this wiki or oldest posts on the forum. It is hoped that people will return to this terminology, where files are named based on their content, the last two links contain monthly data in each line, just like the daily summary log file contains daily data in each line.
For the original Cumulus software (Cumulus 1 and 2), the name "monthly log" was most frequently used as a collective term for the last two files linked above.  


For users of MX, the terminology "monthly log" has shifted to the first linked file which is the log file feeding into a database table called by default '''Monthly''', which of course does not contain monthly data, it is just a log file that is regenerated each month.
When Steve Loft was working on his [[Cumulus_3_(MX)_beta_documentation|MX Beta]], he decided to implement within MX functionality the database schema that Mark Crossley had designed on [[ImportCumulusFile#Monthly_table_.28old.29|this]] page, where Mark selected the name '''Monthly''' for the table. David A Jamieson created versions 1.0 and 1.1 of ImportCumulusFile for creating a single table called '''dayfile''', but Mark extended it to cover ''realtime'' and what he called ''monthly log files''. That means the standard log can in MX optionally feed data into a database table called '''Monthly''' by default in MX. The terminology is misleading as that database table is not organised by month in any way, a single table contains every logged line that has been inserted into it by '''ExportMySQL.exe''' or '''CumulusMX.exe'''.
 
Anyway, as Mark Crossley has taken over development of MX, the terminology "monthly log" is now being used for the first linked file (standard logs) instead of for '''month.ini' the file that is truly logging monthly extremes. This MX practice is a misleading naming for novices as a line does not represent a month (in the way each dayfile line represents a day), the name has been adopted because a new log file is started for each month. Further more the practice leaves "month.ini" without a descriptive name.
 
As already pointed out, there is possible confusion because the last two links do contain monthly data in each line, just like the daily summary log file contains daily data in each line.
 
The original Steve Loft terminology for each of the log files, when they were first introduced in his original Cumulus software has been adopted throughout the documentation, to avoid possible future confusion for those looking at older articles in this wiki or oldest posts on the forum.  It is probable that newcomers to Cumulus will prefer to use the terminology used in this documentation, where '''files are named based on their content'''.

Revision as of 17:02, 27 January 2021

Please see Standard log files, Extra Sensor Files, [Air_Link_Log.txt]], Month.ini, or Monthlyalltime.ini, as relevant.

Please be aware that all of the above links lead to documentation about files that may be described as monthly log files when reading individual Cumulus forum and wiki references.

For the original Cumulus software (Cumulus 1 and 2), the name "monthly log" was most frequently used as a collective term for the last two files linked above.

When Steve Loft was working on his MX Beta, he decided to implement within MX functionality the database schema that Mark Crossley had designed on this page, where Mark selected the name Monthly for the table. David A Jamieson created versions 1.0 and 1.1 of ImportCumulusFile for creating a single table called dayfile, but Mark extended it to cover realtime and what he called monthly log files. That means the standard log can in MX optionally feed data into a database table called Monthly by default in MX. The terminology is misleading as that database table is not organised by month in any way, a single table contains every logged line that has been inserted into it by ExportMySQL.exe or CumulusMX.exe.

Anyway, as Mark Crossley has taken over development of MX, the terminology "monthly log" is now being used for the first linked file (standard logs) instead of for month.ini' the file that is truly logging monthly extremes. This MX practice is a misleading naming for novices as a line does not represent a month (in the way each dayfile line represents a day), the name has been adopted because a new log file is started for each month. Further more the practice leaves "month.ini" without a descriptive name.

As already pointed out, there is possible confusion because the last two links do contain monthly data in each line, just like the daily summary log file contains daily data in each line.

The original Steve Loft terminology for each of the log files, when they were first introduced in his original Cumulus software has been adopted throughout the documentation, to avoid possible future confusion for those looking at older articles in this wiki or oldest posts on the forum. It is probable that newcomers to Cumulus will prefer to use the terminology used in this documentation, where files are named based on their content.