Reports folder: Difference between revisions

4,863 bytes added ,  06:15, 20 April 2021
m (Text replacement - "Cumulus.ini" to "Cumulus.ini_(Cumulus_1)")
Line 30: Line 30:
=Additional Information for NOAA reports =
=Additional Information for NOAA reports =


Be aware that a regenerated report might not be quite as accurate as original report which when generated is using figures actually being processed by end of day for the current day.
Steve Loft:
Be aware that a regenerated report for a past period might not be quite as accurate as the report that Cumulus can generate as part of end of day processing. The original report will use figures processed during the preceding day, while a regenerated report has to recalculate them (unless accurate figures are in dayfile.txt).  Such differences may be seen for average temperature, average wind speed, dominant direction, and the heating and cooling degree days, because Cumulus has to calculate those as it goes along, it can't do it retrospectively.


'''NOAA Report Notes:'''
==Monthly Reports==
 
For each day, a monthly report includes (in references to dayfile.txt, field numbering is based on the date as field 1, although for day just ended these figures are also in yesterday.ini):
#Average temperature (taken from what Cumulus has just calculated to put into [[Dayfile.txt|field 16 of daily summary log file]]
#Highest daily temperature and time (taken from fields 7 and 8 of the daily summary log)
#Lowest daily temperature and time (taken from fields 5 and 6 of the daily summary log)
#[[Heat/cold degree days|Heating degree days]] (taken from field 41 of the daily summary log)
#[[Heat/cold degree days|Cooling degree days]] (taken from field 42 of the daily summary log)
#Daily Rainfall (taken from field 15 of the daily summary log)
#[[Wind_measurement|Average Wind Speed]] (calculated from field 17 of daily summary log,  by dividing by 24 - the number of hours in a day)
#Highest daily average wind speed and time (taken from fields 18 and 19 of the daily summary log)
#Dominant Direction (taken from field 40 of the daily summary log)
 
In the summary line below the daily rows (note information is not taken from [[Month.ini|parameters in month.ini]]:
* the arithmetic average is calculated, and shown, for Mean Temp column  and Wind Speed column
* the total is calculated, and shown, for the Rain column
* the highest figure in column above is found, and shown, for all columns headed High or Low
** the number in time columns represents the day number where the High/Low figure shown was reported
 
In the climate summary:
#There are 4 thresholds for temperature, and the number of days blow or above is indicated
#the wettest day is indicated, and counts of days with rain above certain thresholds is shown
 
Note that the '''Heat Base''' and '''Cool Base''' shown are those in force the day the report was generated, and may not have been the setting when the individual Heating Degree Days and Cooling Degree Days were stored in dayfile.txt.
 
 
==Annual Report==
 
The annual report has a number of tables. Within each table a line appears for each month available for the year.
 
For the current month, the information is available in [[Month.ini|parameters in month.ini]].  Although MX retains old copies of that log file, it does not access them, instead all the parameters are recalculated for older lines.
 
===Temperature table===
 
Each line repeats some of the information appearing in the summary line of the respective monthly report.
 
In the settings, you can enter a month by month normal for temperature, and this report calculates, and shows, the divergence from that normal.
 
In the summary line:
* for the the Mean Max, Mean Min, and Dep. From Norm columns, the figure shown is the arithmetic average  of figures above
* for the mean column,
** in recent MX releases, the figure shown is the mean of all entries for this year in [[Dayfile.txt|field 16 of daily summary log file]]
** in early MX releases and the legacy Cumulus, the figure shown is the arithmetic average  of figures above
* totals of figures above are shown for the Heat Deg Days, Cool Deg Days, and Max/Min comparisons with thresholds
 
===Precipitation table===
 
Similar to previous table, information shown represents monthly figures and divergences from normal. All should be self-explanatory. The month with most rain is shown in the summary line.
 
===Wind Speed table===
 
The simplest table, it shows average and highest for each month, together with dominant direction for each month. The summary line is based on the information in each column.
 
==Development notes==
 
===Cumulus 1===
 
Information taken from support forum posts by Steve Loft:
*The NOAA report takes the figures from dayfile.txt. If you did a 'create missing' in the dayfile.txt editor with a version before 1.9.4 build 1083, that "Create Missing" action would have stored the figures the wrong way round in dayfile.txt, and hence any NOAA report including those days created by "Create Missing" would have the wrong figures for those days.
* for obsolete versions up to 1.9.4 build 1085 only: The average wind speed used for NOAA reports and 'This period' type screens was, by a bug, based on midnight to midnight days regardless of rollover time in use. (It is calculated on generation of report or screen from standard log file entries).  
* for obsolete versions up to 1.9.4 build 1085 only: The average wind speed used for NOAA reports and 'This period' type screens was, by a bug, based on midnight to midnight days regardless of rollover time in use. (It is calculated on generation of report or screen from standard log file entries).  
*From build 1086, the calculation is based on the rollover time being used.
*From build 1086, the calculation is based on the rollover time being used.
* For all Cumulus 1 versions, and the MX versions below 3.4.4: the yearly average temperature is calculated from summing monthly maximum and monthly minimum values and dividing by number of values in calculation.
* For all Cumulus 1 versions, and the MX versions below 3.4.4: the yearly average temperature is calculated from summing monthly maximum and monthly minimum values and dividing by number of values in calculation.
===MX===
Information taken from support forum posts by Mark Crossley:
*For release versions 3.0.0 to 3.4.3, on yearly reports, the annual, average temperature was calculated as the mean of the averages for each month above, and so not identical to the average of daily means, because months vary in length
**The divergence was particularly significant in say March, when the reported average was based on 31 days in January, 28 days in February and a few days in March.
* From version 3.4.4 the annual average temperature is calculated using the integrated method based on every temperature reading processed (it is actually the average calculated from all daily means stored in daily summary log for this year).
* From version 3.4.4 the annual average temperature is calculated using the integrated method based on every temperature reading processed (it is actually the average calculated from all daily means stored in daily summary log for this year).


= NOAA style Report Naming =
= NOAA style Report Naming =
5,838

edits