Realtime.txt: Difference between revisions

m (Add link to category listing other Cumulus files)
 
(One intermediate revision by one other user not shown)
= List of fields in the file =
 
The list below represents the MX field list for the final 1.9.4 version of Cumulus, (and releases of MX before 3.7.0).
 
The final 1.9.4 version of Cumulus, (and releases of MX before 3.7.0) omit the final field shown below.
For historic interest, old versions of Cumulus 1 had fewer fields; although the table does not indicate the version at which each field was added, you can click the '''History''' tab and look at the early edits.
{| border="1" class="wikitable"
| Is it sunny? 1 if the sun is shining, otherwise 0 (above or below [[Cumulus.ini_(Cumulus_1)#Section:_Solar |threshold]])
| <#IsSunny>
|-
| 59
| 13.2
| Feels Like Temperature
|}
 
==Fields added with later releases of MX ==
 
Please be aware that MX develops very rapidly, and there is a lack of contributors to the Wiki, so the information here may be out of date.
 
{| border="1" class="wikitable"
|-
! style="width:60px" | Field number
! style="width:80px" | Example content
! style="width:450px" | Description
! style="width:90px" | Equivalent [[Webtags|web tag]] if your locale/region uses decimal points<br> See [[#MX web tags]] for equivalents in latest MX releases.
|-
|59 (only included for release 3.7.0 and later)
|&lt;#feelslike&gt;
|}
 
== Bandwidth Considerations ==
Most internet providers now place a limit on the amount of Bandwidth you can consume each month. Bandwidth is a figure representing the quantity of data you can upload and download. DoingThe suchvarious auploads regulardone uploadby Cumulus will have a huge impact on your allowance if you choose to upload at very frequent intervals.
 
* Sizing guidance for the legacy Cumulus (1) uploads:
** The "realtime.txt" file Cumulus (1 or MX) uploadsthe is less than 1024 bytes in size, but for the calculation we will assume 1024 bytes, and typically this is (for non Fine Offset stations, see [[#Special note to Fine Offset/EasyWeather users]]) updated every 5 to 15 seconds depending on your [[#Enabling generation of this file in MX|'Realtime interval' setting]]. above 1 kilobyte every 10 seconds represents 144 kB a day.
** Uploading [[FAQ#What_is_the_size_of_the_standard_Cumulus_update.3F|the realtime.txt plus the standard templates]] represents about 90 MB per day (based on uploading only every 10 minutes).
 
* Sizing guidance for MX uploads:
** For Cumulus MX, the optional '''realtime.txt''' file is at least 262 bytes, (a lot of the content never changes, but if you have enabled generation and upload of this file, the whole file is uploaded every time), so still smaller than that 1024 bytes, and therefore still less than 1.5 MB a day even if uploaded every second.
** The [[SteelSeries Gauges]] web page is often supplied with data every second, (34 560 times a day), that represents a minimum of 110 MB per day, as the mandatory file '''realtimegaugesT.txt''' is 2.2 kiloBytes (kB).
** MX graph drawing uses assorted [[:Category:JSON_Files|*.json]] files which add up to several megabytes (MB) at every upload (compared against the highly compressed legacy Cumulus graph images of 400 kB per upload). So assuming these .json files are uploaded at the standard interval and that is set to 1 minute, just for graph plotting, MX requires a further 150 to 350 MB per day, this is dependent on various settings (e.g. data period represented on graphs, which graphs are being plotted).
** For the other web pages, the file concerned is [[websitedataT.json]] which is 31.5 kB, and if that is uploaded every minute, that adds about 50 MB a day.
** Don't forget that you may have files uploaded at end of day, you may be sending files to third party sites, to home automation, and be uploading [[MySqlConnect|SQL commands]], all these need to be multiplied by how often they are sent in a day, and then included in your calculation where relevant.
 
On top of your internet connection bandwidth restrictions, you may also have bandwidth caps on your database, or web, serverservers so this same figure should be considered for your webvarious serverservers.
 
 
 
*The uploading interval is the same as the file creation interval.
 
means that most of it gets very out of date, as MX is develo
 
<br>
<br>
 
== Bandwidth Considerations ==
 
The file Cumulus (1 or MX) uploads is less than 1024 bytes in size, but for the calculation we will assume 1024 bytes, and typically this is (for non Fine Offset stations, see [[#Special note to Fine Offset/EasyWeather users]]) updated every 5 to 15 seconds depending on your 'Realtime interval' setting above.
 
Most internet providers now place a limit on the amount of Bandwidth you can consume each month. Bandwidth is a figure representing the data you can upload and download. Doing such a regular upload will impact on your allowance.
 
During a month (31 days) the upload process will consume roughly 175 Mbytes of bandwidth -- this is a tiny consideration as usually bandwidth restrictions from your provider start in the Gigabytes (Gb) range, not Megabytes (Mb).
 
On top of your internet connection bandwidth restrictions, you may also have bandwidth caps on your web server so this same figure should be considered for your web server.
 
 
= Special note to Fine Offset/EasyWeather users =