BETA webtags: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
m (→‎Date & Time: metdate/metdateyeaterday: Rollover time and usages)
(Removed all beta tags)
Line 1: Line 1:
== Additional webtags available in the BETA version of Cumulus 1.9.3 ==
= NOTE THERE IS NOT CURRENTLY A BETA VERSION OF CUMULUS AVAILABLE =
 
== Additional webtags available in the BETA version of Cumulus X.X.X ==




Line 31: Line 33:
!style="width:600px" | Function
!style="width:600px" | Function
|-
|-
|<#metdate>
|colspan="2"|no new tags
|The current meteorological date. After rollover time on current calendar date, this date will be the same as the current date. If using a 9am/10am rollover, then between midnight and 9am/10am the <#metdate> will be the previous calendar day. 
 
Can be used with relevant format parameters to indicate current meteorological day on todayT.htm template page, meteorological month on thismonthT.htm template page, or meteorological year on thisyearT.htm template page
|-
|<#metdateyesterday>>
|The previous meteorological date. If using a 9am/10am rollover, then between midnight and 9am/10am the <#metdateyesterday> will be the calendar day before that returned by <#yesterday>, otherwise both return same. 
 
Can be used with relevant format parameters to indicate correct day on yesterdayT.htm template page, and can be used to return latest day stored on [[dayfile.txt]] and NOAA report for latest month.
|-
|<#yesterday>
|Yesterdays date
|-
|<#DaysSince30Dec1899>
|Day count (gives whole and fractional part) Example: 41250.6523310301
|-
|<#DaysSinceRecordsBegan>
|Day count since Cumulus records started
|}
|}


Line 60: Line 45:
|colspan="2" style="background:lightgray;"|Temperature & Humidity
|colspan="2" style="background:lightgray;"|Temperature & Humidity
|-
|-
|<#IsFreezing>
|colspan="2"|no new tags
|Is outside temperature is at or below 0C/32F. 0=Above freezing, 1=Below freezing
|-
|-
|colspan="2" style="background:lightgray;"|Rainfall
|colspan="2" style="background:lightgray;"|Rainfall
|-
|-
|<#IsRaining>
|colspan="2"|no new tags
|For Hydreon RG-11 devices, shows the current rain state. 0=No rain, 1=It's raining
|-
|-
|colspan="2" style="background:lightgray;"|Pressure
|colspan="2" style="background:lightgray;"|Pressure
Line 103: Line 86:
|colspan="3" style="background:lightgray;"|Wind
|colspan="3" style="background:lightgray;"|Wind
|-
|-
|<#Tbeaudesc>
|colspan="3"|no new tags
|Beaufort 'description' for today's high wind speed
|n/a
|-
|-
|colspan="3" style="background:lightgray;"|Miscellaneous
|colspan="3" style="background:lightgray;"|Miscellaneous
|-
|-
|<#solarTH>
|colspan="3"|no new tags
|Today's high solar radiation value
|<#TsolarTH>
|-
|<#UVTH>
|Today's high UV Index
|<#TUVTH>
|-
|<#metdate>
|Meteorological Today - Date at last rollover
|<#rollovertime>
|}
|}


Line 132: Line 103:
|colspan="3" style="background:lightgray;"|Temperature & Humidity
|colspan="3" style="background:lightgray;"|Temperature & Humidity
|-
|-
|<#avgtempY>
|colspan="3"|no new tags
|Yesterday's average temperature
|n/a
|-
|-
|colspan="3" style="background:lightgray;"|Rainfall
|colspan="3" style="background:lightgray;"|Rainfall
|-
|colspan="3"|no new tags
|-
|-
|colspan="3"|no new tags
|colspan="3"|no new tags
Line 146: Line 117:
|colspan="3" style="background:lightgray;"|Wind
|colspan="3" style="background:lightgray;"|Wind
|-
|-
|<#Ybeaudesc>
|colspan="2"|no new tags
|Beaufort 'description' for yesterday's high wind speed
|n/a
|-
|-
|colspan="3" style="background:lightgray;"|Miscellaneous
|colspan="3" style="background:lightgray;"|Miscellaneous
|-
|-
|<#solarYH>
|colspan="3"|no new tags
|Yesterday's high solar radiation value
|<#TsolarYH>
|-
|<#UVYH>
|Yesterday's high UV Index
|<#TUVYH>
|-
|<#metdateyesterday>
|Yesterday's 'meterological' date (started at last but one rollover)
|
|}
|}


