Realtime.txt: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
(→‎Format of the file: noted version 1.8.4 additions)
(Converted the File Format section into a table and added some links to external sites on technical terms)
Line 18: Line 18:
The realtime.txt is used by:
The realtime.txt is used by:
*the 'gagues' page on the website produced by Cumulus
*the 'gagues' page on the website produced by Cumulus
*[[CumulusRealtime]] -- the new application developed in SilverLight
*[[CumulusRealtime]] -- the new application developed in [http://silverlight.net/ SilverLight]




Line 25: Line 25:
==Format of the file==
==Format of the file==


{| class="wikitable" border="1"
*date (always dd/mm/yy)
|-
*time(always hh:mm:ss)
!style="width:60px" | Field #
*outside temperature
!style="width:80px" | Example
*relative humidity
!style="width:350px" | Description
*dewpoint
|-
*wind speed (average)
|-
*latest wind speed reading
|1
*wind bearing (degrees)
|19/08/09
*current rain rate
|date (always dd/mm/yy)
*rain today
|-
*barometer
|2
*wind direction
|16:03:45
*wind speed (beaufort)
|time(always hh:mm:ss)
*wind units
|-
*temperature units
|3
*pressure units
|8.4
*rain units
|outside temperature
*wind run (today)
|-
*pressure trend value
|4
*monthly rainfall
|84
*yearly rainfall
|[http://en.wikipedia.org/wiki/Relative_humidity relative humidity]
*yesterday's rainfall
|-
*inside temperature
|5
*inside humidity
|5.8
*wind chill
|[http://en.wikipedia.org/wiki/Dewpoint dewpoint]
*temperature trend value
|-
*today's high temp
|6
*time of today's high temp (hh:mm)
|24.2
*today's low temp
|wind speed (average)
*time of today's low temp (hh:mm)
|-
*today's high wind speed (average)
|7
*time of today's high wind speed (average) (hh:mm)
|33.0
*today's high wind gust
|latest wind speed reading
*time of today's high wind gust (hh:mm)
|-
*today's high pressure
|8
*time of today's high pressure (hh:mm)
|261
*today's low pressure
|wind bearing (degrees)
*time of today's low pressure (hh:mm)
|-
*Cumulus version
|9
*Cumulus build number
|0.0
*10-minute high gust (added [[Version 1.8.4]])
|current rain rate (per hour)
*heat index
|-
*humidity idex
|10
*UV Index (added [[Version 1.8.4]])
|1.0
*Evapotranspiration today (added [[Version 1.8.4]])
|rain today
*Solar Radiation W/m2 (added [[Version 1.8.4]])
|-
*10-minute average wind bearing (degrees) (added [[Version 1.8.4]])
|11
*rainfall last hour (added [[Version 1.8.4]])
|999.7
|barometer
|-
|12
|W
|wind direction
|-
|13
|6
|wind speed ([http://en.wikipedia.org/wiki/Beaufort_scale beaufort])
|-
|14
|km/h
|wind units - m/s, mph, km/h, kts
|-
|15
|C
|temperature units - degree C, degree F
|-
|16
|hPa
|pressure units - MB, hPa, in
|-
|17
|mm
|rain units - mm, in
|-
|18
|146.6
|wind run (today)
|-
|19
| +0.1
|pressure trend value
|-
|20
|85.2
|monthly rainfall
|-
|21
|588.4
|yearly rainfall
|-
|22
|11.6
|yesterday's rainfall
|-
|23
|20.3
|inside temperature
|-
|24
|57
|inside [http://en.wikipedia.org/wiki/Humidity humidity]
|-
|25
|3.6
|[http://en.wikipedia.org/wiki/Wind_chill wind chill]
|-
|26
| -0.7
|temperature trend value
|-
|27
|10.9
|today's high temp
|-
|28
|12:00
|time of today's high temp (hh:mm)
|-
|29
|7.8
|today's low temp
|-
|30
|14:41
|time of today's low temp (hh:mm)
|-
|31
|37.4
|today's high wind speed (average)
|-
|32
|14:38
|time of today's high wind speed (average) (hh:mm)
|-
|33
|44.0
|today's high wind gust
|-
|34
|14:28
|time of today's high wind gust (hh:mm)
|-
|35
|999.8
|today's high pressure
|-
|36
|16:01
|time of today's high pressure (hh:mm)
|-
|37
|998.4
|today's low pressure
|-
|38
|12:06
|time of today's low pressure (hh:mm)
|-
|39
|1.8.7
|Cumulus version
|-
|40
|819
|Cumulus build number
|-
|41
|36.0
|10-minute high gust
|-
|42
|10.3
|heat index
|-
|43
|10.5
|[http://en.wikipedia.org/wiki/Humidex humidex]
|-
|44
|13
|[http://en.wikipedia.org/wiki/Uv_index UV Index]
|-
|45
|0.2
|[http://en.wikipedia.org/wiki/Evapotranspiration evapotranspiration] today
|-
|46
|14
|[http://en.wikipedia.org/wiki/Solar_radiation solar radiation] W/m2
|-
|47
|260
|10-minute average wind bearing (degrees)
|-
|48
|2.3
|rainfall last hour
|}


==Example of the file==
==Example of the file==

Revision as of 12:11, 19 August 2009

CumulusInternetSettingsScreen.png

Although not technically a 'log file' is is automatically produced by Cumulus and follows a similar format to the other Log files.

realtime.txt is a text file with a single line of space separated values. It contains a list of key values of the sensors and is updated frequently.

Using cumulus you decide how often to update the file -- for example every 15 seconds. This is then uploaded to your website and used to produce near instant readings.

To set how often the file is produced by Cumulus, click on the 'Configuration' menu then 'Internet' (Click the thumbnail opposite)


Notes:

  • The realtime.txt file is NOT a log file and is constantly replaced. It does not therefore contain any historic data.
  • The 'interval' sets how often Cumulus produces and uploads to the website


Where is the files used

The realtime.txt is used by:



Format of the file

Field # Example Description
1 19/08/09 date (always dd/mm/yy)
2 16:03:45 time(always hh:mm:ss)
3 8.4 outside temperature
4 84 relative humidity
5 5.8 dewpoint
6 24.2 wind speed (average)
7 33.0 latest wind speed reading
8 261 wind bearing (degrees)
9 0.0 current rain rate (per hour)
10 1.0 rain today
11 999.7 barometer
12 W wind direction
13 6 wind speed (beaufort)
14 km/h wind units - m/s, mph, km/h, kts
15 C temperature units - degree C, degree F
16 hPa pressure units - MB, hPa, in
17 mm rain units - mm, in
18 146.6 wind run (today)
19 +0.1 pressure trend value
20 85.2 monthly rainfall
21 588.4 yearly rainfall
22 11.6 yesterday's rainfall
23 20.3 inside temperature
24 57 inside humidity
25 3.6 wind chill
26 -0.7 temperature trend value
27 10.9 today's high temp
28 12:00 time of today's high temp (hh:mm)
29 7.8 today's low temp
30 14:41 time of today's low temp (hh:mm)
31 37.4 today's high wind speed (average)
32 14:38 time of today's high wind speed (average) (hh:mm)
33 44.0 today's high wind gust
34 14:28 time of today's high wind gust (hh:mm)
35 999.8 today's high pressure
36 16:01 time of today's high pressure (hh:mm)
37 998.4 today's low pressure
38 12:06 time of today's low pressure (hh:mm)
39 1.8.7 Cumulus version
40 819 Cumulus build number
41 36.0 10-minute high gust
42 10.3 heat index
43 10.5 humidex
44 13 UV Index
45 0.2 evapotranspiration today
46 14 solar radiation W/m2
47 260 10-minute average wind bearing (degrees)
48 2.3 rainfall last hour

Example of the file

(this is one complete line, although it may appear on this page as two or more due to screen width restrictions)


18/10/08 16:03:45 8.4 84 5.8 24.2 33.0 261 0.0 1.0 999.7 W 6 mph C mb mm 146.6 +0.1 85.2 588.4 11.6 20.3 57 3.6 -0.7 10.9 12:00 7.8 14:41 37.4 14:38 44.0 14:28 999.8 16:01 998.4 12:06 1.8.2 448 36.0 10.3 10.5 13 0.2 14 260 2.3

Retrieved from "https://www.cumuluswiki.org/index.php?title=Realtime.txt&oldid=86"