Webtags (preserving history): Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search

Webtags (preserving history) (view source)

Revision as of 08:41, 22 March 2020

276 bytes added ,  08:41, 22 March 2020
m
→‎The Tags
Line 229: Line 229:
|}
|}


=The Tags=
=The Web Tags for Cumulus =
 
These are available in both Cumulus 1 and MX unless indicated by a version 1 or MX badge.
 
===System===
 
Special tags returning information about the Windows device hosting Cumulus. If you are running MX on Linux or Mac OS X, then some of these tags may not work.


Below is a list of the webtags available in the 1.9.4 version of Cumulus.  For Cumulus MX the few differences will be made clear when it is formally released.


==Units==
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | webtag
!style="width:150px" |Web tag_name
!style="width:600px" | Function
!style="width:600px" |Function
|-
|-
|<#tempunit>
|<#OsVersion>
|Unit of temperature being used (Set in Cumulus as [http://en.wikipedia.org/wiki/Centigrade Celsius] or [http://en.wikipedia.org/wiki/Fahrenheit Fahrenheit]) values "&amp;deg;C" or "&amp;deg;F"
|OS version, e.g. "Windows 7 x64 build 7600"
|-
|-
|<#tempunitnodeg>
|<#OsLanguage>
|The temperature units being used, without a degree symbol, i.e. "F" or "C"
|OS language, e.g. "English"
|-
|-
|<#pressunit>
|<#SystemUpTime>
|Unit of measure for pressure. Possible values: "mb", "hPa", "in"
|How long the system has been up, e.g. "8 hours 21 minutes"
|-
|-
|<#rainunit>
|<#ProgramUpTime>
|Unit of measure for rain fall. Possible values: "mm" or "inches"
|How long Cumulus has been running, e.g. "7 hours 55 minutes"
|-
|-
|<#windunit>
|<#CpuName>
|Unit of measure for wind speed. Possible values: "m/s", "mph", "km/h", "kts"
|CPU type, e.g. "Intel(R) Core(TM)2 Quad CPU Q6600 @ 2.40GHz"
|-
|-
|<#windrununit>
|<#CpuCount>
|Unit of measure for wind run (distance). Possible values: "km", "miles", "km", "nm" (for wind speeds in m/s, mph, km/h, kts)
|Number of processors, e.g. "4"
|-
|<#MemoryStatus>
|Free and total system RAM, e.g. "4619/8191 MB (free/total)"
|-
|<#DisplayMode>
|Screen display mode, e.g. "1680x1050, 32 bit"
|-
|<#AllocatedMemory>
|Amount of memory allocated to Cumulus, e.g. "18.76 MB"
|-
|<#DiskSize>
|Size of disk on which Cumulus is running, e.g. "931.51 GB"
|-
|-
|<#cloudbaseunit>
|<#DiskFree>
|The units used for cloudbase value. Possible values:  "ft" or "m"
|Free space on disk on which Cumulus is running, e.g. "515.36 GB"
|}
|}