Line 265: Line 224:
!style="width:600px" | Function  
!style="width:600px" | Function  
|-
|-
|<#RecentOutsideTemp>
|colspan="2"|no new tags
|Outside Temperature
|-
|<#RecentWindSpeed>
|Wind Speed
|-
|<#RecentWindGust>
|Wind Gust
|-
|<#RecentWindLatest>
|Wind Latest. Note: Wind 'Speed', 'Gust' and 'Latest' have the usual Cumulus meanings
|-
|<#RecentWindDir>
|Wind Direction (instantaneous)
|-
|<#RecentWindAvgDir>
|Wind Direction (average)
|-
|<#RecentWindChill>
|Wind Chill
|-
|<#RecentDewPoint>
|Dew Point
|-
|<#RecentHeatIndex>
|Heat Index
|-
|<#RecentHumidity>
|Relative Humidity
|-
|<#RecentPressure>
|Sea-level Pressure
|-
|<#RecentRainToday>
|Today's rain
|-
|<#RecentSolarRad>
|Solar Radiation
|-
|<#RecentUV>
|UV Index
|}
|}


Line 323: Line 242:
|colspan="3" style="background:lightgray;"|Temperature & Humidity
|colspan="3" style="background:lightgray;"|Temperature & Humidity
|-
|-
|<#ByMonthTempH>
|colspan="3"|no new tags
|High Temperature
|<#ByMonthTempHT>
|-
|-
|<#ByMonthTempL>
|colspan="3" style="background:lightgray;"|Pressure
|Low Temperature
|<#ByMonthTempLT>
|-
|-
|<#ByMonthHeatIndexH>
|colspan="3"|no new tags
|High Heat Index
|<#ByMonthHeatIndexHT>
|-
|-
|<#ByMonthWChillL>
|colspan="3" style="background:lightgray;"|Rainfall
|Low Wind Chill
|<#ByMonthWChillLT>
|-
|-
|<#ByMonthAppTempH>
|colspan="3"|no new tags
|High Apparent Temperature
|<#ByMonthAppTempHT>
|-
|-
|<#ByMonthAppTempL>
|colspan="3" style="background:lightgray;"|Miscellaneous
|Low Apparent Temperature
|<#ByMonthAppTempLT>
|-
|-
|<#ByMonthDewPointH>
|colspan="3"|no new tags
|High Dew Point
|<#ByMonthDewPointHT>
|-
|<#ByMonthDewPointL>
|Low Dew Point
|<#ByMonthDewPointLT>
|-
|<#ByMonthMinTempH>
|Highest Daily Minimum Temperature
|<#ByMonthMinTempHT>
|-
|<#ByMonthMaxTempL>
|Lowest Daily Maximum Temperature
|<#ByMonthMaxTempLT>
|-
|<#ByMonthHighDailyTempRange>
|High Daily Temp Range
|<#ByMonthHighDailyTempRangeT>
|-
|<#ByMonthLowDailyTempRange>
|Low Daily Temp Range
|<#ByMonthLowDailyTempRangeT>
|-
|<#ByMonthHumH>
|High Humidity
|<#ByMonthHumHT>
|-
|<#ByMonthHumL>
|Low Humidity
|<#ByMonthHumLT>
|-
|colspan="4" style="background:lightgray;"|Pressure
|-
|<#ByMonthPressH>
|High Pressure
|<#ByMonthPressHT>
|-
|<#ByMonthPressL>
|Low Pressure
|<#ByMonthPressLT>
|-
|colspan="4" style="background:lightgray;"|Wind
|-
|<#ByMonthGustH>
|High Wind Gust
|<#ByMonthGustHT>
|-
|<#ByMonthWindH>
|High Wind Speed
|<#ByMonthWindHT>
|-
|<#ByMonthWindRunH>
|High Daily Wind Run
|<#ByMonthWindRunHT>
|-
|colspan="4" style="background:lightgray;"|Rainfall
|-
|<#ByMonthRainRateH>
|High Rain Rate
|<#ByMonthRainRateHT>
|-
|<#ByMonthHourlyRainH>
|High Hourly Rain
|<#ByMonthHourlyRainHT>
|-
|<#ByMonthDailyRainH>
|High Daily Rain
|<#ByMonthDailyRainHT>
|-
|<#ByMonthLongestDryPeriod>
|Longest Dry Period
|<#ByMonthLongestDryPeriodT>
|-
|<#ByMonthLongestWetPeriod>
|Longest Wet Period
|<#ByMonthLongestWetPeriodT>
|-
|colspan="4" style="background:lightgray;"|Miscellaneous
|-
|colspan="4"|no new tags
|}
|}


