Recent history: Difference between revisions

762 bytes removed ,  12:17, 29 September 2022
m
Line 24: Line 24:
When Cumulus is restarted, if the weather station provides historical catch-up data, then the interval between entries for that period when Cumulus was not running, is stored at whatever interval the historical catch-up data uses.  Entries less than a week old, from when MX was previously running will be retained, and those will be at one minute interval.
When Cumulus is restarted, if the weather station provides historical catch-up data, then the interval between entries for that period when Cumulus was not running, is stored at whatever interval the historical catch-up data uses.  Entries less than a week old, from when MX was previously running will be retained, and those will be at one minute interval.


=How is the functionality used?=
= How is the functionality used =


By a request to Cumulus specifying 1 to 10 079 minutes ago. Then Cumulus will retrieve the value for the nearest available time.  
By a request to Cumulus specifying 1 to 10 079 minutes (equals 7 days) ago. Then Cumulus will retrieve the value for the nearest available time.  


The normal way to retrieve a specific value is by using [[Webtags#Recent_History|recent history tag names]] and [[Webtags/Parameters#Input_modification_Parameters|specifying how many minutes ago]] you want (to avoid using large numbers, parameters allow you to specify days ago, hours ago and minutes ago in any combination).
The normal way to retrieve a specific value is by using Recent History Webtag names and specifying how many minutes ago you want through the parameters.


You'll get the nearest value if you ask for a time for which there is currently no exact match, and the first tag [[Webtags#Recent_History|listed here]] tells you that nearest time.
You'll get the nearest value if you ask for a time for which there is currently no exact match, and the first tag [[Webtags#Recent_History|listed here]] tells you that nearest time.


There are a number of internal calculations, such as calculating [[Average temperature]], [[Heat/cold degree days and Chill hours]], which use the recent history data:
There are a number of internal calculations, such as calculating [[Average temperature]], [[Heat/cold degree days and Chill hours]], which use the recent history data stored in the Recent History Database for CumulusMX. These data are also used for the standard [[MX_Administrative_Interface#Charts|charts]] and the JSON data for the charts on the standard website and many other websites. See: [[:Category:JSON_Files#Uploading_data_to_a_web_server_outside_MX:|Uploading data to a webserver outside CumulusMX ]] .
*  Mark Crossley has explicitly said these calculations use the recent history database for MX
* Steve Loft said they are calculated from data at one minute intervals, he did not explicitly say that the legacy software uses recent history data array
 
When the legacy Cumulus is generating images containing graphs for its [[Customised_templates#The_Standard_Templates_for_Cumulus_1|"Trends.htm"]] web page, Steve Loft did say these use data from recent history array and that not all points on those graphs are at one minute intervals if data is not available for all minutes.
 
MX uses data from recent history in its [[API_Graph_Data|Application Programming Interface]] for the standard [[MX_Administrative_Interface#Charts]]
 
MX optionally uses data from recent history (using several different .json files), see [[:Category:JSON_Files#Uploading_data_to_a_web_server_outside_MX]] to make the data available for plotting charts on your web server.
 


=How does Cumulus update the data?=
=How does Cumulus update the data?=