==Date & Time==
==Units==
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | webtag
!style="width:150px" | Web tag_name
!style="width:600px" | Function
!style="width:600px" | Function
|-
|-
|<#date>
|<#tempunit>
|The current date
|Unit of temperature being used (Set in Cumulus as [http://en.wikipedia.org/wiki/Centigrade Celsius] or [http://en.wikipedia.org/wiki/Fahrenheit Fahrenheit]) values "&amp;deg;C" or "&amp;deg;F"
|-
|-
|<#time>
|<#tempunitnodeg>
|The current time and date. Example result: 18:30 on 30 December 2009.  If you simply wish the time, use a combination of the day, month, year tags (below)
|The temperature units being used, without a degree symbol, i.e. "F" or "C"
|-
|<#pressunit>
|Unit of measure for pressure. Possible values: "mb", "hPa", "in"
|-
|<#rainunit>
|Unit of measure for rain fall. Possible values: "mm" or "inches"
|-
|<#windunit>
|Unit of measure for wind speed. Possible values: "m/s", "mph", "km/h", "kts"
|-
|<#windrununit>
|Unit of measure for wind run (distance). Possible values: "km", "miles", "km", "nm" (for wind speeds in m/s, mph, km/h, kts)
|-
|<#cloudbaseunit>
|The units used for cloudbase value. Possible values:  "ft" or "m"
|}
 
==Date & Time==
{| class="wikitable" border="1"
|-
!style="width:150px" |Web tag_name
!style="width:600px" | Function
|-
|<#date>
|The current date
|-
|<#time>
|The current time and date. Example result: 18:30 on 30 December 2009.  If you simply wish the time, use a combination of the day, month, year tags (below)
|-
|-
|<#timehhmmss>
|<#timehhmmss>
Line 342: Line 386:


==Current Conditions==
==Current Conditions==
 
These appear on "Now" page (index.htm).
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | webtag
!style="width:150px" | Web tag_name
!style="width:600px" | Function  
!style="width:600px" | Function  
|-
|-
Line 421: Line 465:
|For [[Rain_measurement#Optical_Rain_Gauge| Hydreon RG-11 devices]], shows the current rain state. 0=No rain, 1=It's raining
|For [[Rain_measurement#Optical_Rain_Gauge| Hydreon RG-11 devices]], shows the current rain state. 0=No rain, 1=It's raining
|-
|-
|colspan="2" style="background:lightgray;"|Pressure
|<#rmonth>
|The total rainfall so far this month
|n/a
|n/a
|-
|<#ryear>
|Annual rainfall total for rainfall season year (i.e. starting month as set on Configuration menu, station screen,  Annual rainfall frame)
|n/a
|n/a
|-
|colspan="2" style="background:lightgray;"|Pressure
|-
|-
|<#press>
|<#press>
Line 531: Line 585:
|}
|}


==Today==
==Extra Sensors==
 
These webtags hold current values for additional sensors supported by Cumulus. For past values, see the [[Extra_Sensor_Files]] page for information about log files.


{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | webtag
!style="width:150px"|Web tag_name
!style="width:450px" | Function
!style="width:600px"|The related description can be changed in 'strings.ini'
!style="width:150px" | Time
|-
|-
|colspan="3" style="background:lightgray;"|Temperature & Humidity
|<#ExtraTemp1>
|Extra temperature channel 1
|-
|-
|<#tempTH>
|<#ExtraTemp2>
|Today's highest temperature
|Extra temperature channel 2
|<#TtempTH>
|-
|-
|<#tempTL>
|<#ExtraTemp3>
|Today's lowest temperature
|Extra temperature channel 3
|<#TtempTL>
|-
|-
|<#avgtemp>
|colspan="2"|... and so on up to <#ExtraTemp10> = Extra temperature channel 10
|The [[Average_temperature|average]] temperature so far today
|n/a
|-
|-
|<#temprange>
|<#ExtraDP1>
|The temperature range (<#tempTH> - <#tempTL>) so far today (Cumulus calculates all these tags using Celsius values, but outputs them in your chosen units)
|Extra dew point channel 1
|n/a
|-
|-
|<#apptempTH>
|<#ExtraDP2>
|Today's high apparent temperature
|Extra dew point channel 2
|<#TapptempTH>
|-
|-
|<#apptempTL>
|<#ExtraDP3>
|Today's low apparent temperature
|Extra dew point channel 3
|<#TapptempTL>
|-
|-
|<#heatindexTH>
|colspan="2"|... and so on up to <#ExtraDP10>
|Today's high heat index
|<#TheatindexTH>
|-
|-
|<#wchillTL>
|<#ExtraHum1>
|Today's greatest wind chill (i.e. lowest temperature)
|Extra humidity channel 1
|<#TwchillTL>
|-
|-
|<#dewpointTH>
|<#ExtraHum2>
|Today's highest dew point
|Extra humidity channel 2
|<#TdewpointTH>
|-
|-
|<#dewpointTL>
|<#ExtraHum3>
|Today's lowest dew point
|Extra humidity channel 3
|<#TdewpointTL>
|-
|-
|<#humTH>
|colspan="2"|... and so on up to <#ExtraHum10>
|Today's highest humidity
|<#ThumTH>
|-
|-
|<#humTL>
|<#SoilTemp1>
|Today's lowest humidity
|Soil temperature 1
|<#ThumTL>
|-
|-
|colspan="3" style="background:lightgray;"|Rainfall
|<#SoilTemp2>
|Soil temperature 2
|-
|-
|<#rrateTM>
|colspan="2"|... and so on up to <#SoilTemp16>
|Today's maximum rain rate
|<#TrrateTM>
|-
|-
|<#hourlyrainTH>
|<#SoilMoisture1>
|Today's highest hourly rain
|Soil moisture 1
|<#ThourlyrainTH>
|-
|-
|<#RG11RainToday>
|<#SoilMoisture2>
|If you have an RG-11 rain sensor configured in "Tipping Bucket" mode, this gives today's rain total so far according to the sensor
|Soil moisture 2
|-
|-
|colspan="3" style="background:lightgray;"|Pressure
|colspan="2"|... and so on up to <#SoilMoisture16>
|-
|-
|<#pressTH>
|<#LeafTemp1>
|Today's highest pressure reading
|Leaf temperature 1
|<#TpressTH>
|-
|-
|<#pressTL>
|<#LeafTemp2>
|Today's lowest pressure reading
|Leaf temperature 2
|<#TpressTL>
|-
|-
|colspan="3" style="background:lightgray;"|Wind
|<#LeafWetness1>
|Leaf wetness 1
|-
|-
|<#windTM>
|<#LeafWetness2>
|Today's maximum (average) wind speed
|Leaf wetness 2
|<#TwindTM>
|-
|-
|<#wgustTM>  
|<#AirQuality1>
|Today's maximum wind gust
|Air quality (currently only GW1000 stations)
|<#TwgustTM>
|-
|-
|<#bearingTM>
|colspan="2"|... and so on up to <#AirQuality4>
|The wind bearing at the time of today's high gust (<#wgustTM>) in degrees
|<#TwgustTM>
|-
|-
|<#Tbeaufort>  
|<#LeakSensor1>
|Today's highest wind speed, expressed in the Beaufort scale
|Leak sensor - 0 or 1 (currently only GW1000 stations)
|<#TwindTM>
|-
|-
|<#Tbeaufortnumber>
|colspan="2"|... and so on up to <#LeakSensor4>
|Today's high wind speed on the Beaufort scale, without a leading "F", e.g. "6"
|<#TwindTM>
|-
|<#windrun>
|The total wind run so far today
|N/A
|-
|-
|<#domwindbearing>
|<#LightningDistance>
|Today's dominant wind direction in degrees
|Distance to last strike (same units as wind run - miles/km/nm)
|n/a
(currently only GW1000 stations)
|-
|-
|<#domwinddir>
|<#LightningTime>
|Today's dominant wind direction as compass point
|Time of last strike (format customisable)
|n/a
(currently only GW1000 stations)
|-
|-
|<#Tbeaudesc>
|<#LightningStrikesToday>
|Beaufort 'description' for today's high wind speed
|Number of strikes since midnight
|n/a
(currently only GW1000 stations)
|}
 
==Recent History==
 
There are a set of web tags for 'recent historical data', based on an array stored by Cumulus giving data values from 1 minute ago, up to 1 week ago, in 1 minute intervals. (Note that Cumulus uses current time read from the computer to determine which array element used. Hence when clocks go back the value stored for winter time overwrites the value previously stored for same time during summer time for the relevant repeating hour). As Cumulus runs it will add the latest values to the array with full resolution, and shift existing values along so those older than 7 days fall off. [[#No_Commas]] versions of the array are available for use in script.
 
=== Input Parameters ===
You specify which value you want from the array by using parameters on the web tags for number of days ago, hours ago, and minutes ago. For example, <#RecentOutsideTemp m=1> will give the temperature one minute ago, <#RecentOutsideTemp h=1> will give the temperature one hour ago (as will <#RecentOutsideTemp m=60>), and <#RecentOutsideTemp d=1> will give the temperature one day ago. <#RecentOutsideTemp d=1 h=1 m=1> will give the temperature one day, one hour and one minute ago. All values supplied for parameters must be whole numbers. If you don't supply any parameters, the result is undefined. (Again note that parameters specify time-stamped array element to retrieve based on counting back from current local time so the result for any period when clocks change may not be quite what you anticipated).
=== Other weather derivatives ===
Although 'Apparent Temperature' is not included as a tag, it can be [[FAQ#What_formula_does_Cumulus_use_for_Apparent_Temperature.3F | calculated]] in a script from recent 'outside temperature', 'wind speed', and 'relative humidity' values (using the same time selection for all).
=== During catch-up ===
When Cumulus is re-started the array it sets up will be based on reading the logs, so the contents will initially have a resolution according to the logger interval you have set in Cumulus and/or your station.  You'll get the nearest value if you ask for a time for which there is currently no exact match, and the first tag listed tells you that nearest time.
=== Variations between Builds/Versions ===
Before build 1098, the recent history array did not initialise correctly from the station logger for the period since Cumulus was last run.
 
The input parameters are same for Cumulus 1 and Cumulus MX, they always use lower case d, h or m.
 
=== Table of tags available ===
{| class="wikitable" border="1"
|-
|-
|colspan="3" style="background:lightgray;"|Miscellaneous
!style="width:150px" | Web tag_name
!style="width:600px" | Function
!style="width:600px" | Parameters example
|-
|-
|<#ET>
|<#RecentTS>
|Today's [http://en.wikipedia.org/wiki/Evapotranspiration evapotranspiration]. Applies only to Davis stations, equipped with a solar sensor.
|Gives the timestamp of the data that will be returned for any other recent history tag that uses same '''d, h, and m''' parameters
"The ET value provided to Cumulus by the console and/or DLL is buggy and unreliable. It often shows a negative value. See [[FAQ#It.27s_January_1st_and_my_.27rain_since_midnight.27_and.2For_.27last_24_hours_rain.27_and.2For_Evapotranspiration_are_wrong.2Fnegative|this FAQ]]."
|<#RecentTS h=3 m=1 format="HH:nn"> for cumulus 1; <#RecentTS h=3 m=1 format="HH:mm"> for cumulus MX
|N/A
|-
|-
|<#heatdegdays>
|<#RecentOutsideTemp>
|Today's [[Heat/cold_degree_days_and_Chill_hours|heating degree days]]
|Outside Temperature
|n/a
| <#RecentOutsideTemp h=3 m=1>&nbsp;<#tempunit> will display the temperature at the start of the period for which <#temptrend> is calculated
|-
|-
|<#cooldegdays>
|<#RecentWindSpeed>
|Today's [[Heat/cold_degree_days_and_Chill_hours|cooling degree days]]
|Wind Speed
|n/a
| <#RecentWindSpeed m=10> will display the wind speed 10 minutes ago
|-
|-
|<#solarTH>
|<#RecentWindGust>
|Today's high solar radiation value (Solar sensor needed)
|Wind Gust (reports maximum gust from build 1088 of version 1.9.4
|<#TsolarTH>
| <#RecentWindGust d=1 m=1> will report the wind gust at approximately the same time yesterday
|-
|-
|<#UVTH>
|<#RecentWindLatest>
|Today's high UV Index (UV sensor needed)
|Wind Latest. Note: Wind 'Speed', 'Gust' and 'Latest' have the usual Cumulus meanings
|<#TUVTH>
| d=n (where n runs 0 to 6) days ago; h=n (where n is any number of hours ago); m=n (where n is any number of minutes ago)
|-
|-
|}
|<#RecentWindDir>
 
|Wind Direction (instantaneous)
==Yesterday==
| <#RecentWindDir m=10> will tell you which direction the wind was blowing from 10 minutes ago
Note that the Y indicating yesterday is sometimes a prefix, sometimes a suffix (with H for High, L for Low), web tags are not named consistently!
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | webtag
|<#RecentWindAvgDir>
!style="width:450px" | Function
|Wind Direction (average)
!style="width:150px" | Time
|<#RecentWindAvgDir d=6> will say what the calculated average wind direction was at this time at the start of the week
|-
|-
|colspan="3" style="background:lightgray;"|Temperature & Humidity
|<#RecentWindChill>
|Wind Chill
| <#RecentWindChill d=48 m=1> reports the wind chill temperature 2 days ago
|-
|-
|<#tempYH>
|<#RecentDewPoint>
|Yesterday's highest temperature
|Dew Point
|<#TtempYH>
| <#RecentDewPoint h=25> reports the dew point temperature just over a day ago
|-
|-
|<#tempYL>
|<#RecentHeatIndex>
|Yesterday's lowest temperature
|Heat Index
|<#TtempYL>
| <#RecentHeatIndex m=121> reports the heat index about 2 hours ago
|-
|-
|<#avgtempY>
|<#RecentHumidity>
|Yesterday's average temperature
|Relative Humidity
|n/a
| d=n (where n runs 0 to 6) days ago; h=n (where n is any number of hours ago); m=n (where n is any number of minutes ago)
|-
|-
|<#temprangeY>
|<#RecentPressure>
|The temperature range (max - min) yesterday
|Sea-level Pressure
|n/a
| <#RecentPressure h=3 m=1> gives the sea level pressure when <#presstrendval> started tracking the pressure
|-
|-
|<#apptempYH>
|<#RecentRainToday>
|Yesterday's high apparent temperature
|Daily rain total from last roll-over to specified time
|<#TapptempYH>
| d=n (where n runs 0 to 6) days ago; h=n (where n is any number of hours ago); m=n (where n is any number of minutes ago)
|-
|-
|<#apptempYL>
|<#RecentSolarRad>
|Yesterday's low apparent temperature
|Solar Radiation
|<#TapptempYL>
| d=n (where n runs 0 to 6) days ago; h=n (where n is any number of hours ago); m=n (where n is any number of minutes ago)
|-
|-
|<#heatindexYH>
|<#RecentUV>
|Yesterday's high heat index
|UV Index
|<#TheatindexYH>
| d=n (where n runs 0 to 6) days ago; h=n (where n is any number of hours ago); m=n (where n is any number of minutes ago)
|}
 
==Today==
 
{| class="wikitable" border="1"
|-
|-
|<#wchillYL>
!style="width:150px" | Web tag_name
|Yesterday's greatest wind chill (i.e. lowest temperature)
!style="width:450px" | Function
|<#TwchillYL>
!style="width:150px" | Time
|-
|-
|<#dewpointYL>
|colspan="3" style="background:lightgray;"|Temperature & Humidity
|Yesterday's lowest dew point
|<#TdewpointYL>
|-
|-
|<#dewpointYH>
|<#tempTH>
|Yesterday's highest dew point
|Today's highest temperature
|<#TdewpointYH>
|<#TtempTH>
|-
|-
|<#humYH>
|<#tempTL>
|High humidity yesterday
|Today's lowest temperature
|<#ThumYH>
|<#TtempTL>
|-
|-
|<#humYL>
|<#avgtemp>
|Low humidity yesterday
|The [[Average_temperature|average]] temperature so far today
|<#ThumYL>
|-
|colspan="3" style="background:lightgray;"|Rainfall
|-
|<#rfallY>
|The total rainfall for yesterday according to the connected weather station
|n/a
|n/a
|-
|-
|<#RG11RainYest>
|<#temprange>
|The total rainfall for yesterday according to an RG-11 rain sensor configured in "Tipping Bucket" mode
|The temperature range (<#tempTH> - <#tempTL>) so far today (Cumulus calculates all these tags using Celsius values, but outputs them in your chosen units)
|n/a
|n/a
|-
|-
|<#rrateYM>
|<#apptempTH>
|Yesterday's maximum rain rate
|Today's high apparent temperature
|<#TrrateYM>
|<#TapptempTH>
|-
|-
|<#hourlyrainYH>
|<#apptempTL>
|Yesterday's highest hourly rain
|Today's low apparent temperature
|<#ThourlyrainYH>
|<#TapptempTL>
|-
|-
|colspan="3" style="background:lightgray;"|Pressure
|<#heatindexTH>
|Today's high heat index
|<#TheatindexTH>
|-
|-
|<#pressYH>
|<#wchillTL>
|Yesterday's highest pressure reading
|Today's greatest wind chill (i.e. lowest temperature)
|<#TpressYH>  
|<#TwchillTL>
|-
|-
|<#pressYL>
|<#dewpointTH>
|Yesterday's lowest pressure reading
|Today's highest dew point
|<#TpressYL>  
|<#TdewpointTH>
|-
|-
|colspan="3" style="background:lightgray;"|Wind
|<#dewpointTL>
|Today's lowest dew point
|<#TdewpointTL>
|-
|-
|<#windYM>
|<#humTH>
|Yesterday's maximum (average) wind speed
|Today's highest humidity
|<#TwindYM>
|<#ThumTH>
|-
|-
|<#wgustYM>  
|<#humTL>
|Yesterday's maximum wind gust
|Today's lowest humidity
|<#TwgustYM>
|<#ThumTL>
|-
|-
|<#bearingYM>
|colspan="3" style="background:lightgray;"|Rainfall
|The wind bearing at the time of yesterday's high gust
|<#TwgustYM>
|-
|-
|<#Ybeaufort>
|<#rrateTM>
|Yesterday's highest wind speed, expressed in the Beaufort scale
|Today's maximum rain rate
|<#TwindYM>
|<#TrrateTM>
|-
|-
|<#Ybeaufortnumber>
|<#hourlyrainTH>
|Yesterday's high wind speed on the Beaufort scale, without a leading "F", e.g. "6"
|Today's highest hourly rain
|<#TwindYM>
|<#ThourlyrainTH>
|-
|-
|<#Ybeaudesc>
|<#RG11RainToday>
|Beaufort 'description' for yesterday's high wind speed
|If you have an RG-11 rain sensor configured in "Tipping Bucket" mode, this gives today's rain total so far according to the sensor
|n/a
|-
|-
|<#domwindbearingY>
|colspan="3" style="background:lightgray;"|Pressure
|Yesterday's dominant wind direction in degrees
|n/a
|-
|-
|<#domwinddirY>
|<#pressTH>
|Yesterday's dominant wind direction as compass point
|Today's highest pressure reading
|n/a
|<#TpressTH>
|-
|-
|<#windrunY>
|<#pressTL>
|The total wind run for yesterday
|Today's lowest pressure reading
|n/a
|<#TpressTL>
|-
|-
|colspan="3" style="background:lightgray;"|Miscellaneous
|colspan="3" style="background:lightgray;"|Wind
|-
|-
|<#heatdegdaysY>
|<#windTM>
|Yesterday's [[Heat/cold_degree_days_and_Chill_hours|heating degree days]]
|Today's maximum (average) wind speed
|n/a
|<#TwindTM>
|-
|-
|<#cooldegdaysY>
|<#wgustTM>  
|Yesterday's [[Heat/cold_degree_days_and_Chill_hours|cooling degree days]]
|Today's maximum wind gust
|n/a
|<#TwgustTM>
|-
|-
|<#solarYH>
|<#bearingTM>
|Yesterday's high solar radiation value (Solar sensor needed)  
|The wind bearing at the time of today's high gust (<#wgustTM>) in degrees
|<#TsolarYH>
|<#TwgustTM>
|-
|-
|<#UVYH>
|<#Tbeaufort>  
|Yesterday's high UV Index (UV sensor needed)
|Today's highest wind speed, expressed in the Beaufort scale
|<#TUVYH>
|<#TwindTM>
|}
 
==Monthly==
The web tags in the date column output dates in the format "dd MMMM" (same for Cumulus 1 and Cumulus MX), this can be changed using the [[#Time.2FDate_.27format.27_Parameter|formats described above.
NB This table shows time of extremers for two daily figures (highest minimum/lowest maximum temperatures as of course these are actually associated with a particular time although a standard web tag was not provided for that), by including Cumulus 1.9.y time modifiers, and the slightly different way of specifying minutes in time modifiers in Cumulus MX.
{| class="wikitable" border="1"
|-
|-
!style="width:150px"|webtag
|<#Tbeaufortnumber>
!style="width:300px"|Function
|Today's high wind speed on the Beaufort scale, without a leading "F", e.g. "6"
!style="width:150px"|Time
|<#TwindTM>
!style="width:150px"|Date
|-
|<#windrun>
|The total wind run so far today
|N/A
|-
|-
|colspan="4" style="background:lightgray;"|Temperature & Humidity
|<#domwindbearing>
|Today's dominant wind direction in degrees
|n/a
|-
|-
|<#MonthTempH>
|<#domwinddir>
|This months high temperature
|Today's dominant wind direction as compass point
|<#MonthTempHT>
|n/a
|<#MonthTempHD>
|-
|-
|<#MonthTempL>
|<#Tbeaudesc>
|This months low temperature
|Beaufort 'description' for today's high wind speed
|<#MonthTempLT>
|n/a
|<#MonthTempLD>
|-
|-
|<#MonthMinTempH>
|colspan="3" style="background:lightgray;"|Miscellaneous
|This months highest daily minimum temperature
|<#MonthMinTempHD format=HH:nn> for Cumulus 1,
<#MonthMinTempHD format=HH:mm> for Cumulus MX
|<#MonthMinTempHD>
|-
|-
|<#MonthMaxTempL>
|<#ET>
|This months lowest daily maximum temperature
|Today's [http://en.wikipedia.org/wiki/Evapotranspiration evapotranspiration]. Applies only to Davis stations, equipped with a solar sensor.
|<#MonthMaxTempLD format=HH:nn>format=HH:nn> for Cumulus 1,  
"The ET value provided to Cumulus by the console and/or DLL is buggy and unreliable. It often shows a negative value. See [[FAQ#It.27s_January_1st_and_my_.27rain_since_midnight.27_and.2For_.27last_24_hours_rain.27_and.2For_Evapotranspiration_are_wrong.2Fnegative|this FAQ]]."
<#MonthMaxTempHD format=HH:mm> for Cumulus MX
|N/A
|<#MonthMaxTempLD>
|-
|-
|<#MonthHighDailyTempRange>
|<#heatdegdays>
|High Daily Temp Range
|Today's [[Heat/cold_degree_days_and_Chill_hours|heating degree days]]
|n/a
|n/a
|<#MonthHighDailyTempRangeD>
|-
|-
|<#MonthLowDailyTempRange>
|<#cooldegdays>
|Low Daily Temp Range
|Today's [[Heat/cold_degree_days_and_Chill_hours|cooling degree days]]
|n/a
|n/a
|<#MonthLowDailyTempRangeD>
|-
|-
|<#MonthHeatIndexH>
|<#solarTH>
|This months high heat index
|Today's high solar radiation value (Solar sensor needed)
|<#MonthHeatIndexHT>
|<#TsolarTH>
|<#MonthHeatIndexHD>
|-
|-
|<#MonthWChillL>
|<#UVTH>
|This months greatest wind chill (i.e. lowest temperature)
|Today's high UV Index (UV sensor needed)
|<#MonthWChillLT>
|<#TUVTH>
|<#MonthWChillLD>
|-
|-
|<#MonthAppTempH>
|}
|This months high apparent temperature
 
|<#MonthAppTempHT>
==Yesterday==
|<#MonthAppTempHD>
Note that the Y indicating yesterday is sometimes a prefix, sometimes a suffix (with H for High, L for Low), web tags are not named consistently!
{| class="wikitable" border="1"
|-
|-
|<#MonthAppTempL>
!style="width:150px" | Web tag_name
|This months low apparent temperature
!style="width:450px" | Function
|<#MonthAppTempLT>
!style="width:150px" | Time
|<#MonthAppTempLD>
|-
|-
|<#MonthDewPointH>
|colspan="3" style="background:lightgray;"|Temperature & Humidity
|This months high dew point
|<#MonthDewPointHT>
|<#MonthDewPointHD>
|-
|-
|<#MonthDewPointL>
|<#tempYH>
|This months low dew point
|Yesterday's highest temperature
|<#MonthDewPointLT>
|<#TtempYH>
|<#MonthDewPointLD>
|-
|-
|<#MonthHumH>
|<#tempYL>
|This months highest humidity
|Yesterday's lowest temperature
|<#MonthHumHT>
|<#TtempYL>
|<#MonthHumHD>
|-
|-
|<#MonthHumL>
|<#avgtempY>
|This months lowest humidity
|Yesterday's average temperature
|<#MonthHumLT>
|n/a
|<#MonthHumLD>
|-
|-
|colspan="4" style="background:lightgray;"|Pressure
|<#temprangeY>
|The temperature range (max - min) yesterday
|n/a
|-
|-
|<#MonthPressH>
|<#apptempYH>
|This months highest pressure
|Yesterday's high apparent temperature
|<#MonthPressHT>
|<#TapptempYH>
|<#MonthPressHD>
|-
|-
|<#MonthPressL>
|<#apptempYL>
|This months lowest pressure
|Yesterday's low apparent temperature
|<#MonthPressLT>
|<#TapptempYL>
|<#MonthPressLD>
|-
|-
|colspan="4" style="background:lightgray;"|Wind
|<#heatindexYH>
|Yesterday's high heat index
|<#TheatindexYH>
|-
|-
|<#MonthGustH>
|<#wchillYL>
|This months highest wind gust
|Yesterday's greatest wind chill (i.e. lowest temperature)
|<#MonthGustHT>
|<#TwchillYL>
|<#MonthGustHD>
|-
|-
|<#MonthWindH>
|<#dewpointYL>
|This months highest wind speed
|Yesterday's lowest dew point
|<#MonthWindHT>
|<#TdewpointYL>
|<#MonthWindHD>
|-
|-
|<#MonthWindRunH>
|<#dewpointYH>
|High Daily Wind Run
|Yesterday's highest dew point
|n/a
|<#TdewpointYH>
|<#MonthWindRunHD>  
|-
|-
|colspan="4" style="background:lightgray;"|Rainfall
|<#humYH>
|High humidity yesterday
|<#ThumYH>
|-
|-
|<#rmonth>
|<#humYL>
|The total rainfall so far this month
|Low humidity yesterday
|n/a
|<#ThumYL>
|n/a
|-
|-
|<#MonthRainRateH>
|colspan="3" style="background:lightgray;"|Rainfall
|This months highest rainfall rate
|<#MonthRainRateHT>
|<#MonthRainRateHD>
|-
|-
|<#MonthHourlyRainH>
|<#rfallY>
|This months highest hourly rain
|The total rainfall for yesterday according to the connected weather station
|<#MonthHourlyRainHT>
|n/a
|<#MonthHourlyRainHD>
|-
|-
|<#MonthDailyRainH>
|<#RG11RainYest>
|This months greatest daily rain
|The total rainfall for yesterday according to an RG-11 rain sensor configured in "Tipping Bucket" mode
|n/a
|n/a
|<#MonthDailyRainHD>
|-
|-
|<#MonthLongestDryPeriod>
|<#rrateYM>
|Longest dry period ending this month (days)
|Yesterday's maximum rain rate
|n/a
|<#TrrateYM>
|<#MonthLongestDryPeriodD>
|-
|-
|<#MonthLongestWetPeriod>
|<#hourlyrainYH>
|Longest period of rain every day, ending this month (days)
|Yesterday's highest hourly rain
|n/a
|<#ThourlyrainYH>
|<#MonthLongestWetPeriodD>
|}
 
==Yearly==
The default format for web tags in the date column is (like the monthly web tags) "dd MMMM" (same for Cumulus 1 and Cumulus MX), this can be changed using the [[#Time.2FDate_.27format.27_Parameter|formats described above.
NB Year runs from roll-over time on 1 January
 
(Except for <#ryear> where start date can be another month)
{| class="wikitable" border="1"
|-
|-
!style="width:150px"|webtag
|colspan="3" style="background:lightgray;"|Pressure
!style="width:300px"|Function
!style="width:150px"|Time
!style="width:150px"|Date
|-
|-
|colspan="4" style="background:lightgray;"|Temperature & Humidity
|<#pressYH>
|Yesterday's highest pressure reading
|<#TpressYH>
|-
|-
|<#YearTempH>
|<#pressYL>
|This years highest temperature
|Yesterday's lowest pressure reading
|<#YearTempHT>
|<#TpressYL>  
|<#YearTempHD>
|-
|-
|<#YearTempL>
|colspan="3" style="background:lightgray;"|Wind
|This years lowest temperature
|<#YearTempLT>
|<#YearTempLD>
|-
|-
|<#YearHighDailyTempRange>
|<#windYM>
|High Daily Temp Range
|Yesterday's maximum (average) wind speed
|n/a
|<#TwindYM>
|<#YearHighDailyTempRangeD>
|-
|-
|<#YearLowDailyTempRange>
|<#wgustYM>  
|Low Daily Temp Range
|Yesterday's maximum wind gust
|n/a
|<#TwgustYM>
|<#YearLowDailyTempRangeD>
|-
|-
|<#YearHeatIndexH>
|<#bearingYM>
|This years highest heat index
|The wind bearing at the time of yesterday's high gust
|<#YearHeatIndexHT>
|<#TwgustYM>
|<#YearHeatIndexHD>
|-
|-
|<#YearWChillL>
|<#Ybeaufort>
|This years greatest wind chill (i.e. lowest temperature)
|Yesterday's highest wind speed, expressed in the Beaufort scale
|<#YearWChillLT>
|<#TwindYM>
|<#YearWChillLD>
|-
|-
|<#YearAppTempH>
|<#Ybeaufortnumber>
|This years highest apparent temperature
|Yesterday's high wind speed on the Beaufort scale, without a leading "F", e.g. "6"
|<#YearAppTempHT>
|<#TwindYM>
|<#YearAppTempHD>
|-
|-
|<#YearAppTempL>
|<#Ybeaudesc>
|This years lowest apparent temperature
|Beaufort 'description' for yesterday's high wind speed
|<#YearAppTempLT>
|n/a
|<#YearAppTempLD>
|-
|-
|<#YearDewPointH>
|<#domwindbearingY>
|This years highest dew point
|Yesterday's dominant wind direction in degrees
|<#YearDewPointHT>
|n/a
|<#YearDewPointHD>
|-
|-
|<#YearDewPointL>
|<#domwinddirY>
|This years lowest dew point
|Yesterday's dominant wind direction as compass point
|<#YearDewPointLT>
|n/a
|<#YearDewPointLD>
|-
|-
|<#YearMinTempH>
|<#windrunY>
|This years highest daily minimum temperature
|The total wind run for yesterday
|<#YearMinTempHD format=HH:nn> for Cumulus 1, <#YearMinTempHD format=HH:mm> for Cumulus MX
|n/a
|<#YearMinTempHD>
|-
|-
|<#YearMaxTempL>
|colspan="3" style="background:lightgray;"|Miscellaneous
|This years lowest daily maximum temperature
|<#YearMaxTempHD format=HH:nn> for Cumulus 1, <#YearMaxTempHD format=HH:mm> for Cumulus MX
|<#YearMaxTempLD>
|-
|-
|<#YearHumH>
|<#heatdegdaysY>
|This years high humidity
|Yesterday's [[Heat/cold_degree_days_and_Chill_hours|heating degree days]]
|<#YearHumHT>
|n/a
|<#YearHumHD>
|-
|-
|<#YearHumL>
|<#cooldegdaysY>
|This years low humidity
|Yesterday's [[Heat/cold_degree_days_and_Chill_hours|cooling degree days]]
|<#YearHumLT>
|n/a
|<#YearHumLD>
|-
|-
|colspan="4" style="background:lightgray;"|Pressure
|<#solarYH>
|Yesterday's high solar radiation value (Solar sensor needed)
|<#TsolarYH>
|-
|-
|<#YearPressH>
|<#UVYH>
|This years high pressure
|Yesterday's high UV Index (UV sensor needed)
|<#YearPressHT>
|<#TUVYH>
|<#YearPressHD>
|}
 
==Monthly==
This table shows the web tags used on the "thismonthT.htm" web page, the rainfall this month does not appear  on that page, it is shown on [[#current|index.htm]].
 
The web tags in the date column output dates in the format "dd MMMM" (same for Cumulus 1 and Cumulus MX), this can be changed using the [[#Time.2FDate_.27format.27_Parameter|formats described above.
 
NB This table shows time of extremes for two daily figures (highest minimum/lowest maximum temperatures as of course these are actually associated with a particular time although a standard web tag was not provided for that), by including Cumulus 1.9.y time modifiers, and the slightly different way of specifying minutes in time modifiers in Cumulus MX.
{| class="wikitable" border="1"
|-
|-
|<#YearPressL>
!style="width:150px"|Web tag_name
|This years low pressure
!style="width:300px"|Function
|<#YearPressLT>
!style="width:150px"|Time
|<#YearPressLD>
!style="width:150px"|Date
|-
|-
|colspan="4" style="background:lightgray;"|Wind
|colspan="4" style="background:lightgray;"|Temperature & Humidity
|-
|-
|<#YearGustH>
|<#MonthTempH>
|This years high wind gust
|This months high temperature
|<#YearGustHT>
|<#MonthTempHT>
|<#YearGustHD>
|<#MonthTempHD>
|-
|-
|<#YearWindH>
|<#MonthTempL>
|This years high wind speed
|This months low temperature
|<#YearWindHT>
|<#MonthTempLT>
|<#YearWindHD>
|<#MonthTempLD>
|-
|-
|<#YearWindRunH>
|<#MonthMinTempH>
|High Daily Wind Run
|This months highest daily minimum temperature
|n/a
|<#MonthMinTempHD format=HH:nn> for Cumulus 1,
|<#YearWindRunHD>  
<#MonthMinTempHD format=HH:mm> for Cumulus MX
|<#MonthMinTempHD>
|-
|-
|colspan="4" style="background:lightgray;"|Rainfall
|<#MonthMaxTempL>
|This months lowest daily maximum temperature
|<#MonthMaxTempLD format=HH:nn>format=HH:nn> for Cumulus 1,
<#MonthMaxTempHD format=HH:mm> for Cumulus MX
|<#MonthMaxTempLD>
|-
|-
|<#ryear>
|<#MonthHighDailyTempRange>
|Annual rainfall total for rainfall season year (i.e. starting month as set on Configuration menu, station screen,  Annual rainfall frame)
|High Daily Temp Range
|n/a
|n/a
|n/a
|<#MonthHighDailyTempRangeD>
|-
|-
|<#YearRainRateH>
|<#MonthLowDailyTempRange>
|This years high rainfall rate
|Low Daily Temp Range
|<#YearRainRateHT>
|n/a
|<#YearRainRateHD>
|<#MonthLowDailyTempRangeD>
|-
|-
|<#YearHourlyRainH>
|<#MonthHeatIndexH>
|This years high hourly rain
|This months high heat index
|<#YearHourlyRainHT>
|<#MonthHeatIndexHT>
|<#YearHourlyRainHD>
|<#MonthHeatIndexHD>
|-
|-
|<#YearDailyRainH>
|<#MonthWChillL>
|This years high daily rain
|This months greatest wind chill (i.e. lowest temperature)
|n/a
|<#MonthWChillLT>
|<#YearDailyRainHD>
|<#MonthWChillLD>
|-
|-
|<#YearMonthlyRainH>
|<#MonthAppTempH>
|This years high monthly rain
|This months high apparent temperature
|n/a
|<#MonthAppTempHT>
|<#YearMonthlyRainHD>
|<#MonthAppTempHD>
|-
|<#YearLongestDryPeriod>
|Longest period without rain ending this year (days)
|n/a
|<#YearLongestDryPeriodD>
|-
|-
|<#YearLongestWetPeriod>
|<#MonthAppTempL>
|Longest period of rain every day ending this year (days)
|This months low apparent temperature
|n/a
|<#MonthAppTempLT>
|<#YearLongestWetPeriodD>
|<#MonthAppTempLD>
|}
 
==All Time==
The web tags in the date/time column have the default format seen on "records.htm". So for an extreme month it just shows the month name in full i.e. format 'MMMM'. For an extreme day it shows the day of the month and the month name in full i.e. format "dd MMMM" (same for Cumulus 1 and Cumulus MX), prefixed with the word 'on'. For the highest/lowest within a day in the year it shows both time and date adding the word "at" before the time, and the word 'on' before the date.
 
You can change the default output using the [[#Time.2FDate_.27format.27_Parameter|formats features described above, but this can involve complicated use of single and double quotes and there are differences between Cumulus 1 and Cumulus MX.
 
Note that unlike the monthly web tags, the time is included in the default format of the standard web tags for the 'highest minimum' and 'lowest maximum'.
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | webtag
|<#MonthDewPointH>
!style="width:300px" | Function
|This months high dew point
!style="width:150px" | Date/Time
|<#MonthDewPointHT>
|<#MonthDewPointHD>
|-
|-
|colspan="3" style="background:lightgray;"|Temperature & Humidity
|<#MonthDewPointL>
|This months low dew point
|<#MonthDewPointLT>
|<#MonthDewPointLD>
|-
|-
|<#tempH>
|<#MonthHumH>
|All time high temperature
|This months highest humidity
|<#TtempH>
|<#MonthHumHT>
|<#MonthHumHD>
|-
|-
|<#tempL>
|<#MonthHumL>
|All time low temperature
|This months lowest humidity
|<#TtempL>
|<#MonthHumLT>
|<#MonthHumLD>
|-
|-
|<#mintempH>
|colspan="4" style="background:lightgray;"|Pressure
|All time high minimum temperature
|<#TmintempH>
|-
|-
|<#maxtempL>
|<#MonthPressH>
|All time low maximum temperature
|This months highest pressure
|<#TmaxtempL>
|<#MonthPressHT>
|<#MonthPressHD>
|-
|-
|<#LowDailyTempRange>
|<#MonthPressL>
|All time low daily temperature range
|This months lowest pressure
|<#TLowDailyTempRange>
|<#MonthPressLT>
|<#MonthPressLD>
|-
|-
|<#HighDailyTempRange>
|colspan="4" style="background:lightgray;"|Wind
|All time high daily temperature range
|<#THighDailyTempRange>
|-
|-
|<#apptempH>
|<#MonthGustH>
|All time high apparent temperature
|This months highest wind gust
|<#TapptempH>
|<#MonthGustHT>
|<#MonthGustHD>
|-
|-
|<#apptempL>
|<#MonthWindH>
|All time low apparent temperature
|This months highest wind speed
|<#TapptempL>
|<#MonthWindHT>
|<#MonthWindHD>
|-
|-
|<#heatindexH>
|<#MonthWindRunH>
|All time high heat index
|High Daily Wind Run
|<#TheatindexH>
|n/a
|<#MonthWindRunHD>  
|-
|-
|<#dewpointH>
|colspan="4" style="background:lightgray;"|Rainfall
|All time high dew point
|<#TdewpointH>
|-
|-
|<#dewpointL>
|<#MonthRainRateH>
|All time low dew point
|This months highest rainfall rate
|<#TdewpointL>
|<#MonthRainRateHT>
|<#MonthRainRateHD>
|-
|-
|<#humH>
|<#MonthHourlyRainH>
|All time high humidity
|This months highest hourly rain
|<#ThumH>
|<#MonthHourlyRainHT>
|<#MonthHourlyRainHD>
|-
|-
|<#humL>
|<#MonthDailyRainH>
|All time low humidity
|This months greatest daily rain
|<#ThumL>
|n/a
|<#MonthDailyRainHD>
|-
|<#MonthLongestDryPeriod>
|Longest dry period ending this month (days)
|n/a
|<#MonthLongestDryPeriodD>
|-
|-
|<#wchillH>
|<#MonthLongestWetPeriod>
|All time greatest wind chill (i.e. lowest temperature)  
|Longest period of rain every day, ending this month (days)
|<#TwchillH>
|n/a
|<#MonthLongestWetPeriodD>
|}
 
==Yearly==
The default format for web tags in the date column is (like the monthly web tags) "dd MMMM" (same for Cumulus 1 and Cumulus MX), this can be changed using the [[#Time.2FDate_.27format.27_Parameter|formats described above.
NB Year runs from roll-over time on 1 January for all web tags listed here
 
 
{| class="wikitable" border="1"
|-
|-
|colspan="3" style="background:lightgray;"|Rainfall
!style="width:150px"|Web tag_name
!style="width:300px"|Function
!style="width:150px"|Time
!style="width:150px"|Date
|-
|-
|<#rrateM>
|colspan="4" style="background:lightgray;"|Temperature & Humidity
|All time high rain rate
|<#TrrateM>
|-
|-
|<#rfallH>
|<#YearTempH>
|All time high daily rain
|This years highest temperature
|<#TrfallH>
|<#YearTempHT>
|<#YearTempHD>
|-
|-
|<#rfallhH>
|<#YearTempL>
|All time high hourly rain
|This years lowest temperature
|<#TrfallhH>
|<#YearTempLT>
|<#YearTempLD>
|-
|-
|<#rfallmH>
|<#YearHighDailyTempRange>
|All time high monthly rain
|High Daily Temp Range
|<#TrfallmH>
|n/a
|<#YearHighDailyTempRangeD>
|-
|-
|<#LongestDryPeriod>
|<#YearLowDailyTempRange>
|All time longest dry period (days)
|Low Daily Temp Range
|<#TLongestDryPeriod>
|n/a
|<#YearLowDailyTempRangeD>
|-
|-
|<#LongestWetPeriod>
|<#YearHeatIndexH>
|All time longest wet period (days)
|This years highest heat index
|<#TLongestWetPeriod>
|<#YearHeatIndexHT>
|<#YearHeatIndexHD>
|-
|-
|colspan="3" style="background:lightgray;"|Pressure
|<#YearWChillL>
|This years greatest wind chill (i.e. lowest temperature)
|<#YearWChillLT>
|<#YearWChillLD>
|-
|-
|<#pressH>
|<#YearAppTempH>
|All time high pressure
|This years highest apparent temperature
|<#TpressH>
|<#YearAppTempHT>
|<#YearAppTempHD>
|-
|-
|<#pressL>
|<#YearAppTempL>
|All time low pressure
|This years lowest apparent temperature
|<#TpressL>
|<#YearAppTempLT>
|<#YearAppTempLD>
|-
|-
|colspan="3" style="background:lightgray;"|Wind
|<#YearDewPointH>
|This years highest dew point
|<#YearDewPointHT>
|<#YearDewPointHD>
|-
|-
|<#gustM>
|<#YearDewPointL>
|All time high wind gust
|This years lowest dew point
|<#TgustM>
|<#YearDewPointLT>
|<#YearDewPointLD>
|-
|<#YearMinTempH>
|This years highest daily minimum temperature
|<#YearMinTempHD format=HH:nn> for Cumulus 1, <#YearMinTempHD format=HH:mm> for Cumulus MX
|<#YearMinTempHD>
|-
|-
|<#wspeedH>
|<#YearMaxTempL>
|All time high average wind speed
|This years lowest daily maximum temperature
|<#TwspeedH>
|<#YearMaxTempHD format=HH:nn> for Cumulus 1, <#YearMaxTempHD format=HH:mm> for Cumulus MX
|<#YearMaxTempLD>
|-
|-
|<#windrunH>
|<#YearHumH>
|All time high daily wind run
|This years high humidity
|<#TwindrunH>
|<#YearHumHT>
|}
|<#YearHumHD>
 
==Recent History==
 
There are a set of web tags for 'recent historical data', based on an array stored by Cumulus giving data values from 1 minute ago, up to 1 week ago, in 1 minute intervals. (Note that Cumulus uses current time read from the computer to determine which array element used. Hence when clocks go back the value stored for winter time overwrites the value previously stored for same time during summer time for the relevant repeating hour). As Cumulus runs it will add the latest values to the array with full resolution, and shift existing values along so those older than 7 days fall off. [[#No_Commas]] versions of the array are available for use in script.
 
=== Input Parameters ===
You specify which value you want from the array by using parameters on the web tags for number of days ago, hours ago, and minutes ago. For example, <#RecentOutsideTemp m=1> will give the temperature one minute ago, <#RecentOutsideTemp h=1> will give the temperature one hour ago (as will <#RecentOutsideTemp m=60>), and <#RecentOutsideTemp d=1> will give the temperature one day ago. <#RecentOutsideTemp d=1 h=1 m=1> will give the temperature one day, one hour and one minute ago. All values supplied for parameters must be whole numbers. If you don't supply any parameters, the result is undefined. (Again note that parameters specify time-stamped array element to retrieve based on counting back from current local time so the result for any period when clocks change may not be quite what you anticipated).
=== Other weather derivatives ===
Although 'Apparent Temperature' is not included as a tag, it can be [[FAQ#What_formula_does_Cumulus_use_for_Apparent_Temperature.3F | calculated]] in a script from recent 'outside temperature', 'wind speed', and 'relative humidity' values (using the same time selection for all).
=== During catch-up ===
When Cumulus is re-started the array it sets up will be based on reading the logs, so the contents will initially have a resolution according to the logger interval you have set in Cumulus and/or your station.  You'll get the nearest value if you ask for a time for which there is currently no exact match, and the first tag listed tells you that nearest time.
=== Variations between Builds/Versions ===
Before build 1098, the recent history array did not initialise correctly from the station logger for the period since Cumulus was last run.
 
The input parameters are same for Cumulus 1 and Cumulus MX, they always use lower case d, h or m.
 
=== Table of tags available ===
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | webtag
|<#YearHumL>
!style="width:600px" | Function
|This years low humidity
!style="width:600px" | Parameters example
|<#YearHumLT>
|<#YearHumLD>
|-
|-
|<#RecentTS>
|colspan="4" style="background:lightgray;"|Pressure
|Gives the timestamp of the data that will be returned for any other recent history tag that uses same '''d, h, and m''' parameters
|<#RecentTS h=3 m=1 format="HH:nn"> for cumulus 1; <#RecentTS h=3 m=1 format="HH:mm"> for cumulus MX
|-
|-
|<#RecentOutsideTemp>
|<#YearPressH>
|Outside Temperature
|This years high pressure
| <#RecentOutsideTemp h=3 m=1>&nbsp;<#tempunit> will display the temperature at the start of the period for which <#temptrend> is calculated
|<#YearPressHT>
|<#YearPressHD>
|-
|-
|<#RecentWindSpeed>
|<#YearPressL>
|Wind Speed
|This years low pressure
| <#RecentWindSpeed m=10> will display the wind speed 10 minutes ago
|<#YearPressLT>
|<#YearPressLD>
|-
|-
|<#RecentWindGust>
|colspan="4" style="background:lightgray;"|Wind
|Wind Gust (reports maximum gust from build 1088 of version 1.9.4
| <#RecentWindGust d=1 m=1> will report the wind gust at approximately the same time yesterday
|-
|-
|<#RecentWindLatest>
|<#YearGustH>
|Wind Latest. Note: Wind 'Speed', 'Gust' and 'Latest' have the usual Cumulus meanings
|This years high wind gust
| d=n (where n runs 0 to 6) days ago; h=n (where n is any number of hours ago); m=n (where n is any number of minutes ago)
|<#YearGustHT>
|<#YearGustHD>
|-
|-
|<#RecentWindDir>
|<#YearWindH>
|Wind Direction (instantaneous)
|This years high wind speed
| <#RecentWindDir m=10> will tell you which direction the wind was blowing from 10 minutes ago
|<#YearWindHT>
|<#YearWindHD>
|-
|-
|<#RecentWindAvgDir>
|<#YearWindRunH>
|Wind Direction (average)
|High Daily Wind Run
|<#RecentWindAvgDir d=6> will say what the calculated average wind direction was at this time at the start of the week
|n/a
|<#YearWindRunHD>  
|-
|-
|<#RecentWindChill>
|colspan="4" style="background:lightgray;"|Rainfall
|Wind Chill
| <#RecentWindChill d=48 m=1> reports the wind chill temperature 2 days ago
|-
|-
|<#RecentDewPoint>
|<#YearRainRateH>
|Dew Point
|This years high rainfall rate
| <#RecentDewPoint h=25> reports the dew point temperature just over a day ago
|<#YearRainRateHT>
|<#YearRainRateHD>
|-
|-
|<#RecentHeatIndex>
|<#YearHourlyRainH>
|Heat Index
|This years high hourly rain
| <#RecentHeatIndex m=121> reports the heat index about 2 hours ago
|<#YearHourlyRainHT>
|<#YearHourlyRainHD>
|-
|-
|<#RecentHumidity>
|<#YearDailyRainH>
|Relative Humidity
|This years high daily rain
| d=n (where n runs 0 to 6) days ago; h=n (where n is any number of hours ago); m=n (where n is any number of minutes ago)
|n/a
|<#YearDailyRainHD>
|-
|-
|<#RecentPressure>
|<#YearMonthlyRainH>
|Sea-level Pressure
|This years high monthly rain
| <#RecentPressure h=3 m=1> gives the sea level pressure when <#presstrendval> started tracking the pressure
|n/a
|<#YearMonthlyRainHD>
|-
|-
|<#RecentRainToday>
|<#YearLongestDryPeriod>
|Daily rain total from last roll-over to specified time
|Longest period without rain ending this year (days)
| d=n (where n runs 0 to 6) days ago; h=n (where n is any number of hours ago); m=n (where n is any number of minutes ago)
|n/a
|<#YearLongestDryPeriodD>
|-
|-
|<#RecentSolarRad>
|<#YearLongestWetPeriod>
|Solar Radiation
|Longest period of rain every day ending this year (days)
| d=n (where n runs 0 to 6) days ago; h=n (where n is any number of hours ago); m=n (where n is any number of minutes ago)
|n/a
|-
|<#YearLongestWetPeriodD>
|<#RecentUV>
|UV Index
| d=n (where n runs 0 to 6) days ago; h=n (where n is any number of hours ago); m=n (where n is any number of minutes ago)
|}
|}


==Monthly All Time Records==
==All Time==
 
The web tags in the date/time column have the default format seen on "records.htm". So for an extreme month it just shows the month name in full i.e. format 'MMMM'. For an extreme day it shows the day of the month and the month name in full i.e. format "dd MMMM" (same for Cumulus 1 and Cumulus MX), prefixed with the word 'on'. For the highest/lowest within a day in the year it shows both time and date adding the word "at" before the time, and the word 'on' before the date.
There are a set of tags for monthly all-time highs and lows, in other words the highest and lowest values for a particular month of the year. For example, the highest ever temperature in July. Each Value tag has an optional parameter "mon=N" where N is the index of the month of the year that you want the value for (January=1 and so on). For example, <#ByMonthTempH mon=7> will give you the highest ever temperature in July.
 
If you don't supply a parameter (or supply an invalid value) the current month will be used. You can customise the date and time formats using the 'format' parameter on the web tag, see below. To supply more than one parameter, separate them with spaces, e.g. <#ByMonthTempHT mon=7 format=hh:nn>


You can change the default output using the [[#Time.2FDate_.27format.27_Parameter|formats features described above, but this can involve complicated use of single and double quotes and there are differences between Cumulus 1 and Cumulus MX.


Note that unlike the monthly web tags, the time is included in the default format of the standard web tags for the 'highest minimum' and 'lowest maximum'.
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
!style="width:150px"|webtag
!style="width:150px" | Web tag_name
!style="width:300px"|Function
!style="width:300px" | Function
!style="width:150px"|Date/Time
!style="width:150px" | Date/Time
|-
|-
|colspan="3" style="background:lightgray;"|Temperature & Humidity
|colspan="3" style="background:lightgray;"|Temperature & Humidity
|-
|-
|<#ByMonthTempH>
|<#tempH>
|High Temperature
|All time high temperature
|<#ByMonthTempHT>
|<#TtempH>
|-
|-
|<#ByMonthTempL>
|<#tempL>
|Low Temperature
|All time low temperature
|<#ByMonthTempLT>
|<#TtempL>
|-
|-
|<#ByMonthHeatIndexH>
|<#mintempH>
|High Heat Index
|All time high minimum temperature
|<#ByMonthHeatIndexHT>
|<#TmintempH>
|-
|-
|<#ByMonthWChillL>
|<#maxtempL>
|Greatest wind chill (i.e. lowest temperature)
|All time low maximum temperature  
|<#ByMonthWChillLT>
|<#TmaxtempL>
|-
|-
|<#ByMonthAppTempH>
|<#LowDailyTempRange>
|High Apparent Temperature
|All time low daily temperature range
|<#ByMonthAppTempHT>
|<#TLowDailyTempRange>
|-
|-
|<#ByMonthAppTempL>
|<#HighDailyTempRange>
|Low Apparent Temperature
|All time high daily temperature range
|<#ByMonthAppTempLT>
|<#THighDailyTempRange>
|-
|-
|<#ByMonthDewPointH>
|<#apptempH>
|High Dew Point
|All time high apparent temperature
|<#ByMonthDewPointHT>
|<#TapptempH>
|-
|-
|<#ByMonthDewPointL>
|<#apptempL>
|Low Dew Point
|All time low apparent temperature
|<#ByMonthDewPointLT>
|<#TapptempL>
|-
|-
|<#ByMonthMinTempH>
|<#heatindexH>
|Highest Daily Minimum Temperature
|All time high heat index
|<#ByMonthMinTempHT>
|<#TheatindexH>
|-
|-
|<#ByMonthMaxTempL>
|<#dewpointH>
|Lowest Daily Maximum Temperature
|All time high dew point
|<#ByMonthMaxTempLT>
|<#TdewpointH>
|-
|-
|<#ByMonthHighDailyTempRange>
|<#dewpointL>
|High Daily Temp Range
|All time low dew point
|<#ByMonthHighDailyTempRangeT>  
|<#TdewpointL>
|-
|-
|<#ByMonthLowDailyTempRange>
|<#humH>
|Low Daily Temp Range
|All time high humidity
|<#ByMonthLowDailyTempRangeT>
|<#ThumH>
|-
|-
|<#ByMonthHumH>
|<#humL>
|High Humidity
|All time low humidity
|<#ByMonthHumHT>
|<#ThumL>
|-
|-
|<#ByMonthHumL>
|<#wchillH>
|Low Humidity
|All time greatest wind chill (i.e. lowest temperature)
|<#ByMonthHumLT>  
|<#TwchillH>
|-
|-
|colspan="4" style="background:lightgray;"|Pressure
|colspan="3" style="background:lightgray;"|Rainfall
|-
|-
|<#ByMonthPressH>
|<#rrateM>
|High Pressure
|All time high rain rate
|<#ByMonthPressHT>
|<#TrrateM>
|-
|-
|<#ByMonthPressL>
|<#rfallH>
|Low Pressure
|All time high daily rain
|<#ByMonthPressLT>
|<#TrfallH>
|-
|-
|colspan="4" style="background:lightgray;"|Wind
|<#rfallhH>
|All time high hourly rain
|<#TrfallhH>
|-
|-
|<#ByMonthGustH>
|<#rfallmH>
|High Wind Gust
|All time high monthly rain
|<#ByMonthGustHT>
|<#TrfallmH>
|-
|-
|<#ByMonthWindH>
|<#LongestDryPeriod>
|High Wind Speed
|All time longest dry period (days)
|<#ByMonthWindHT>
|<#TLongestDryPeriod>
|-
|-
|<#ByMonthWindRunH>
|<#LongestWetPeriod>
|High Daily Wind Run
|All time longest wet period (days)
|<#ByMonthWindRunHT>
|<#TLongestWetPeriod>
|-
|-
|colspan="4" style="background:lightgray;"|Rainfall
|colspan="3" style="background:lightgray;"|Pressure
|-
|-
|<#ByMonthRainRateH>
|<#pressH>
|High Rain Rate
|All time high pressure
|<#ByMonthRainRateHT>
|<#TpressH>
|-
|-
|<#ByMonthMonthlyRainH>
|<#pressL>
|High Monthly Rainfall
|All time low pressure
|<#ByMonthMonthlyRainHT>
|<#TpressL>
|-
|-
|<#ByMonthHourlyRainH>
|colspan="3" style="background:lightgray;"|Wind
|High Hourly Rain
|<#ByMonthHourlyRainHT>
|-
|-
|<#ByMonthDailyRainH>
|<#gustM>
|High Daily Rain
|All time high wind gust
|<#ByMonthDailyRainHT>
|<#TgustM>
|-
|-
|<#ByMonthLongestDryPeriod>
|<#wspeedH>
|Longest Dry Period
|All time high average wind speed
|<#ByMonthLongestDryPeriodT>
|<#TwspeedH>
|-
|-
|<#ByMonthLongestWetPeriod>
|<#windrunH>
|Longest Wet Period
|All time high daily wind run
|<#ByMonthLongestWetPeriodT>
|<#TwindrunH>
|}
|}


==Miscellaneous==
==Monthly All Time Records==
 
There are a set of tags for monthly all-time highs and lows, in other words the highest and lowest values for a particular month of the year. For example, the highest ever temperature in July. Each Value tag has an optional parameter "mon=N" where N is the index of the month of the year that you want the value for (January=1 and so on). For example, <#ByMonthTempH mon=7> will give you the highest ever temperature in July.


{| class="wikitable" border="1"
If you don't supply a parameter (or supply an invalid value) the current month will be used. You can customise the date and time formats using the 'format' parameter on the web tag, see below. To supply more than one parameter, separate them with spaces, e.g. <#ByMonthTempHT mon=7 format=hh:nn>
|-
 
!style="width:150px" |webtag
 
!style="width:600px" | Function
{| class="wikitable" border="1"
|-
|-
|<#LatestError>
!style="width:150px"|Web tag_name
|Displays the last error from the Cumulus error log. (The value is cleared when you click the error light in Cumulus 1).<br />
!style="width:300px"|Function
Note: This tag displays ''all'' errors, even if they do not cause the error light to flash in Cumulus 1.
!style="width:150px"|Date/Time
|-
|-
|<#LatestErrorDate>
|colspan="3" style="background:lightgray;"|Temperature & Humidity
|The date of the latest error logged to the error log window, using the system short date format. Gives dashes when latest error is reset
|-
|-
|<#LatestErrorTime>
|<#ByMonthTempH>
|The time of the latest error logged to the error log window, using the system short time format. Gives dashes when latest error is reset
|High Temperature
|<#ByMonthTempHT>
|-
|-
|<#ErrorLight>
|<#ByMonthTempL>
|1 if the 'error' light is flashing, 0 if not
|Low Temperature
|<#ByMonthTempLT>
|-
|-
|<#version>
|<#ByMonthHeatIndexH>
|The version of Cumulus in use e.g. '1.9.4' or '3.4.1'
|High Heat Index
|<#ByMonthHeatIndexHT>
|-
|-
|<#build>
|<#ByMonthWChillL>
|The build of Cumulus in use e.g. '10992' for latest Cumulus 1 patch (Cumulus MX is under development so new builds are released frequently)
|Greatest wind chill (i.e. lowest temperature)
 
|<#ByMonthWChillLT>
|-
|-
|<#realtimeinterval>
|<#ByMonthAppTempH>
|The realtime update interval in seconds (integer)
|High Apparent Temperature
|<#ByMonthAppTempHT>
|-
|-
|<#interval>
|<#ByMonthAppTempL>
|The web site update interval in minutes (integer)
|Low Apparent Temperature
|<#ByMonthAppTempLT>
|-
|-
|<#rollovertime>
|<#ByMonthDewPointH>
|The time that the logs rollover to the next day: 'Midnight', '9 am' or '10 am'
|High Dew Point
|<#ByMonthDewPointHT>
|-
|-
|<#update>
|<#ByMonthDewPointL>
|The date and time of the last web site update
|Low Dew Point
|<#ByMonthDewPointLT>
|-
|-
|<#LastDataReadT>
|<#ByMonthMinTempH>
|The date/time data was last read from the station
|Highest Daily Minimum Temperature
|<#ByMonthMinTempHT>
|-
|-
|<#stationtype>
|<#ByMonthMaxTempL>
|The weather station [https://cumuluswiki.wxforum.net/a/Cumulus.ini#Section:_Station model] description (you choose what text appears for this on 'Display' settings screen within Configuration menu - the field is at the bottom left of that screen).
|Lowest Daily Maximum Temperature
|<#ByMonthMaxTempLT>
|-
|-
|<#latitude>
|<#ByMonthHighDailyTempRange>
|The station [http://en.wikipedia.org/wiki/Latitude latitude] (as you entered during setup).
|High Daily Temp Range
Supports an optional 'dp' parameter, if supplied, instead of the usual web-encoded text format with degrees/minutes/seconds, the result is in decimal degrees to the specified number of decimal places. E.g<br />
|<#ByMonthHighDailyTempRangeT>  
<#latitude> gives "N&nbsp;59& deg;&amp;nbsp;14&amp;#39;&amp;nbsp;33&amp;quot;" for N 59 14 33<br />
<#latitude dp=5> gives "59.24250"
 
If the "dp" parameter is supplied, then supplying "rc=y" in addition will cause any decimal comma to be converted to a decimal point.
|-
|-
|<#longitude>
|<#ByMonthLowDailyTempRange>
|The station [http://en.wikipedia.org/wiki/Longitude longitude]  (as you entered during setup). Supports an optional 'dp' and 'rc' parameters as per the latitude tag.
|Low Daily Temp Range
|<#ByMonthLowDailyTempRangeT>
|-
|-
|<#altitude>
|<#ByMonthHumH>
|The station [http://en.wikipedia.org/wiki/Altitude altitude] value (webtag outputs web encoded format containing figure, '&amp;nbsp;' and units) in either feet or metres just as you entered during setup (so it is more complex to extract number for script arithmetric); e.g. '123&amp;nbsp;m'
|High Humidity
|<#ByMonthHumHT>
|-
|-
|<#location>
|<#ByMonthHumL>
|The station location (as you entered during setup)
|Low Humidity
|<#ByMonthHumLT>
|-
|-
|<#longlocation>
|colspan="4" style="background:lightgray;"|Pressure
|Longer description of the station location (as you entered during setup)
|-
|-
|<#forum>
|<#ByMonthPressH>
|URL of the forum (as you entered during setup)
|High Pressure
|<#ByMonthPressHT>
|-
|-
|<#webcam>
|<#ByMonthPressL>
|URL of the webcam (as you entered during setup)
|Low Pressure
|<#ByMonthPressLT>
|-
|-
|<#graphperiod>
|colspan="4" style="background:lightgray;"|Wind
|The number of hours displayed by the graphs, as set using '''Configuration''' menu, ''Display'' settings screen 'Detailed Chart Period'
|-
|-
|<#dailygraphperiod>
|<#ByMonthGustH>
|The number of days displayed by the graphs, as set using '''Configuration''' menu, ''Display'' settings screen 'Daily Chart Period' (available from build 1098)
|High Wind Gust
|<#ByMonthGustHT>
|-
|-
|<#snowdepth>
|<#ByMonthWindH>
|Today's snow depth as entered manually in the Weather Diary (not available in Cumulus MX), see Cumulus 'Help'. Meteorologists express it in Centimeters, but Cumulus 1 does not care what units you use. Output is purely as a numerical integer (e.g. 10).
|High Wind Speed
Configure in [[Cumulus.ini]] the hour when the snowdepth is updated e.g. ''SnowDepthHour=9'' means yesterday's figure applies until 9am.
|<#ByMonthWindHT>
|-
|-
|<#currcond>
|<#ByMonthWindRunH>
|Represents the value entered on the screen within Cumulus for the Current Weather condition, or the value as held in the [[currentconditions.txt]] file. Any reserved HTML characters are encoded as HTML entities
|High Daily Wind Run
|<#ByMonthWindRunHT>
|-
|-
|<#currcondenc>
|colspan="4" style="background:lightgray;"|Rainfall
|The same as <#currcond> but also has all characters above (decimal base)code 159 encoded as HTML entities
|-
|-
|<#chillhours>
|<#ByMonthRainRateH>
|The number of [[Heat/cold_degree_days_and_Chill_hours#Chill_Hours_and.2For_Air_Frost|'chill hours']] so far this season (threshold temperature and start date are configurable).
|High Rain Rate
|<#ByMonthRainRateHT>
|-
|-
|<#ConsecutiveRainDays>
|<#ByMonthMonthlyRainH>
|The number of days up to (but not including) today where it has rained every day. The threshold amount of rain required to determine a rain day is configurable via the RainDayThreshold setting in cumulus.ini, the units for the threshold are the same as your rain units, meteorologists exclude dew (and other times when single tip of recorder).
|High Monthly Rainfall
|<#ByMonthMonthlyRainHT>
|-
|-
|<#ConsecutiveDryDays>
|<#ByMonthHourlyRainH>
|The number of days up to (but not including) today since it last rained. The threshold amount of rain required to determine a rain day is configurable via the RainDayThreshold setting in cumulus.ini the units for the threshold are the same as your rain units
|High Hourly Rain
|<#ByMonthHourlyRainHT>
|-
|-
|<#WindRoseData>
|<#ByMonthDailyRainH>
|A comma-separated list of the wind 'totals' used to draw the wind rose (8 or 16 values)
|High Daily Rain
|<#ByMonthDailyRainHT>
|-
|-
|<#WindRosePoints>
|<#ByMonthLongestDryPeriod>
|The number of items in <#WindRoseData> (i.e. 8 or 16)
|Longest Dry Period
|<#ByMonthLongestDryPeriodT>
|-
|-
|<#WindSampleCount>
|<#ByMonthLongestWetPeriod>
|The number of wind samples making up the wind rose (etc) data (up to 3600)
|Longest Wet Period
|-
|<#ByMonthLongestWetPeriodT>
|<#LatestNOAAMonthlyReport>
|Gives file name of latest auto-saved NOAA monthly report
|-
|<#LatestNOAAYearlyReport>
|Gives file name of latest auto-saved NOAA yearly report
|}
|}


==Day/Night/Sun/Moon==
==Miscellaneous==
These are updated each hour to refer to current time-zone
 
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | webtag
!style="width:150px" |Web tag_name
!style="width:600px" | Function
!style="width:600px" | Function
|-
|-
|<#sunrise>
|<#LatestError>
|Last sunrise time at the station - This sunrise time is calculated by a third party library each midnight UTC, and each hour Cumulus converts it to local time to ensure shown correctly before and after any clock change.
|Displays the last error from the Cumulus error log. (The value is cleared when you click the error light in Cumulus 1).<br />
Note: This tag displays ''all'' errors, even if they do not cause the error light to flash in Cumulus 1.
|-
|-
|<#sunset>
|<#LatestErrorDate>
|Next sunset time at the station - The sunset/sunrise times are calculated each midnight UTC, and each hour Cumulus converts them to local time to ensure it shows them correctly before and after any clock change.
|The date of the latest error logged to the error log window, using the system short date format. Gives dashes when latest error is reset
|-
|-
|<#daylength>
|<#LatestErrorTime>
|Length of day in hours and minutes (sunrise to sunset) - The third party library that Cumulus uses each midnight UTC, may take last sunrise from previous day and next sunset from next day, so the calculation may be off by a minute or so compared to true figure for current day.
|The time of the latest error logged to the error log window, using the system short time format. Gives dashes when latest error is reset
|-
|<#ErrorLight>
|1 if the 'error' light is flashing, 0 if not
|-
|<#version>
|The version of Cumulus in use e.g. '1.9.4' or '3.4.1'
|-
|-
|<#IsSunUp>
|<#build>
|A flag to indicate if the Sun is above the horizon or not, based on the sunrise and sunset times.
|The build of Cumulus in use e.g. '10992' for latest Cumulus 1 patch (Cumulus MX is under development so new builds are released frequently)


Possible values are 0 or 1, where 1 is when the Sun is above the horizon for the station location.
|-
|-
|<#dawn>
|<#realtimeinterval>
|Start of last Civil Twilight at the station as at last midnight UTC
|The realtime update interval in seconds (integer)
|-
|-
|<#dusk>
|<#interval>
|End of next Civil Twilight at the station as at last midnight UTC
|The web site update interval in minutes (integer)
|-
|-
|<#daylightlength>
|<#rollovertime>
|Length of daylight in hours and minutes (dawn to dusk)
|The time that the logs rollover to the next day: 'Midnight', '9 am' or '10 am'
|-
|-
|<#isdaylight>
|<#update>
|A flag to indicate if the location for the station is in civil daylight or not, based on the dawn and dusk times.
|The date and time of the last web site update
 
Possible values are 0 or 1, where 1 notes that it is currently within the hours of daylight.
 
|-
|-
|<#tomorrowdaylength>
|<#LastDataReadT>
|A string giving an approximate predicted difference between the length of daylight (dawn to dusk) yesterday and length of daylight tomorrow.
|The date/time data was last read from the station
 
This web tag is unreliable, and its use is not recommended. Its use is therefore not supported (i.e. you use it at your own risk).
|-
|-
|<#moonphase>
|<#stationtype>
|Current [[Lunar phase|phase of the moon]] in words, eg "New Moon" etc. The names used can be altered in [[Strings.ini#Moon_Phases|strings.ini]].
|The weather station [https://cumuluswiki.wxforum.net/a/Cumulus.ini#Section:_Station model] description (you choose what text appears for this on 'Display' settings screen within Configuration menu - the field is at the bottom left of that screen).
|-
|-
|<#MoonAge>
|<#latitude>
|Current '''approximate''' age of the Moon in days (0-29.53)
|The station [http://en.wikipedia.org/wiki/Latitude latitude] (as you entered during setup).
Supports an optional 'dp' parameter, if supplied, instead of the usual web-encoded text format with degrees/minutes/seconds, the result is in decimal degrees to the specified number of decimal places. E.g<br />
<#latitude> gives "N&nbsp;59& deg;&amp;nbsp;14&amp;#39;&amp;nbsp;33&amp;quot;" for N 59 14 33<br />
<#latitude dp=5> gives "59.24250"


MX b3047 adds the 'dp' and 'rc' parameters Supports an optional 'dp' parameter, if supplied the result is returned to the specified number of decimal places. E.g <#MoonAge> gives "11" <#MoonAge dp=3> gives "11.234"
If the "dp" parameter is supplied, then supplying "rc=y" in addition will cause any decimal comma to be converted to a decimal point.
If the "dp" parameter is supplied, then also supplying "rc=y" in addition will cause any decimal comma to be converted to a decimal point.
|-
|-
|<#moonrise>
|<#longitude>
|Current moonrise time at the station (if moon rises on current calendar day)
|The station [http://en.wikipedia.org/wiki/Longitude longitude]  (as you entered during setup). Supports an optional 'dp' and 'rc' parameters as per the latitude tag.
|-
|-
|<#moonset>
|<#altitude>
|Current moonset time at the station (if moon sets on current calendar day)
|The station [http://en.wikipedia.org/wiki/Altitude altitude] value (webtag outputs web encoded format containing figure, '&amp;nbsp;' and units) in either feet or metres just as you entered during setup (so it is more complex to extract number for script arithmetric); e.g. '123&amp;nbsp;m'
|-
|-
|<#MoonPercent>
|<#location>
|Current percentage of moon visible (negative value indicates 'waning')
|The station location (as you entered during setup)
 
MX b3047 adds the 'dp' and 'rc' parameters as <#MoonAge> above
|-
|-
|<#MoonPercentAbs>
|<#longlocation>
|Current percentage of moon visible (always positive)
|Longer description of the station location (as you entered during setup)
 
MX b3047 adds the 'dp' and 'rc' parameters as <#MoonAge> above
|-
|-
|<#SunshineHours>
|<#forum>
|Hours of sunshine so far today  (Solar sensor needed)
|URL of the forum (as you entered during setup)
|-
|-
|<#YSunshineHours>
|<#webcam>
|Total hours of sunshine yesterday  (Solar sensor needed)
|URL of the webcam (as you entered during setup)
|-
|-
|<#CurrentSolarMax>
|<#graphperiod>
|[[FAQ#What_is_this_.22Solar_Max.22_value_which_Cumulus_is_displaying.3F | Current theoretical maximum solar radiation]]
|The number of hours displayed by the graphs, as set using '''Configuration''' menu, ''Display'' settings screen 'Detailed Chart Period'
|-
|-
|<#IsSunny>
|<#dailygraphperiod>
|Returns 1 if the sun is shining, otherwise 0 (Solar sensor needed)
|The number of days displayed by the graphs, as set using '''Configuration''' menu, ''Display'' settings screen 'Daily Chart Period' (available from build 1098)
|}
 
==Alarms==
 
[[File:badge v1.png]]There are a set of tags available in Cumulus 1 for various alarm states.
 
They give a value of '1' if an alarm parameter has been selected (Main Cumulus screen, Edit menu) and the alarm condition is still currently met; otherwise '0'.
{| class="wikitable" border="1"
|-
|-
!style="width:150px" |webtag
|<#snowdepth>
!style="width:600px" |Function
|Today's snow depth as entered manually in the Weather Diary (not available in Cumulus MX), see Cumulus 'Help'. Meteorologists express it in Centimeters, but Cumulus 1 does not care what units you use. Output is purely as a numerical integer (e.g. 10).
Configure in [[Cumulus.ini]] the hour when the snowdepth is updated e.g. ''SnowDepthHour=9'' means yesterday's figure applies until 9am.
|-
|-
|<#LowTempAlarm>  
|<#currcond>
|Low temperature alarm
|Represents the value entered on the screen within Cumulus for the Current Weather condition, or the value as held in the [[currentconditions.txt]] file. Any reserved HTML characters are encoded as HTML entities
|-
|-
|<#HighTempAlarm>  
|<#currcondenc>
|High temperature alarm
|The same as <#currcond> but also has all characters above (decimal base)code 159 encoded as HTML entities
|-
|-
|<#TempChangeUpAlarm>  
|<#chillhours>
|Temperature increase alarm
|The number of [[Heat/cold_degree_days_and_Chill_hours#Chill_Hours_and.2For_Air_Frost|'chill hours']] so far this season (threshold temperature and start date are configurable).
|-
|-
|<#TempChangeDownAlarm>  
|<#ConsecutiveRainDays>
|Temperature decrease alarm
|The number of days up to (but not including) today where it has rained every day. The threshold amount of rain required to determine a rain day is configurable via the RainDayThreshold setting in cumulus.ini, the units for the threshold are the same as your rain units, meteorologists exclude dew (and other times when single tip of recorder).
|-
|-
|<#LowPressAlarm>  
|<#ConsecutiveDryDays>
|Low pressure alarm
|The number of days up to (but not including) today since it last rained. The threshold amount of rain required to determine a rain day is configurable via the RainDayThreshold setting in cumulus.ini the units for the threshold are the same as your rain units
|-
|-
|<#HighPressAlarm>  
|<#WindRoseData>
|High pressure alarm
|A comma-separated list of the wind 'totals' used to draw the wind rose (8 or 16 values)
|-
|-
|<#PressChangeUpAlarm>  
|<#WindRosePoints>
|Pressure increase alarm
|The number of items in <#WindRoseData> (i.e. 8 or 16)
|-
|-
|<#PressChangeDownAlarm>  
|<#WindSampleCount>
|Pressure decrease alarm
|The number of wind samples making up the wind rose (etc) data (up to 3600)
|-
|-
|<#HighRainTodayAlarm>  
|<#LatestNOAAMonthlyReport>
|High rain today alarm
|Gives file name of latest auto-saved NOAA monthly report
|-
|-
|<#HighRainRateAlarm>  
|<#LatestNOAAYearlyReport>
|High rainfall rate alarm
|Gives file name of latest auto-saved NOAA yearly report
|-
|}
|<#HighWindGustAlarm>
 
|High wind gust alarm
==Day/Night/Sun/Moon==
These are updated each hour to refer to current time-zone
{| class="wikitable" border="1"
|-
|-
|<#HighWindSpeedAlarm>
!style="width:150px" | Web tag_name
|High wind speed alarm
!style="width:600px" | Function
|-
|-
|<#DataStopped>
|<#sunrise>
|1 if the station has apparently stopped sending data to Cumulus, otherwise 0
|Last sunrise time at the station - This sunrise time is calculated by a third party library each midnight UTC, and each hour Cumulus converts it to local time to ensure shown correctly before and after any clock change.
|}
 
==Records==
 
There are a set of tags for the Cumulus record states. They give a value of '1' if the record has been exceeded; otherwise '0'. For daily records (e.g. temperature range), the record cannot be set until the end of the day when rollover starts. The tag is cleared in Cumulus 1 once the record has been viewed (via main screen or web tag).
 
'''Please remember these are for Cumulus 1.9.x, Cumulus MX works in a different way both in terms of how tags are set (see various topics in support forum) and how they are cleared (essentially the end of rollover clears records, so daily records are only shown for the few microseconds while rollover is being processed).'''
{| class="wikitable" border="1"
|-
|-
!style="width:150px" |webtag
|<#sunset>
!style="width:600px" |Function
|Next sunset time at the station - The sunset/sunrise times are calculated each midnight UTC, and each hour Cumulus converts them to local time to ensure it shows them correctly before and after any clock change.
|-
|-
|<#recordsbegandate>
|<#daylength>
|The date that Cumulus began tracking all time records (does not prevent earlier record dates being set manually)
|Length of day in hours and minutes (sunrise to sunset) -  The third party library that Cumulus uses each midnight UTC, may take last sunrise from previous day and next sunset from next day, so the calculation may be off by a minute or so compared to true figure for current day.
|-
|-
|<#newrecord>  
|<#IsSunUp>
|Indicates when any tracked extreme is changed.
|A flag to indicate if the Sun is above the horizon or not, based on the sunrise and sunset times.
*In Cumulus 1.x.x: 1 if 'new record' light is flashing, 0 if not
 
*In Cumulus MX: 1 from when new record is set until next rollover is completed, 0 otherwise
Possible values are 0 or 1, where 1 is when the Sun is above the horizon for the station location.
|-
|-
|<#TempRecordSet>
|<#dawn>
|1 if the indicator on the temperature tab on the all-time records screen is currently lit, 0 if not
|Start of last Civil Twilight at the station as at last midnight UTC
|-
|-
|<#WindRecordSet>
|<#dusk>
|1 if the indicator on the wind tab on the all-time records screen is currently lit, 0 if not
|End of next Civil Twilight at the station as at last midnight UTC
|-
|-
|<#RainRecordSet>
|<#daylightlength>
|1 if the indicator on the rain tab on the all-time records screen is currently lit, 0 if not
|Length of daylight in hours and minutes (dawn to dusk)
|-
|-
|<#HumidityRecordSet>
|<#isdaylight>
|1 if the indicator on the humidity tab on the all-time records screen is currently lit, 0 if not
|A flag to indicate if the location for the station is in civil daylight or not, based on the dawn and dusk times.
 
Possible values are 0 or 1, where 1 notes that it is currently within the hours of daylight.
 
|-
|-
|<#PressureRecordSet>
|<#tomorrowdaylength>
|1 if the indicator on the pressure tab on the all-time records screen is currently lit, 0 if not
|A string giving an approximate predicted difference between the length of daylight (dawn to dusk) yesterday and length of daylight tomorrow.
 
This web tag is unreliable, and its use is not recommended. Its use is therefore not supported (i.e. you use it at your own risk).
|-
|-
|<#HighTempRecordSet>
|<#moonphase>
|1 if the all-time high temperature light is currently flashing, 0 if not
|Current [[Lunar phase|phase of the moon]] in words, eg "New Moon" etc. The names used can be altered in [[Strings.ini#Moon_Phases|strings.ini]].
|-
|-
|<#LowTempRecordSet>
|<#MoonAge>
|1 if the all-time low temperature light is currently flashing, 0 if not
|Current '''approximate''' age of the Moon in days (0-29.53)
 
MX b3047 adds the 'dp' and 'rc' parameters Supports an optional 'dp' parameter, if supplied the result is returned to the specified number of decimal places. E.g <#MoonAge> gives "11" <#MoonAge dp=3> gives "11.234"
If the "dp" parameter is supplied, then also supplying "rc=y" in addition will cause any decimal comma to be converted to a decimal point.
|-
|-
|<#HighTempRangeRecordSet>
|<#moonrise>
|1 if the all-time high daily temperature range light is currently flashing, 0 if not
|Current moonrise time at the station (if moon rises on current calendar day)
|-
|-
|<#LowTempRangeRecordSet>
|<#moonset>
|1 if the all-time low daily temperature range light is currently flashing, 0 if not
|Current moonset time at the station (if moon sets on current calendar day)
|-
|-
|<#HighAppTempRecordSet>
|<#MoonPercent>
|1 if the all-time high apparent temperature light is currently flashing, 0 if not
|Current percentage of moon visible (negative value indicates 'waning')
 
MX b3047 adds the 'dp' and 'rc' parameters as <#MoonAge> above
|-
|-
|<#LowAppTempRecordSet>
|<#MoonPercentAbs>
|1 if the all-time low apparent temperature light is currently flashing, 0 if not
|Current percentage of moon visible (always positive)
 
MX b3047 adds the 'dp' and 'rc' parameters as <#MoonAge> above
|-
|-
|<#HighHeatIndexRecordSet>
|<#SunshineHours>
|1 if the all-time high heat index light is currently flashing, 0 if not
|Hours of sunshine so far today  (Solar sensor needed)
|-
|-
|<#LowWindChillRecordSet>
|<#YSunshineHours>
|1 if the all-time low wind chill light is currently flashing, 0 if not
|Total hours of sunshine yesterday  (Solar sensor needed)
|-
|-
|<#HighDewPointRecordSet>
|<#CurrentSolarMax>
|1 if the all-time high dew point light is currently flashing, 0 if not
|[[FAQ#What_is_this_.22Solar_Max.22_value_which_Cumulus_is_displaying.3F | Current theoretical maximum solar radiation]]
|-
|-
|<#LowDewPointRecordSet>
|<#IsSunny>
|1 if the all-time low dew point light is currently flashing, 0 if not
|Returns 1 if the sun is shining, otherwise 0 (Solar sensor needed)
|}
 
==Alarms==
 
[[File:badge v1.png]]There are a set of tags available in Cumulus 1 for various alarm states.
 
They give a value of '1' if an alarm parameter has been selected (Main Cumulus screen, Edit menu) and the alarm condition is still currently met; otherwise '0'.
{| class="wikitable" border="1"
|-
|-
|<#HighMinTempRecordSet>
!style="width:150px" |Web tag_name
|1 if the all-time high minimum temperature light is currently flashing, 0 if not
!style="width:600px" |Function
|-
|-
|<#LowMaxTempRecordSet>
|<#LowTempAlarm>  
|1 if the all-time low maximum temperature light is currently flashing, 0 if not
|Low temperature alarm
|-
|-
|<#HighWindGustRecordSet>
|<#HighTempAlarm>  
|1 if the all-time high wind gust light is currently flashing, 0 if not
|High temperature alarm
|-
|-
|<#HighWindSpeedRecordSet>
|<#TempChangeUpAlarm>  
|1 if the all-time high wind speed light is currently flashing, 0 if not
|Temperature increase alarm
|-
|-
|<#HighRainRateRecordSet>
|<#TempChangeDownAlarm>  
|1 if the all-time high rain rate light is currently flashing, 0 if not
|Temperature decrease alarm
|-
|-
|<#HighHourlyRainRecordSet>
|<#LowPressAlarm>  
|1 if the all-time high hourly rain light is currently flashing, 0 if not
|Low pressure alarm
|-
|-
|<#HighDailyRainRecordSet>
|<#HighPressAlarm>  
|1 if the all-time high daily rain light is currently flashing, 0 if not
|High pressure alarm
|-
|-
|<#HighMonthlyRainRecordSet>
|<#PressChangeUpAlarm>  
|1 if the all-time high monthly rain light is currently flashing, 0 if not
|Pressure increase alarm
|-
|-
|<#LongestDryPeriodRecordSet>
|<#PressChangeDownAlarm>  
|1 if the all-time longest dry period light is currently flashing, 0 if not
|Pressure decrease alarm
|-
|-
|<#LongestWetPeriodRecordSet>
|<#HighRainTodayAlarm>  
|1 if the all-time longest wet period light is currently flashing, 0 if not
|High rain today alarm
|-
|-
|<#HighHumidityRecordSet>
|<#HighRainRateAlarm>  
|1 if the all-time high humidity light is currently flashing, 0 if not
|High rainfall rate alarm
|-
|-
|<#LowHumidityRecordSet>
|<#HighWindGustAlarm>  
|1 if the all-time low humidity light is currently flashing, 0 if not
|High wind gust alarm
|-
|-
|<#HighPressureRecordSet>
|<#HighWindSpeedAlarm>  
|1 if the all-time high pressure light is currently flashing, 0 if not
|High wind speed alarm
|-
|-
|<#LowPressureRecordSet>
|<#DataStopped>
|1 if the all-time low pressure light is currently flashing, 0 if not
|1 if the station has apparently stopped sending data to Cumulus, otherwise 0
|-
|<#HighWindrunRecordSet>
|1 if the all-time high wind run light is currently flashing, 0 if not
|}
|}


==Extra Sensors==
== Extreme Records ==


These webtags hold current values for additional sensors supported by Cumulus. For past values, see the [[Extra_Sensor_Files]] page for information about log files.
There are a set of tags for the Cumulus record states. They give a value of '1' if the record has been exceeded; otherwise '0'. For daily records (e.g. temperature range), the record cannot be set until the end of the day when rollover starts. The tag is cleared in Cumulus 1 once the record has been viewed (via main screen or web tag).


'''Please remember these are for Cumulus 1.9.x, Cumulus MX works in a different way both in terms of how tags are set (see various topics in support forum) and how they are cleared (essentially the end of rollover clears records, so daily records are only shown for the few microseconds while rollover is being processed).'''
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
!style="width:150px"|webtag
!style="width:150px" |Web tag_name
!style="width:600px"|The related description can be changed in 'strings.ini'
!style="width:600px" |Function
|-
|-
|<#ExtraTemp1>
|<#recordsbegandate>
|Extra temperature channel 1
|The date that Cumulus began tracking all time records (does not prevent earlier record dates being set manually)
|-
|-
|<#ExtraTemp2>
|<#newrecord>  
|Extra temperature channel 2
|Indicates when any tracked extreme is changed.
*In Cumulus 1.x.x: 1 if 'new record' light is flashing, 0 if not
*In Cumulus MX: 1 from when new record is set until next rollover is completed, 0 otherwise
|-
|-
|<#ExtraTemp3>
|<#TempRecordSet>
|Extra temperature channel 3
|1 if the indicator on the temperature tab on the all-time records screen is currently lit, 0 if not
|-
|-
|colspan="2"|... and so on up to <#ExtraTemp10> = Extra temperature channel 10
|<#WindRecordSet>
|1 if the indicator on the wind tab on the all-time records screen is currently lit, 0 if not
|-
|-
|<#ExtraDP1>
|<#RainRecordSet>
|Extra dew point channel 1
|1 if the indicator on the rain tab on the all-time records screen is currently lit, 0 if not
|-
|-
|<#ExtraDP2>
|<#HumidityRecordSet>
|Extra dew point channel 2
|1 if the indicator on the humidity tab on the all-time records screen is currently lit, 0 if not
|-
|-
|<#ExtraDP3>
|<#PressureRecordSet>
|Extra dew point channel 3
|1 if the indicator on the pressure tab on the all-time records screen is currently lit, 0 if not
|-
|-
|colspan="2"|... and so on up to <#ExtraDP10>
|<#HighTempRecordSet>
|1 if the all-time high temperature light is currently flashing, 0 if not
|-
|-
|<#ExtraHum1>
|<#LowTempRecordSet>
|Extra humidity channel 1
|1 if the all-time low temperature light is currently flashing, 0 if not
|-
|-
|<#ExtraHum2>
|<#HighTempRangeRecordSet>
|Extra humidity channel 2
|1 if the all-time high daily temperature range light is currently flashing, 0 if not
|-
|-
|<#ExtraHum3>
|<#LowTempRangeRecordSet>
|Extra humidity channel 3
|1 if the all-time low daily temperature range light is currently flashing, 0 if not
|-
|-
|colspan="2"|... and so on up to <#ExtraHum10>
|<#HighAppTempRecordSet>
|1 if the all-time high apparent temperature light is currently flashing, 0 if not
|-
|-
|<#SoilTemp1>
|<#LowAppTempRecordSet>
|Soil temperature 1
|1 if the all-time low apparent temperature light is currently flashing, 0 if not
|-
|-
|<#SoilTemp2>
|<#HighHeatIndexRecordSet>
|Soil temperature 2
|1 if the all-time high heat index light is currently flashing, 0 if not
|-
|-
|colspan="2"|... and so on up to <#SoilTemp16>
|<#LowWindChillRecordSet>
|1 if the all-time low wind chill light is currently flashing, 0 if not
|-
|-
|<#SoilMoisture1>
|<#HighDewPointRecordSet>
|Soil moisture 1
|1 if the all-time high dew point light is currently flashing, 0 if not
|-
|-
|<#SoilMoisture2>
|<#LowDewPointRecordSet>
|Soil moisture 2
|1 if the all-time low dew point light is currently flashing, 0 if not
|-
|-
|colspan="2"|... and so on up to <#SoilMoisture16>
|<#HighMinTempRecordSet>
|1 if the all-time high minimum temperature light is currently flashing, 0 if not
|-
|-
|<#LeafTemp1>
|<#LowMaxTempRecordSet>
|Leaf temperature 1
|1 if the all-time low maximum temperature light is currently flashing, 0 if not
|-
|-
|<#LeafTemp2>
|<#HighWindGustRecordSet>
|Leaf temperature 2
|1 if the all-time high wind gust light is currently flashing, 0 if not
|-
|-
|<#LeafWetness1>
|<#HighWindSpeedRecordSet>
|Leaf wetness 1
|1 if the all-time high wind speed light is currently flashing, 0 if not
|-
|-
|<#LeafWetness2>
|<#HighRainRateRecordSet>
|Leaf wetness 2
|1 if the all-time high rain rate light is currently flashing, 0 if not
|-
|-
|<#AirQuality1>
|<#HighHourlyRainRecordSet>
|Air quality (currently only GW1000 stations)
|1 if the all-time high hourly rain light is currently flashing, 0 if not
|-
|-
|colspan="2"|... and so on up to <#AirQuality4>
|<#HighDailyRainRecordSet>
|1 if the all-time high daily rain light is currently flashing, 0 if not
|-
|-
|<#LeakSensor1>
|<#HighMonthlyRainRecordSet>
|Leak sensor - 0 or 1 (currently only GW1000 stations)
|1 if the all-time high monthly rain light is currently flashing, 0 if not
|-
|-
|colspan="2"|... and so on up to <#LeakSensor4>
|<#LongestDryPeriodRecordSet>
|1 if the all-time longest dry period light is currently flashing, 0 if not
|-
|-
|<#LightningDistance>
|<#LongestWetPeriodRecordSet>
|Distance to last strike (same units as wind run - miles/km/nm)
|1 if the all-time longest wet period light is currently flashing, 0 if not
(currently only GW1000 stations)
|-
|-
|<#LightningTime>
|<#HighHumidityRecordSet>
|Time of last strike (format customisable)
|1 if the all-time high humidity light is currently flashing, 0 if not
(currently only GW1000 stations)
|-
|-
|<#LightningStrikesToday>
|<#LowHumidityRecordSet>
|Number of strikes since midnight
|1 if the all-time low humidity light is currently flashing, 0 if not
(currently only GW1000 stations)
|-
|<#HighPressureRecordSet>
|1 if the all-time high pressure light is currently flashing, 0 if not
|-
|<#LowPressureRecordSet>
|1 if the all-time low pressure light is currently flashing, 0 if not
|-
|<#HighWindrunRecordSet>
|1 if the all-time high wind run light is currently flashing, 0 if not
|}
|}


==Special tags==
==Special tags==
Line 1,892: Line 1,940:
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
!style="width:150px" |webtag
!style="width:150px" |Web tag_name
!style="width:600px" |Function
!style="width:600px" |Function
|-
|-
Line 1,906: Line 1,954:
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
!style="width:150px" |web tag
!style="width:150px" |Web tag_name
!style="width:120px" |Applicability
!style="width:120px" |Applicability
!style="width:600px" |Function
!style="width:600px" |Function
Line 1,976: Line 2,024:
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | webtag
!style="width:150px" | Web tag_name
!style="width:600px" | Function
!style="width:600px" | Function
|-
|-
Line 1,992: Line 2,040:
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
!style="width:150px" |webtag
!style="width:150px" |Web tag_name
!style="width:600px" |Function
!style="width:600px" |Function
|-
|-
|<#GW1000FirmwareVersion>
|<#GW1000FirmwareVersion>
|GW1000 firmware version string
|GW1000 firmware version string
|}
===System===
Special tags returning information about the system hosting Cumulus:
'''These apply to Cumulus 1.x.x only; (see Cumulus MX forum)'''
{| class="wikitable" border="1"
|-
!style="width:150px" |webtag
!style="width:600px" |Function
|-
|<#OsVersion>
|OS version, e.g. "Windows 7 x64 build 7600"
|-
|<#OsLanguage>
|OS language, e.g. "English"
|-
|<#SystemUpTime>
|How long the system has been up, e.g. "8 hours 21 minutes"
|-
|<#ProgramUpTime>
|How long Cumulus has been running, e.g. "7 hours 55 minutes"
|-
|<#CpuName>
|CPU type, e.g. "Intel(R) Core(TM)2 Quad CPU Q6600 @ 2.40GHz"
|-
|<#CpuCount>
|Number of processors, e.g. "4"
|-
|<#MemoryStatus>
|Free and total system RAM, e.g. "4619/8191 MB (free/total)"
|-
|<#DisplayMode>
|Screen display mode, e.g. "1680x1050, 32 bit"
|-
|<#AllocatedMemory>
|Amount of memory allocated to Cumulus, e.g. "18.76 MB"
|-
|<#DiskSize>
|Size of disk on which Cumulus is running, e.g. "931.51 GB"
|-
|<#DiskFree>
|Free space on disk on which Cumulus is running, e.g. "515.36 GB"
|}
|}


Sfws
5,838

edits

Retrieved from "https://www.cumuluswiki.org/a/Special:MobileDiff/4861"

Navigation menu