Line 437: Line 264:
!style="width:600px" | Function
!style="width:600px" | Function
|-
|-
|<#LastDataReadT>
|colspan="2"|no new tags
|The date/time data was last read from the station
|}
|}


Line 459: Line 285:
!style="width:600px" | Function
!style="width:600px" | Function
|-
|-
|<#DataStopped>
|colspan="2"|no new tags
|1 if the station has apparently stopped sending data to Cumulus, otherwise 0
|}
|}


Line 483: Line 308:
!style="width:600px"|Function
!style="width:600px"|Function
|-
|-
|<#ExtraTemp1>
|colspan="2"|no new tags
|Extra temperature channel 1
|}
 
==Special==
 
===OS WMR Series===
 
There are a set of tags for the WMR928, WR100/200 extra sensors:
 
{| class="wikitable" border="1"
|-
|-
|<#ExtraTemp2>
!style="width:150px" | webtag
|Extra temperature channel 2
!style="width:600px" | Function
|-
|-
|<#ExtraTemp3>
|colspan="2"|no new tags
|Extra temperature channel 3
|-
|colspan="2"|... and so on up to <#ExtraTemp10>
|-
|<#ExtraDP1>
|Extra dew point channel 1
|-
|<#ExtraDP2>
|Extra dew point channel 2
|-
|<#ExtraDP3>
|Extra dew point channel 3
|-
|colspan="2"|... and so on up to <#ExtraDP10>
|-
|<#ExtraHum1>
|Extra humidity channel 1
|-
|<#ExtraHum2>
|Extra humidity channel 2
|-
|<#ExtraHum3>
|Extra humidity channel 3
|-
|colspan="2"|... and so on up to <#ExtraHum10>
|-
|<#SoilTemp1>
|Soil temperature 1
|-
|<#SoilTemp2>
|Soil temperature 2
|-
|colspan="2"|... and so on up to <#SoilTemp4>
|-
|<#SoilMoisture1>
|Soil moisture 1
|-
|<#SoilMoisture2>
|Soil moisture 2
|-
|colspan="2"|... and so on up to <#SoilMoisture4>
|-
|<#LeafTemp1>
|Leaf temperature 1
|-
|<#LeafTemp2>
|Leaf temperature 2
|-
|<#LeafWetness1>
|Leaf wetness 1
|-
|<#LeafWetness2>
|Leaf wetness 2
|}
|}
==Special==


===WMR928===
===WMR928===
Line 568: Line 346:
!style="width:600px" | Function
!style="width:600px" | Function
|-
|-
|<#txbattery>
|colspan="2"|no new tags
<#txbattery channel=1>
|The transmitter battery condition, by default it returns the status of all transmitters.
The optional 'channel' parameter returns the status for a particular transmitter, up to channel=8. The channel result is just the string "ok" or whatever the string is for a low battery
|}
|}


Line 602: Line 377:
There are a set of tags where the decimal comma has been replaced with a full stop, where necessary, for use with gauges etc which don't like the commas. They all correspond to the same tag with 'RC' removed.
There are a set of tags where the decimal comma has been replaced with a full stop, where necessary, for use with gauges etc which don't like the commas. They all correspond to the same tag with 'RC' removed.


  <#RCwlatest> <#RCdewpointTH> <#RCdewpointTL><#RCwchillTL> <#RCheatindexTH> <#RCapptempTH> <#RCapptempTL>
  <#NO_NEW_TAGS>

