Recent history: Difference between revisions

762 bytes removed ,  29 September 2022
m
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? =
 
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|recentRecent historyHistory tagWebtag names]] and [[Webtags/Parameters#Input_modification_Parameters|specifying how many minutes ago]] you want (tothrough avoid using large numbers,the parameters allow you to specify days ago, hours ago and minutes ago in any combination).
 
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 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?=