Recent History (preserving history): Difference between revisions

m
no edit summary
m (Minor resequencing of page)
mNo edit summary
 
(6 intermediate revisions by 2 users not shown)
[[Category:Terminology]] [[Category:Cumulus Files]]
{{Template:Version badge Mx}}{{Version badge 1}}This Wiki page applies to all Cumulus flavours (including the abandoned Cumulus 2).
[[Category:Terminology]]
 
=What is Recent History?=
 
Recent history functionality in Cumulus is the ability to store weather values, at up to 1 minute intervals, for the last 7 days.
 
ItOnly issome importantspot toreadings realise,are thesestored arein spotRecent readingsHistory, andthe stored values will miss any extremes that occur between the times when the recent history values are stored. The weather value that tends to vary the most is wind speed, so that is where peaks are most often missed.
 
ItWhen Cumulus is alsorunning importantnormally, toentries realiseare thatstored weatheronce stationsa areminute, notregardless supplyingof valueshow tooften Cumulus oninterrogates athe continuousweather basisstation (might be every 10 seconds, dependingor onmore theor weatherless stationfrequently) typeand valuesregardless mayof behow availableoften atthe variousweather intervals,station eithergets everyupdated soreadings manyfrom secondssensors or(might perhapsbe atevery afew rateseconds, lessevery than40 onceseconds, aevery minute or less frequently). This can mean that the readings stored on a 1-minute basis may actually be duplicates if the station has not supplied a new value since the previous minute, or may not capture every reading from sensors if they are read more than once in a minute.
 
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. Since release 3.12.0, entries less than a week old, from when MX was previously running will be retained, and those will be at one minute interval; earlier releases will not collect any entries from when Cumulus was previously running, just those for up to a week while it was not running.
 
=How is the functionality used?=
 
Depends on the release you are running:
* Release 3.12.0 onwards: Held in [[cumulusmx.db|RecentData table in cumulusmx.db]] (uses SQLite),. soThere are many software tools available outsidethat can read/edit SQLite3, this is not the place to get too technical, but take a look at '''sqlitebrowser''' in a Linux environment, and '''phpLiteAdmin''' in Microsoft Windows. Also, you could use any application that can read ODBC files (e.g. Libre Office's Base functionality) can read the MX databases.
* Cumulus 2: Was held in an external SQLite database, together with other data that Cumulus 1 had held in text files, as above
* Releases 3.0.0 to 3.11.4: Held in a SQLite database table that is stored in-memory within MX code
* Cumulus 2: Was held in an external SQLite database, together with other data that Cumulus 1 had held in text files
* In the legacy Cumulus 1, the values were stored in an array held within the Cumulus code.