Revision as of 17:13, 9 February 2013

NOTE THERE IS NOT CURRENTLY A BETA VERSION OF CUMULUS AVAILABLE

Additional webtags available in the BETA version of Cumulus X.X.X

These are special markers placed in a file which Cumulus can then process and replace with the actual values. Typically you would use this to build your own website by having an HTML template file with your layout, static text and graphics. In the position on the page you wish Cumulus to insert the relevant data place a webtag in the form: 

<#tagname>

Assuming you have asked Cumulus to process the file, it will replace the tag with the current value of the item the tag represents just before the file is uploaded to the internet.

Note: When you put a tag into your HTML, be careful that whatever program you are using to develop your web pages doesn't change the angle brackets to slightly different symbols -- this is a common cause of failure!

Also note that web tags are case sensitive, use them exactly as they appear here.

The Tags

Below is a list of the additional webtags available in this beta version. These webtags will be transferred to the main page when the beta version becomes 'live'

Units

webtag Function
no new tags

Date & Time

webtag Function
no new tags

Current Conditions

webtag Function
Temperature & Humidity
no new tags
Rainfall
no new tags
Pressure
no new tags
Wind
no new tags
Miscellaneous
no new tags

Today

webtag Function Time
Temperature & Humidity
no new tags
Rainfall
no new tags
Pressure
no new tags
Wind
no new tags
Miscellaneous
no new tags

Yesterday

webtag Function Time
Temperature & Humidity
no new tags
Rainfall
no new tags
no new tags
Pressure
no new tags
Wind
no new tags
Miscellaneous
no new tags

Monthly

webtag Function Time Date
Temperature & Humidity
no new tags
Pressure
no new tags
Wind
no new tags
Rainfall
no new tags
Miscellaneous
no new tags

Yearly

webtag Function Time Date
Temperature & Humidity
no new tags
Pressure
no new tags
Wind
no new tags
Rainfall
no new tags
Miscellaneous
no new tags

All Time

webtag Function Time
Temperature & Humidity
no new tags
Rainfall
no new tags
Pressure
no new tags
Wind
no new tags
Miscellaneous
no new tags

Recent History

There are a set of tags for 'recent historical data', giving data values from 1 minute ago, up to 1 week ago, in 1 minute intervals. Note that the values are initialised from the log files when Cumulus starts, so they 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 one for which there is currently no exact match.

You specify how old you want the value to be by using parameters on the web tags for number of days, hours, and minutes. 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.

webtag Function
no new tags

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.

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>


webtag Function Date/Time
Temperature & Humidity
no new tags
Pressure
no new tags
Rainfall
no new tags
Miscellaneous
no new tags

Miscellaneous

webtag Function
no new tags

Day/Night/Sun/Moon

webtag Function
no new tags

Alarms

There are a set of tags for the Cumulus alarm states. They give a value of '1' if the alarm has been set and the alarm condition is currently met; otherwise '0'.

webtag Function
no new tags

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'.

webtag Function
No new tags

Extra Sensors

These webtags are for additional sensors supported by Cumulus

webtag Function
no new tags

Special

OS WMR Series

There are a set of tags for the WMR928, WR100/200 extra sensors:

webtag Function
no new tags

WMR928

There are a set of tags for the WMR928 extra sensors:

webtag Function
no new tags

Davis

There are a set of tags for the Davis PWS:

webtag Function
no new tags

Fine Offset

The following tags are specific to the Fine Offset series of PWS

webtag Function
no new tags

System

Special tags returning information about the system hosting Cumulus:

webtag Function
no new tags


No Commas

There are a set of tags where the decimal comma has been replaced with a full stop, where necessary, for use with gauges etc which don't like the commas. They all correspond to the same tag with 'RC' removed. 

<#NO_NEW_TAGS>
Retrieved from "https://www.cumuluswiki.org/index.php?title=BETA_webtags&oldid=2404"