Webtags (preserving history): Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
m
m (→‎Standard sensors: improve link)
(14 intermediate revisions by the same user not shown)
Line 12: Line 12:
</div>
</div>


=Essential background reading=


=Introduction=
Although you could go straight to [[#The Web Tags for Cumulus]] later on this page, if you have not used this Wiki page before, there are some concepts to explain, and you need to be told that some content originally on this page has been moved to other pages.  Your attention is particualrly drawn to [[#Web tags mentioning (outside) temperature]].


This page was written in August 2009, to list the tags for the (legacy) Cumulus 1 software.
<div style="background: LemonChiffon;padding:5px; margin:2px;">This page currently covers web tag names for legacy 1.9.4, and for MX up to release '''3.12.0'''</div>


Initially, there were going to be further pages to explain individual web tags, e.g. [[Forecast_webtag]]; but that idea was never completed.
==General Format for Web Tags==


This page was updated to cover MX, when it came out of beta (3.0.0), and <div style="background: LemonChiffon;padding:5px; margin:2px;">this page currently covers legacy 1.9.4, and MX up to '''3.12.0'''</div>
In the position in any template file where Cumulus is to insert the relevant data, place a web tag in the '''general format''' specified here:  <pre><#tag_name [optional input selection parameters] [optional output modification parameters]></pre>


==What is a web tag? ==
{{TOCright}}


Put simply, a web tag is included in a [[Cumulus template file]] to indicate where Cumulus should insert values when it produces an output file. The concept of [[Customised_templates#What_is_meant_by_.27Cumulus_processes_templates.27|processing templates]] is explained in another article.
===Applicability to Cumulus 1 and to MX===


==Template files can create many types of file==
Various approaches are trialled in the list for indicating which flavours a web tag exists for.  The [[Webtags#Davis|Davis]] section has a column that indicates the applicability.  Other sections with more web tags use pink section headings to identify their applicability to the flavours.  Finally, there are some individual entries where '''C1''' and '''MX''' symbols are used to indicate applicability.


The output file can be:
There is some more information on [[Webtag Applicability|Web tag Applicability page]].
* a [[Customised_templates#HTML_5_-_a_very_quick_guide_to_structure|web page]],
* a  [[Php_webtags#Option_3:_JavaScript_Object_Notation|JavaScript Object Notation (.json) file]]
* a [[Feels_Like#HTML_code_to_translate_web_tags_to_JavaScript_variables_.28as_modified_for_additional_parameters.29|JavaScript file]],
* a [[PHP]] script file, or
*a [[Xml_webtags|eXtensible Mark-up Language (XML)]] file.


==General Format for Web Tags==
===Input Modification Parameters and Output Modification Parameters===


In the position in any template file where Cumulus is to insert the relevant data, place a web tag in the '''general format''' specified here:  <pre><#tag_name [optional input selection parameters] [optional output modification parameters]></pre>
MX has introduced many more of these, so they are no longer listed on this page.


To find out what is allowed for '''tag_name''', see the various tables later on this page.
Now to find out what is allowed for the '''input selection parameters''' and '''output modification parameters''', refer to [[Webtags/Parameters|web tag parameters]] page.


To find out what is allowed for the '''input selection parameters''' and '''output modification parameters''', refer to [[Webtags/Parameters|web tag parameters]] page.
For just a taste, there you can discover:
* A score of input parameters that modify some of those tags (for example, by using one input parameter attribute with a value between 1 and 12, the same web tag names can give values for 12 different months)
* The components that make up output parameters (a guide to how you modify the output format)
** how to control number of decimal places
** how to control whether decimal comma (if used) is replaced by decimal point (useful for some script languages)
** the majority modify the output from almost all web tags that report a time and/or date (there are so many ways to represent times and dates this multiples up the available output considerably)


==What this page covers ==
===Web tag names===


{{TOCright}}
To find out what is allowed for '''tag_name''', see the various tables [[#The Web Tags for Cumulus]] later on this page.  Don't forget to check [[Webtags/Parameters|web tag parameters]] page to learn whether a web tag name you find here requires a mandatory parameter, or to find out which parameters are optionally available as the tables below are not able to indicate which of the billions of combinations possible (see [[#Scary statistics]]) are valid or invalid for particular tag names.
#At the last count, a 3.5.x version of MX produces ''nine and a half million'' '''web tags'''! 
# Those millions of web tags can actually produce billions of different outputs!
#But the file mentioned in previous section contains just 717 items (at 3.5.0, later versions of MX raise this count by another forty tags or so).  
#How come this discrepancy?


*Well each web tag has the general format <tt><#tag_name optional_input_parameter optional_output_parameter></tt> and it is adding the optional input parameters that allow 717 tag names to define 9½ million values!
====General Tip====
*Adding all possible different output parameters generates the billions of different outputs!


Consequently, this article describes:
The web tag names available in the release/version/build you are using, can be listed (in Cumulus 1 or Cumulus MX) by adding the following line to [[Cumulus.ini#Section:_Station|Cumulus.ini]] in the [station] section...
*Over 7 hundred web tags -'''THIS ARTICLE MAY NOT CONTAIN ALL WEB TAGS AVAILABLE IN LATEST VERSION - It depends on someone updating this article if the developer does not have time to do so'''
<code>ListWebTags=1</code>


==What is covered on another page==
Then start Cumulus and it will create a file called WebTags.txt in the same folder as where the executable is found. That file will list all the tags your build of Cumulus can currently generate. This list only contains the tag_names, it does not indicate what parameters they can take, nor does it include the brackets the tag name is surrounded by when you quote it in a template file for Cumulus to process.


The parameters you can use with web tags are explained on the [[Webtags/Parameters|parameters page]], there you can discover:
An example of the output for an early MX version is at the end of this page (the actual output does not include commas, and has just one item per line, it has been compressed for inclusion in this article).
*A score of input parameters that modify some of those tags (meaning some web tags can represent 12 different months for example)
*The components that make up output parameters (a guide to how you modify the output format)
**how to control number of decimal places
**how to control whether decimal comma (if used) is replaced by decimal point (useful for some script languages)
**the majority modify the output from almost all web tags that report a time and/or date (there are so many ways to represent times and dates this multiples up the available output considerably)


To stop Cumulus continuing to produce new versions of that file change the line to say ...
<code> ListWebTags=0</code>


The tables below are not able to indicate which of the billions of combinations possible are valid or invalid for particular tag names nor for particular release versions..
{{Version badge 1}}If you are using Cumulus 1, each build of that contains a build specific version of Cumulus Help, and within that help is a list of web tags with basic information on what each tag_name returns.


==Applicability by flavour, and by release version and build==
[[File:Badge vMx.png]] MX bug: The inclusion of a web tag in the list produced by this instruction, does not mean that web tag is actually populated with valid information. See https://cumulus.hosiene.co.uk/viewtopic.php?p=153096#p153096 for an example.


Full support is available via the support forum at https://cumulus.hosiene.co.uk/viewforum.php?f=40 for the latest MX release. Given that some users may still be running an older MX release, where possible any web tag listed below for MX indicates at which release it first became available.
====Web tags mentioning (outside) temperature====


There is limited support available for Cumulus 1.9.4, but on this page every attempt is made to indicate which version of the legacy software introduced any web tag listed below as being available in the legacy software.
'''For Oregon Scientific weather stations using USB connections''' (e.g. WMR-200) that can have multiple temperature sensors, it is possible to configure which sensor the outdoor temperature (for which daily and longer period extreme records are maintained) is read from, by following this set of instructions originally supplied by Steve Loft:
# Stop Cumulus in the normal way
# Use a text editor to edit the file called ''Cumulus.ini''
# Scroll down to the line that contains '''[Station]'''
# Create a blank line below it by pressing ''Return''
# In that new line, type the command shown in the code box below, type the attribute and equals sign exactly as shown without spaces (regardless of your exact model), but for the value replace ''N'' with the relevant number from the following list:
#* To use the main sensor, replace N with '''0''' (or don't bother with this procedure, as that is default)
#* To use Extra Temp 1 sensor, replace N with '''1'''
#* To use Extra Temp 2 sensor, replace N with '''2'''
#* and so on, up to a possible maximum (check with your weather station, but Cumulus can accept up to 12)
# Save the file, and exit
# Restart Cumulus in the normal way
<code>WMR200TempChannel=N</code>


Various approaches are trialled in the list for indicating which flavours a web tag exists for.  The [[Webtags#Davis|Davis]] section has a column that indicates the applicability.  Other sections with more web tags use pink section headings to identify their applicability to the flavours.  Finally, there are some individual entries where '''C1''' and '''MX''' symbols are used to indicate applicability.


There is some more information on [[Webtag Applicability|Web tag Applicability page]].
'''For other weather stations''', the main sensor is what is reported for current value, daily extremes, and longer period extreme records.  This temperature is also used for calculation of derived values such as Australian Apparent Temperature, Canadian Humidity Index, and USA Heat Index.


== Why does MX talk about tokens? ==
== Why does MX talk about tokens? ==
Line 82: Line 86:
MX uses a '''token parser''' to read the web tags and replace them with the correct value, so if diagnostic output refers to tokens, it is saying the attempt to actually work out what content to return to replace the web tag with its tag name and parameters has encountered a problem.
MX uses a '''token parser''' to read the web tags and replace them with the correct value, so if diagnostic output refers to tokens, it is saying the attempt to actually work out what content to return to replace the web tag with its tag name and parameters has encountered a problem.


=GENERAL TIP=


The web tags available in the version/build you are using, can be listed (in Cumulus 1 or Cumulus MX) by adding the following line to [[Cumulus.ini#Section:_Station|Cumulus.ini]] in the [station] section...
==Scary statistics==


ListWebTags=1
# The 3.5.0 release of MX defines 9½ million values that can be represented using '''web tags'''!
# At 3.5.0, there are only 717 options for the '''tag_name''' in the general format given above.
# How come this discrepancy?
# That discrepancy is purely because some of those 717 tag names can be associated with input parameters, (and for Oregon Scientific stations,you can select which sensor is used for outside temperature), these modifications affect what value is selected to be output by the web tag leading to the large number
# These millions of web tags can actually produce billions of different outputs!
# How come this second discrepancy?
# Well adding all possible different output parameters generates the billions of different ways to output the millions of values!
The statistics quoted above keep increasing as MX is developed, the last time I checked, there were another forty or so tag names, and lots more parameters, so the alternatives are probably well over ten billion now.


Then start Cumulus and it will create a file called WebTags.txt in the same folder as where the executable is found. That file will list all the tags your build of Cumulus can currently generate. This list only contains the tag_names, it does not indicate what parameters they can take, nor does it include the brackets the tag name is surrounded by when you quote it in a template file for Cumulus to process.
== Brief history of this page==


An example of the output for an early MX version is at the end of this page (the actual output does not include commas, and has just one item per line, it has been compressed for inclusion in this article).
This page was created in August 2009, to list the tags for the (legacy) Cumulus 1 software.  Initially, there were going to be further pages to explain individual web tags, e.g. [[Forecast_webtag]]; but that idea was never completed.


To stop Cumulus continuing to produce new versions of that file change the line to say ...
When MX came out of beta (3.0.0), it has been developing rapidly, as the statistics above suggest, the number of web tag names and input/output modification parameters, to document became too much for one Wiki page, hence the moving of all documentation about modification parameters to a sub-page.  There are still a lot of web tag names to document on this page, and separation into a number of pages was considered, but it is easier to have just one page to refer in answers to questions raised in the forum.
 
==What is a web tag? ==
 
Put simply, a web tag is included in a [[Cumulus template file]] to indicate where Cumulus should insert values when it produces an output file. The concept of [[Customised_templates#What_is_meant_by_.27Cumulus_processes_templates.27|processing templates]] is explained in another article.
 
===Template files can create many types of file===
 
The output file can be:
* a [[Customised_templates#HTML_5_-_a_very_quick_guide_to_structure|web page]],
* a  [[Php_webtags#Option_3:_JavaScript_Object_Notation|JavaScript Object Notation (.json) file]]
* a [[Feels_Like#HTML_code_to_translate_web_tags_to_JavaScript_variables_.28as_modified_for_additional_parameters.29|JavaScript file]],
* a [[PHP]] script file, or
*a [[Xml_webtags|eXtensible Mark-up Language (XML)]] file.
 
 
 
.
 
==Still got questions?==
 
Full support is available via the support forum at https://cumulus.hosiene.co.uk/viewforum.php?f=40 for the latest MX release. Given that some users may still be running an older MX release, where possible any web tag listed below for MX indicates at which release it first became available.
 
There is limited support available for Cumulus 1.9.4, but on this page every attempt is made to indicate which version of the legacy software introduced any web tag listed below as being available in the legacy software.  


ListWebTags=0


{{Version badge 1}}If you are using Cumulus 1, each build of that contains a build specific version of Cumulus Help, and within that help is a list of web tags with basic information on what each tag_name returns.
[[File:Badge vMx.png]] MX bug: The inclusion of a web tag in the list produced by this instruction, does not mean that web tag is actually populated with valid information. See https://cumulus.hosiene.co.uk/viewtopic.php?p=153096#p153096 for an example.




Line 109: Line 138:
This is meant for services either on the same computer as Cumulus or on your local network. It is not secure, and should not be available, nor requested, via any external network or the internet.
This is meant for services either on the same computer as Cumulus or on your local network. It is not secure, and should not be available, nor requested, via any external network or the internet.


The [[MX Administrative Interface]] uses some application programming interface (api) calls to obtain the data each web page in that interface needs, and another api to return the results of any edit made. If you wanted your '''CumulusMX/interface/todayyest.html''' web page to include something else (e.g. snow falling/lying/depth) you would edit that HTML page to have the extra sub-table you want (you cannot extend the existing rainfall table as that is dynamically created by existing api) and you would edit the associated JavaScript file '''CumulusMX/interface/js/todayyest.js''' to add a new api call seeking snowdepth, snowfalling, snowlying tags for today (unfortunately there are no tags for yesterday's snow) and to place the returned values into your new sub-table (probably using jQuery to make it easy). In a similar way, you could add anything where today and yesterday tags are available such as UV Index.
The [[Cumulus_MX_Local_API|MX Administrative Interface]] uses some application programming interface (api) calls to obtain the data each web page in that interface needs, and if you are making an edit, another api to return the results of any edit made.  
 
If you wanted your '''CumulusMX/interface/todayyest.html''' web page to include something else (e.g. snow falling/lying/depth) you could edit that HTML page to have the extra sub-table you want (you cannot edit the existing rainfall table as that is dynamically created by existing api). Then you could edit the associated JavaScript file '''CumulusMX/interface/js/todayyest.js''' to add a new api call seeking snowdepth, snowfalling, snowlying tags for today (unfortunately there are no tags for yesterday's snow) and to place the returned values into your new sub-table (probably using jQuery to make it easy). In a similar way, you could add anything where today and yesterday tags are available such as UV Index.


In earlier versions of Cumulus if you wanted to make use of values processed by Cumulus, you wrote a script file referencing the web tags you wanted to use, and let Cumulus process that file at an interval set in the settings, then you had to write something to process the results at the relevant interval. Now if you are running other software on your device that runs MX (or a computer or other device linked directly on your personal network), you can request web tags values on demand via an application programming interface (api hereafter) and don't need to worry about any timing issues.  
In earlier versions of Cumulus if you wanted to make use of values processed by Cumulus, you wrote a script file referencing the web tags you wanted to use, and let Cumulus process that file at an interval set in the settings, then you had to write something to process the results at the relevant interval. Now if you are running other software on your device that runs MX (or a computer or other device linked directly on your personal network), you can request web tags values on demand via an application programming interface ('''api''' hereafter) and don't need to worry about any timing issues.  


Obviously each api request creates a processing overhead on Cumulus so use this feature wisely (minimise the information you request and minimise the frequency of requesting it). You can use it for extra current information, but in that usage you might need to repeat the call. Consequently, maybe it is more likely that the api will be used to request information that does not keep changing, such as what units are being used for temperature, rainfall, and wind speed; or perhaps daily, monthly, or yearly, summary figures.  
Obviously each api request creates a processing overhead on Cumulus so use this feature wisely (minimise the information you request and minimise the frequency of requesting it). You can use it for extra current information, but in that usage you might need to repeat the call. Consequently, maybe it is more likely that the api will be used to request information that does not keep changing, such as what units are being used for temperature, rainfall, and wind speed; or perhaps daily, monthly, or yearly, summary figures.  
Line 198: Line 229:
{{Template:WorkInProgressBanner}}
{{Template:WorkInProgressBanner}}


Here follow tables indicating what web tags are available to be used, tables group them by the basic purpose of the tags listed.
Here follow tables indicating what web tag names are available to be used, tables group them by the basic purpose of the tags listed.


== System ==
== System ==
Line 409: Line 440:
|-
|-
| <#Option_useApparent>
| <#Option_useApparent>
| Whether user has prefers to see Apparent Temperature or Feels Like Temperature
| Whether user prefers to see Apparent Temperature or Feels Like Temperature
|-
|-
| <#Option_showSolar>
| <#Option_showSolar>
Line 415: Line 446:
|-
|-
| <#Option_showUV>
| <#Option_showUV>
| Whether user wants to show Ulta Violet data or does not not have a UV sensor
| Whether user wants to show Ultra Violet data or does not not have a UV sensor
|}
|}


Line 571: Line 602:
==Current Conditions==
==Current Conditions==


The web tags/token shown here are mainly determined by which appear on "Now" page (index.htm).
Cumulus software makes current values available for a standard range of sensors where the same web tags apply across a range of weather station models.
Rainfall this month and this year are included here for consistency with supplied web templates (indexT.htm, thismonthT.htm, and thisyearT.htm) and with the dashboard 'Now' part of the Cumulus MX user; although you might expect to find them listed in tables for this month and this year, those web pages do not show these derivatives.
 
Cumulus 1 and MX offer current values from some extra temperature and relative humidity sensors (see [[Extra temperatures]]) frm particular weather station models  (from Davis and Oregon Scientific).
 
Recently, MX has been developed to support further extra sensors (see [[Extra Sensor Files]] page for full list of fields) and web tags have been added to support current values only.
 
==== Feels Like ====
 
Feels like temperature was first made available, just for current conditions at MX version 3.5.4.  In version 3.6.0. it was extended to add max/min for each day, each month, each year, and all time. In version 3.6.11 it was added to recent history.
 
 
The figures quoted for this derivative vary between versions:
* The first formula was used from MX version 3.5.4 (25 Apr 2020) build 3075 until version 3.6.7 (4 June 2020) build 3083
* The second formula, which was coded incorrectly, and so gave strange results, applied in versions 3.6.8 to 3.6.9 (build 3084, 3085)
* The third, and hopefully final, formula applies from version 3.6.10 (build 3086).
 
A php script for adding feels like as calculated in version 3.6.10 to any standard log line created either without feels like, or with an older (now incorrect) calculation, can be downloaded from [https://cumulus.hosiene.co.uk/viewtopic.php?f=18&t=18096 Create Missing topic on support forum]. Obviously, this calculates from the small sub-set of current conditions that have been logged, and is not as accurate at deriving maximum and minimum as derivation made as each reading is processed by MX (so including all current conditions).
 
The [[Calculate_Missing_Values#CreateMissing.exe| Create Missing utility]] will not correct the older (incorrectly calculated) figures, but will add Feels Like temperature values to any standard log line created by Cumulus 1, by MX prior to release 3.5.4, or if you have imported lines into the log from an external source.
 
===Standard sensors===
 
The web tags shown here are mainly determined by which appeared on the original "Now" legacy web page (index.htm).
 
Consequently, the totals for Rainfall this month, and this year, are included here for consistency with supplied web templates (indexT.htm, thismonthT.htm, and thisyearT.htm) and with the dashboard 'Now' part of the Cumulus MX user; although you might expect to find them listed in tables for this month and this year, those web pages do not show these derivatives.
   
   
Those listed here cover both measurements obtained from a weather station (like air temperature, wind speed and direction, humidity and barometric pressure); and all the derived values (like humidex, feels like, apparent temperature, wind chill and heat index).
Those listed here cover both measurements obtained from a weather station (like air temperature, wind speed and direction, humidity and barometric pressure); and all the derived values (like humidex, feels like, apparent temperature, wind chill, and heat index).


Note however, that the derived values calculated for Cumulus 1 and for MX may not agree, see derived value section within Recent History tags section for examples.
Note however, that the derived values calculated for Cumulus 1 and for MX may not agree because of differences in the calculation formulae, see derived value section within Recent History tags section for examples.
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
Line 586: Line 640:
|<#temp>
|<#temp>
|The outside (air) temperature
|The outside (air) temperature
For Oregon Scientific models like WMR-200 with USB connection, please refer to [[#Web tags mentioning (outside) temperature]] because any of the [[#Extra Sensors: Davis models and Oregon Scientific WMR928, WR100/200|extra sensors]] can be reported in '''<#temp>''', and consequently also have web tags reporting daily extremes and longer period extreme records.
|-
|-
|<#intemp>
|<#intemp>
Line 617: Line 673:
|{{Version badge 1}} Not available in Cumulus 1.
|{{Version badge 1}} Not available in Cumulus 1.


[[File:Badge vMx.png]]Not available in all MX versions. Please see sub-section below this table regarding availability by MX versions if you are using a MX version earlier than 3.6.10.
[[File:Badge vMx.png]]Not available in all MX versions. Please see [[#Feels_Like|sub-section before this table]] regarding availability by MX versions if you are using a MX version earlier than 3.6.10.


The current [[Feels_Like|Feels Like]] temperature.  The referenced page in weather terminology section of this Wiki explains it.
The current [[Feels_Like|Feels Like]] temperature.  The referenced page in weather terminology section of this Wiki explains it.
Line 826: Line 882:
|The same as <#currcond> but also has all characters above (decimal base) code 159 encoded as HTML entities for example this would encode any use of symbol for degree.
|The same as <#currcond> but also has all characters above (decimal base) code 159 encoded as HTML entities for example this would encode any use of symbol for degree.
|}
|}
==== Feels Like ====
Feels like temperature was first made available, just for current conditions at MX version 3.5.4.  In version 3.6.0. it was extended to add max/min for each day, each month, each year, and all time. In version 3.6.11 it was added to recent history.
The figures quoted for this derivative vary between versions:
* The first formula was used from MX version 3.5.4 (25 Apr 2020) build 3075 until version 3.6.7 (4 June 2020) build 3083
* The second formula, which was coded incorrectly, and so gave strange results, applied in versions 3.6.8 to 3.6.9 (build 3084, 3085)
* The third, and hopefully final, formula applies from version 3.6.10 (build 3086).


A php script for adding feels like as calculated in version 3.6.10 to any standard log line created either without feels like, or with an older (now incorrect) calculation, can be downloaded from [https://cumulus.hosiene.co.uk/viewtopic.php?f=18&t=18096 Create Missing topic on support forum]. Obviously, this calculates from the small sub-set of current conditions that have been logged, and is not as accurate at deriving maximum and minimum as derivation made as each reading is processed by MX (so including all current conditions).
===Extra Sensors===


==Extra Sensors==
Some tags are only available for certain builds, if the tables below do not say which releases they apply to, see general tip at top of page to check for the build you are using. In particular Cumulus 1 has fewer channels available in its earlier versions, and the final legacy software version 1.9.4 offers just 42 of the 62 extra sensor web tags available in MX.


===Extra Sensors Davis (and a few others)===
The extra sensors functionality in Cumulus only supports processing for current spot values as read from the sensors, the only processing is to convert the units ready for output, so only current conditions can be reported in web tags.


These web tags hold current values for additional sensors supported by Cumulus. Most of the tags in this section relate to Davis stations, but not exclusively.
Periodically spot extra sensor values are logged, see the [[Extra_Sensor_Files]] page for information about log files from where you can extract the past spot values.


Some tags are only available for certain builds, see general tip at top of page to check for the build you are using. In particular Cumulus 1 has fewer channels available.
====Extra Sensors: Davis models and Oregon Scientific WMR928, WR100/200 ====


There are no web tags for past values from extra sensors, see the [[Extra_Sensor_Files]] page for information about log files from where you can extract those values.
These web tags hold current values for additional sensors supported by Cumulus 1 and MX.  


For Oregon Scientific model like WMR-200 with USB connection, please refer to [[#Web tags mentioning (outside) temperature]] because any of the extra temperature tags below can be redirected to '''<#temp>''', and consequently also have web tags reporting daily extremes and longer period extreme records.
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
Line 915: Line 963:
|}
|}


====Extra Sensors:  Davis AirLink ====
New from version 3.9.0. Not available for earlier MX, not available for Cumulus 1.


 
Note, that you can configure an Indoor or Outdoor (or both) AirLink, most people will use an outdoor. There are a similar set of tags for each device.
 
===Extra Sensors Ecowitt===
 
{{Version badge 1}} Not available in Cumulus 1.
 
[[File:Badge vMx.png]] Please see release announcements for when individual web tags become available.
 
This section applies only to those using Ecowitt GW1000 (Froggit DS1500) an interface unit that picks up various external sensors and sends the data via an application programming interface to MX which then generates the following web tags:


{| class="wikitable" border="1"
{| class="wikitable" border="1"
Line 931: Line 973:
!style="width:600px" |Function
!style="width:600px" |Function
|-
|-
|<#GW1000FirmwareVersion>
|colspan="2" style="background:lightgray;"|Particulate Matter
|{{Version badge 1}} Not available in Cumulus 1.
 
[[File:Badge vMx.png]]GW1000 firmware version string
|}
 
 
{| class="wikitable" border="1"
|-
|-
!style="width:150px"|Web tag_name
|<#AirLinkPm1[InǀOut]>
!style="width:600px"|The related description can be changed in 'strings.ini', but below are default descriptions that will be shown in the viewer/editor
|Current particulate matter of 1 μm, or less count
|-
|-
|<#AirQuality1>
|<#AirLinkPm2p5[InǀOut]>
|{{Version badge 1}} Not available in Cumulus 1.
|Currentparticulate matter of 2.5 μm, or less, count
 
|-
[[File:Badge vMx.png]] see release announcements for version availability
|<#AirLinkPm2p5_1hr[InǀOut]>
 
|Last hour average particulate matter of 2.5 μm, or less, count
Air quality 1
|-
|-
|colspan="2"|... and so on up to <#AirQuality4>
|<#AirLinkPm2p5_3hr[InǀOut]>
|Last 3 hours average particulate matter of 2.5 μm, or less, count
|-
|-
|<#LeakSensor1>
|<#AirLinkPm2p5_24hr[InǀOut]>
 
|Last 24 hours average particulate matter of 2.5 μm, or less, count
|{{Version badge 1}} Not available in Cumulus 1.
 
[[File:Badge vMx.png]] see release announcements for version availability
 
Leak sensor - 0 or 1
|-
|-
|colspan="2"|... and so on up to <#LeakSensor4>
|<#AirLinkPm2p5_Nowcast[InǀOut]>
|The 24 hour "nowcast" weighted average particulate matter of 2.5 μm, or less, count
|-
|-
|<#LightningDistance>
|<#AirLinkPm10[InǀOut]>
 
|Current particulate matter of 10 μm, or less, count
|{{Version badge 1}} Not available in Cumulus 1.
 
[[File:Badge vMx.png]] see release announcements for version availability
 
Distance to last strike (same units as wind run - miles/km/nm) (Returns 0.0 if you don't have a sensor, GW1000 api returns max value you can put in a byte - 0xFF which translates to 158.4 miles = 255 km if have sensor but no strike detected yet, so MX translates that to '----')
|-
|-
|<#LightningTime>
|<#AirLinkPm10_1hr[InǀOut]>
 
|Last hour average particulate matter of 10 μm, or less, count
|{{Version badge 1}} Not available in Cumulus 1.
 
[[File:Badge vMx.png]] see release announcements for version availability
 
Date and Time of last strike (default without output parameters is locale's short time format e.g. 18:02 or 6:02 pm, without date, but tag accepts both date and time output parameters). Returns '----' if you don't have sensor or there has not been a strike since the sensor was installed. (GW1000 api returns FFFF FFFF seconds after midnight on 01 Jan 1970, which translates to 07/02/2106 06:28:15, so MX translates that to '----')
|-
|-
|<#LightningStrikesToday>
|<#AirLinkPm10_3hr[InǀOut]>
 
|Last 3 hours average particulate matter of 10 μm, or less, count
|{{Version badge 1}} Not available in Cumulus 1.
|-
 
|<#AirLinkPm10_24hr[InǀOut]>
[[File:Badge vMx.png]] see release announcements for version availability
|Last 24 hours average particulate matter of 10 μm, or less, count
 
|-
Number of strikes since midnight, default 0
|<#AirLinkPm10_Nowcast[InǀOut]>
|The 24 hour "nowcast" weighted average particulate matter of 10 μm, or less, count
|-
|colspan="2" style="background:lightgray;"|Air Quality Index Values
|-
|<#AirLinkAqiPm2p5[InǀOut]>
|Current particulate matter of 2.5 μm, or less AQI value - allows use of the "dp=n" and "tc=y" parameters
|-
|-
|<#UserTemp1>  
|<#AirLinkAqiPm2p5_1hr[InǀOut]>
 
|Last hour average particulate matter of 2.5 μm, or less, AQI value - allows use of the "dp=n" and "tc=y" parameters
|{{Version badge 1}} Not available in Cumulus 1.
 
[[File:Badge vMx.png]] see release announcements for version availability
 
User Temperature 1
support for the Ecowitt WH34 (other model types exist and are reported here as if WH34) soil and water temperature sensors
|-
|-
|colspan="2"|... and so on up to <#UserTemp8> = User temperature 8
|<#AirLinkAqiPm2p5_3hr[InǀOut]>
|}
|Last 3 hour average particulate matter of 2.5 μm, or less, AQI value - allows use of the "dp=n" and "tc=y" parameters
 
 
Ecowitt stations are sold under other names depending on nation,  e.g. Ambient in USA, Froggit in central Europe, so Ecowitt is used as a generic name in same way as Fine Offset is used elsewhere in this article.
 
==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. 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. 
*The input modification parameters available are listed at [[Webtags/Parameters#Input Modification Parameters for Recent History]].
**To save you looking up the details, these input parameters specify how many minutes ago is required. Instead of entering a very large number for minutes, you can include separate input parameters for days, hours, and minutes, ago.
**Examples appear in the table below, with explanations
 
Following the table giving the tag names actually available, there is a section on how to derive a few more weather derivatives using a combination of the tag names shown.
 
 
===Warning when Daylight Saving Time starts or ends===
 
Note that Cumulus uses current time, read from the computer, to determine which array element it stores each value in.
 
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.
 
Hence even if you use 10am for your rollover time in summer, you will not have access to a whole hour worth of data when the clocks change
* ''when the clocks go back'', one hour has been overwritten; or
* ''when the clocks go forward'', one hour in the array simply does not exist.
 
=== Table of Recent History web tags available ===
 
 
[[#No_Commas]] versions of the array are available for use in script. If you use MX, the tag names in this table can take a [[Webtags/Parameters#Output Modification Parameter for Removing Commas|rc=y]] parameter.
 
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | Web tag_name
|<#AirLinkAqiPm2p5_24hr[InǀOut]>
!style="width:600px" | Function
|Last 24 hour average particulate matter of 2.5 μm, or less, AQI value - allows use of the "dp=n" and "tc=y" parameters
!style="width:600px" | Parameters example
|-
|-
|colspan="3" style="background:lightgray;"|Time-stamp tag
|<#AirLinkAqiPm2p5_Nowcast[InǀOut]>
|Last 24 hour "nowcast" weighted average particulate matter of 2.5 μm, or less, AQI value - allows use of the "dp=n" and "tc=y" parameters
|-
|-
|<#RecentTS>
|<#AirLinkAqiPm210[InǀOut]>
|Gives the timestamp of the data that will be returned for any other recent history tag that uses same '''d, h, and m''' parameters
|Current particulate matter of 10 μm, or less value - allows use of the "dp=n" and "tc=y" parameters
|<#RecentTS h=3 m=1 format="HH:nn"> for cumulus 1; <#RecentTS h=3 m=1 format="HH:mm"> for cumulus MX
|-
|-
|colspan="3" style="background:lightgray;"|Temperature & Humidity tags
|<#AirLinkAqiPm10_1hr[InǀOut]>
|Last hour average particulate matter of 10 μm, or less, AQI value - allows use of the "dp=n" and "tc=y" parameters
|-
|-
|<#RecentOutsideTemp>
|<#AirLinkAqiPm10_3hr[InǀOut]>
|Outside Temperature
|Last 3 hour average particulate matter of 10 μm, or less AQI value - allows use of the "dp=n" and "tc=y" parameters
| <#RecentOutsideTemp h=3 m=1>&nbsp;<#tempunit> will display the temperature at the start of the period for which <#temptrend> is calculated
|-
|-
|<#RecentWindChill>
|<#AirLinkAqiPm10_24hr[InǀOut]>
|Wind Chill  (if temperature is below 10°C or 50 °F, then the new Feels Like now available in MX (next item) will report this same value).
|Last 24 hour average particulate matter of 10 μm, or less AQI value - allows use of the "dp=n" and "tc=y" parameters
| <#RecentWindChill d=48 m=1> reports the wind chill temperature 2 days ago
|-
|-
|<#RecentFeelsLike>
|<#AirLinkAqiPm10_Nowcast[InǀOut]>
|{{Version badge 1}} Not available in Cumulus 1.
|Last 24 hour "nowcast" weighted average particulate matter of 10 μm, or less AQI value - allows use of the "dp=n" and "tc=y" parameters
 
[[File:Badge vMx.png]] Available from version 3.6.11 (b.3087) onwards.
 
Feels Like Temperature
|<#RecentFeelsLike h=12 m=1> reports the feel like temperature 12 hours ago
|-
|-
|<#RecentHumidex>
|colspan="2" style="background:lightgray;"|Stats Values
|{{Version badge 1}} Not available in Cumulus 1.
 
[[File:Badge vMx.png]] Available from version 3.7.0 (build 3089) onwards.
 
Canadian Humidity Index (humidex) Dimensionless - no units
|<#RecentHumidex h=3> reports humidex 3 hours ago
|-
|-
|<#RecentDewPoint>
|<#AirLinkPct_1hr[InǀOut]>
|Dew Point
|Percentage of possible values that were included in the 1 hour averages
| <#RecentDewPoint h=25> reports the dew point temperature just over a day ago
|-
|-
|<#RecentHeatIndex>
|<#AirLinkPct_3hr[InǀOut]>
|Heat Index
|Percentage of possible values that were included in the 3 hour averages
| <#RecentHeatIndex m=121> reports the heat index about 2 hours ago
|-
|-
|<#RecentHumidity>
|<#AirLinkPct_24hr[InǀOut]>
|Relative Humidity
|Percentage of possible values that were included in the 24 hour averages
| 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)
|-
|-
|colspan="3" style="background:lightgray;"|Wind
|<#AirLinkPct_1hr[InǀOut]>
|Percentage of possible values that were included in the 24 hour weighted averages
|-
|-
|<#RecentWindSpeed>
|colspan="2" style="background:lightgray;"|Sensor Info
|Wind Speed
| <#RecentWindSpeed m=10> will display the average wind speed 10 minutes ago
|-
|-
|<#RecentWindGust>
|<#AirLinkFirmwareVersion[InǀOut]>
|Wind Gust
|Shows the AirLink firmware version as a date string.
 
NOTE: This web tag requires a WeatherLink Pro subscription to work
(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>
|<#AirLinkTemp[InǀOut]>
|Wind Latest. Note: Wind 'Speed', 'Gust' and 'Latest' have the usual Cumulus meanings
|The sensors internal temperatue value
| 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>
|<#AirLinkHum[InǀOut]>
|Wind Direction (instantaneous)
|The sensors internal humidity value
| <#RecentWindDir m=10> will tell you which direction the wind was blowing from 10 minutes ago
|-
|-
|<#RecentWindAvgDir>
|<#AirLinkWifiRssi[InǀOut]>
|Wind Direction (average)
|The sensors WiFi signal strength in dB - anything below -90 is considered very poor.
|<#RecentWindAvgDir d=6> will say what the calculated average wind direction was at this time at the start of the week
NOTE: This web tag requires a WeatherLink Pro subscription to work
|-
|colspan="3" style="background:lightgray;"|Pressure
|-
|<#RecentPressure>
|Sea-level Pressure
| <#RecentPressure h=3 m=1> gives the sea level pressure when <#presstrendval> started tracking the pressure
|-
|colspan="3" style="background:lightgray;"|Rainfall
|-
|<#RecentRainToday>
|Daily rain total from last roll-over to specified time
| 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)
|-
|colspan="3" style="background:lightgray;"|Solar & UV
|-
|<#RecentSolarRad>
|Solar Radiation
| 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)
|-
|<#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)
|}
|}


=== Other weather derivatives ===


Although Humidex, 'Apparent Temperature', 'Feels Like temperature' and others listed in Current Conditions section, are not available at all versions, they can be calculated in a script from recent 'outside temperature', 'wind speed', and 'relative humidity' values (using the same time selection for all). There are other derivatives that can be calculated similarly from a set of simultaneous values. Note that Cumulus 1 and MX do not always use identical formula, and although MX added Feels Like it has changed the formula a few times.


The relevant formulae using JavaScript, adjust for other languages, for some of these are shown below:
====Extra Sensors: Ecowitt====


==== Canadian Humidity Index ====
Ecowitt stations are sold under other names depending on nation,  e.g. Ambient in USA, Froggit in central Europe, so Ecowitt is used as a generic name in same way as Fine Offset is used as a generic name for stations sold under a variety of branding, in this Wiki.


If you are in USA and use Fahrenheit instead of Celsius, you will need to omit the 5/9 term, but as the index is dimensionless no other conversion is needed. This example is for 3 hours ago, change the input parameters to suit your need.
{{Version badge 1}} Not available in Cumulus 1..


Cumulus 1:
=====Extra Sensors: Ecowitt WH45 CO₂ sensor=====


H = <#RecentOutsideTemp h=3> + 5/9 * (6.1094 * Math.exp(5417.753 *(1/273.16 - 1/ (273.16 + <#RecentDewPoint h=3> )))-10);
[[File:Badge vMx.png]] Unless otherwise indicated these web tags become available from release 3.9.5.


Cumulus MX:
<big>THE INFORMATION HERE IS TAKEN FROM RELEASE ANNOUNCEMENTS THAT DO NOT EXPLAIN WHAT THESE WEB TAGS REPORT


svp = 6.112 * Math.exp((17.62 * <#RecentOutsideTemp h=3) / (243.12 + parseFloat(<#RecentOutsideTemp h=3)));
PLEASE WOULD SOMEBODY WHO UNDERSTANDS THIS TERMINOLOGY UPDATE THE FOLLOWING TABLE</big>
H = (5/9 * (<#RecentHumidity h=3> /100 * svp - 10)) + <#RecentOutsideTemp h=3;


==== Apparent Temperature and Feels Like ====
{| class="wikitable" border="1"
|-
!style="width:150px" |Web tag_name
!style="width:600px" |Function
|-
| <#CO2-pm2p5>
| Air Quality expressed in terms of particulate matter of 2.5 micrometres or less
|-
| <#CO2-pm2p5-24h>
| Air Quality expressed in terms of particulate matter of 2.5 μm, or less, Last 24 hours average


Note this apparent temperature formula uses Celsius for temperature and '''metres per second''' for wind speed. You will need to do the appropriate conversions from the quoted recent history tags if you use different units. The Australian Apparent temperature formula is same for Cumulus 1 and MX:
  WILL SOMEBODY WHO KNOWS UPDATE THIS ENTRY AND OTHERS
|-
| <#CO2-pm10>
| Air Quality expressed in terms of particulate matter of 10 μm, or less
|-
| <#CO2-pm10-24h>
| Air Quality expressed in terms of particulate matter of 10 μm, or less, Last 24 hours average


var actualVaporPress = <#RecentHumidity h=3>/100) * 6.105 * Math.exp(17.27 * <#RecentOutsideTemp h=3>) / (237.7 + parseFloat(<#RecentOutsideTemp h=3>))));
WILL SOMEBODY WHO KNOWS UPDATE THIS ENTRY AND OTHERS
var appTempDegC = parseFloat(<#RecentOutsideTemp h=3) + (0.33 * actualVaporPress) - (0.7 * <#RecentWindSpeed h=3>) - 4;
|-
| <#CO2-temp>
| Temperature as reported by Air Quality monitor
|-
| <#CO2-hum>
| Relative Humidity as reported by Air Quality monitor
|}


Feels Like was implemented as a recent history web tag at version 3.6.11 (see [[#Feels_Like|Feels Like section below Current condition web tags]]) for the gradual introduction of feels like elsewhere. For earlier MX versions, and if you are using Cumulus 1, you can calculate it:
=====Extra Sensors: Ecowitt WH34 soil and water sensor=====


The formulas below use Celsius for temperature and '''km per hour''' for wind speed. Again, you will need to do the appropriate conversions from the quoted recent history tags if you use different units.
Cumulus MX can support the Ecowitt WH34 (other model types exist and are reported here as if WH34) soil and water temperature sensors.


Calculation from recent history tags is much more complicated because there are 3 different calculations: Feels Like reports exactly same as wind chill for temperatures '''below''' 10°C or 50°F so the WC here should equal <#RecentWindChill h=3>:
They are reported as "User Temperture 1" to "User Temperature 8", as listed in the table within next sub-section.
<pre>if(<#RecentWindSpeed h=3> < 4.828) WC =  <#RecentOutsideTemp h=3>;
else{
wind_pow =  Math.pow(<#RecentWindSpeed h=3>, 0.16);
WC = (13.12 + 0.1625 * <#RecentOutsideTemp h=3>) - (11.37 * wind_pow) + (0.3965 * <#RecentOutsideTemp h=3> * wind_pow);// Brackets used to ensure "+" is interpreted as addition not concatenation
} </pre>


For temperatures '''above''' 20°C or 68°F Feels Like uses a different way to calculate apparent temperature that it uses at these higher temperatures (this formula only used for 3.6.10 onwards):
<pre>var actualVaporPress = <#RecentHumidity h=3>/100) * 6.112* Math.exp((17.62 * <#RecentOutsideTemp h=3>)/(243.12 + <#RecentOutsideTemp h=3>)) / 10.0;  // Not same as at build 3084
/* uses kilometres per hour for wind speed */
/*  What Cumulus MX will use to calculate apparent temperature for feels like is changed very slightly */
if(<#RecentWindSpeed h=3> > 72) <#RecentWindSpeed h=3> =72;
AT= (1.04 * <#RecentOutsideTemp h=3>) + (2 * actualVaporPress) - (0.1805553 * <#RecentWindSpeed h=3>) - 2.7;</pre>


For in-between temperatures it uses a more complicated merge of the two formulas for AT and WC as defined above:
=====Extra Sensors: Ecowitt Air quality, leak sensors, lighting detector, and extra temperature sensors=====
<pre>app_temp_mult = (<#RecentOutsideTemp h=3> - 10) / 10;
{{Version badge 1}} Not available in Cumulus 1.
wind_chill_mult = 1 - app_temp_mult;


FL= AT * app_temp_mult + WC * wind_chill_mult;</pre>
[[File:Badge vMx.png]] Please see release announcements for when individual web tags became available


==Today==
This sub-section applies only to those using Ecowitt GW1000 (also Froggit DS1500, and other equivalents, see [[Supported Devices]]) an interface unit that picks up various external sensors and sends the data via an application programming interface to MX which then generates the following web tags:
{| class="wikitable" border="1"
|-
!style="width:150px" |Web tag_name
!style="width:600px" |Function
|-
|<#GW1000FirmwareVersion>
|GW1000 firmware version string
|}


Cumulus MX provides more web tags than the original (now legacy) Cumulus software.  Please see individual entries for what is available in the flavour you are using. Where known, the actual release that introduces a particular web tag is indicated, but if you are using an old release please [[Webtags#GENERAL_TIP|see here]] for how to check which web tags are available.


===Weather Diary===
{| class="wikitable" border="1"
 
|-
Meteorologists report snowfall, and snow days, on a calendar day basis (i.e. midnight to midnight), and Cumulus software enables this by allowing you to declare the '''SnowDepthHour''' time (in [[Cumulus.ini#Section:_Station]], default is 9 a.m. for Cumulus 1, and default is midnight for MX).
!style="width:150px"|Web tag_name
 
!style="width:600px"|The related description can be changed in 'strings.ini', but below are default descriptions that will be shown in the viewer/editor
However, Cumulus software also allows you to choose one of 3 meteorological days:
|-
# starting at 9:00 am, based on winter time, so switching to 10:00 during Daylight Saving (summer) time, or
|<#AirQuality1>
# starting at 9:00 am, all year round, or
| Air quality 1
# aligned with calendar days.
|-
 
|colspan="2"|... and so on up to <#AirQuality4>
For MX users who choose options 1, and 2, with the MX default for snow depth, there is a mismatch between the times for the web tags in the two tables below. The mismatch will also cause problems if you use any End of Day actions, such as using web tags for either a [[MX_Administrative_Interface#Another_daily_summary_table|custom database table update]], or for [[Cumulus.ini#MQTT|MQTT messages]]. For the original Cumulus 1 software, only one web tag is available, but by default this has a mismatch if you use midnight-midnight days; this was intentional as Steve Loft assumed you would record the snow depth at 9 a.m. rather than midnight even if your rollover is at midnight!
|-
 
|<#LeakSensor1>
An alternative approach is to use a script to read the [[Weather Diary]], so you know that your output is for the right day.
|Leak sensor - 0 or 1  
 
This first table lists all the web tags available for reporting what is recorded in the weather diary. Just to be clear, the web tags shown below, will report data for previous day if the current time is before the snow depth hour setting, and report data for the current day if the current time matches the snow depth hour or is later.
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | Web tag_name
|colspan="2"|... and so on up to <#LeakSensor4>
!style="width:650px" | Function
|-
|-
|<#snowdepth>
|<#LightningDistance>
|Meteorologists report snow depth in cm, so this is default unit for Cumulus.
|Distance to last strike (same units as wind run - miles/km/nm) (Returns 0.0 if you don't have a sensor, GW1000 api returns max value you can put in a byte - 0xFF which translates to 158.4 miles = 255 km if have sensor but no strike detected yet, so MX translates that to '----')
 
If there is no entry in Weather Diary for the day explained above, reports zero.
 
{{Version badge 1}} Input and output is always as integer. Available from very early builds, weather diary input amended from version 1.8.6 14th April 2009 to allow units to be specified on diary edit screen. If you choose to enter as whole millimetres,  you can use JavaScript (or another script language) on your web page to divide the web tag by 10 and get centimetres to 1 decimal place on output.  
 
[[File:Badge vMx.png]] Input is to 2 decimal places. Available from version 3.1.1 - build 3054 when weather diary editor was added to MX.  MX allows output in centimetres with decimal places without any script. You can't change the units shown in admin interface, but your value can be input as inches to 2 decimal places if you ignore "cm" that is displayed in that interface.
|-
|-
|<#snowlying>
|<#LightningTime>
|{{Version badge 1}}Although this tag is not available in Cumulus 1, your web page can use a script to check if <#snowdepth> is non zero, as that means snow is lying
|Date and Time of last strike (default without output parameters is locale's short time format e.g. 18:02 or 6:02 pm, without date, but tag accepts both date and time output parameters). Returns '----' if you don't have sensor or there has not been a strike since the sensor was installed. (GW1000 api returns FFFF FFFF seconds after midnight on 01 Jan 1970, which translates to 07/02/2106 06:28:15, so MX translates that to '----')
 
[[File:Badge vMx.png]] Available from version 3.1.1 - build 3054.  If there is no entry in Weather Diary for the day explained above, , this web tag returns Null. Otherwise reports 1 if tick in diary, 0 is unticked.
|-
|-
|<#snowfalling>
|<#LightningStrikesToday>
|{{Version badge 1}} Not available in Cumulus 1. There is no web page workaround, unless you write a script that reads [[Weather Diary]] and makes relevant information available on your web server.
|Number of strikes since midnight, default 0
|-
|<#UserTemp1>
|User Temperature 1
|-
|colspan="2"|... and so on up to <#UserTemp8> = User temperature 8
|}
 
==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. 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. 
*The input modification parameters available are listed at [[Webtags/Parameters#Input Modification Parameters for Recent History]].
**To save you looking up the details, these input parameters specify how many minutes ago is required. Instead of entering a very large number for minutes, you can include separate input parameters for days, hours, and minutes, ago.
**Examples appear in the table below, with explanations


[[File:Badge vMx.png]] Available from version 3.1.1 - build 3054.    If there is no entry in Weather Diary for the day explained above, , this web tag returns Null. Otherwise reports 1 if tick in diary, 0 is unticked.
Following the table giving the tag names actually available, there is a section on how to derive a few more weather derivatives using a combination of the tag names shown.
|}
 
 
===Warning when Daylight Saving Time starts or ends===
 
Note that Cumulus uses current time, read from the computer, to determine which array element it stores each value in.  
 
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.  
 
Hence even if you use 10am for your rollover time in summer, you will not have access to a whole hour worth of data when the clocks change
* ''when the clocks go back'', one hour has been overwritten; or
* ''when the clocks go forward'', one hour in the array simply does not exist.


===Today.ini===
=== Table of Recent History web tags available ===


This second table takes most of its information from the data log for today, many of these web tags are used on the supplied '''todayT.htm''' template in the "/web" folder.  If you are using MX, the today and yesterday page in the [[MX_Administrative_Interface]] shows similar information by using the [[Cumulus_MX_Local_API#Today.2FYesterday_Data|local application programming interface]].


For web tags that report values that refer to a particular time of day, there is a corresponding web tag that can give the time of day, shown in same row of table below. For those that cover whole day so far, the final column contains "n/a".
[[#No_Commas]] versions of the array are available for use in script. If you use MX, the tag names in this table can take a [[Webtags/Parameters#Output Modification Parameter for Removing Commas|rc=y]] parameter.


Please note none of the time web tags can be modified by output parameters to give a date, but they can be changed from the default time format that is 'H:mm' (24 hour clock notation without leading zero for hour) for Cumulus 1 and MX. If you are using output modifiers to change how the time is reported, be careful to use ones that work for the flavour of Cumulus you are using (H and h are same for Cumulus 1, but not for MX; nn and mm are same for Cumulus 1, but not for MX).
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | Web tag_name
!style="width:150px" | Web tag_name
!style="width:650px" | Function
!style="width:600px" | Function  
!style="width:150px" | Time tag_name
!style="width:600px" | Parameters example
|-
|-
|colspan="3" style="background:lightgray;"|Temperature & Humidity
|colspan="3" style="background:lightgray;"|Time-stamp tag
|-
|-
|<#tempTH>
|<#RecentTS>
|Today's highest temperature
|Gives the timestamp of the data that will be returned for any other recent history tag that uses same '''d, h, and m''' parameters
|<#TtempTH>
|<#RecentTS h=3 m=1 format="HH:nn"> for cumulus 1; <#RecentTS h=3 m=1 format="HH:mm"> for cumulus MX
|-
|-
|<#tempTL>
|colspan="3" style="background:lightgray;"|Temperature & Humidity tags
|Today's lowest temperature
|<#TtempTL>
|-
|-
|<#avgtemp>
|<#RecentOutsideTemp>
|The [[Average_temperature|average]] temperature so far today (calculated from all temperature readings processed by Cumulus, [[Today.ini|today.ini]] stores a cumulative aggregate and counts the number of values processed, so a division gives this output)
|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
|-
|-
|<#temprange>
|<#RecentWindChill>
|The temperature range (<#tempTH> - <#tempTL>) so far today (Cumulus calculates all these tags using Celsius values, but outputs them in your chosen units)
|Wind Chill  (if temperature is below 10°C or 50 °F, then the new Feels Like now available in MX (next item) will report this same value).
|n/a
| <#RecentWindChill d=48 m=1> reports the wind chill temperature 2 days ago
|-
|-
|<#apptempTH>
|<#RecentFeelsLike>
|Today's high apparent temperature
|{{Version badge 1}} Not available in Cumulus 1.
|<#TapptempTH>
 
|-
[[File:Badge vMx.png]] Available from version 3.6.11 (b.3087) onwards.
|<#apptempTL>
 
|Today's low apparent temperature
Feels Like Temperature
|<#TapptempTL>
|<#RecentFeelsLike h=12 m=1> reports the feel like temperature 12 hours ago
|-
|-
|<#feelslikeTH>
|<#RecentHumidex>
|[[File:Badge vMx.png]] Available from version 3.6.10  (NOT AVAILABLE IN CUMULUS 1)
|{{Version badge 1}} Not available in Cumulus 1.


Today's high feels like temperature
[[File:Badge vMx.png]] Available from version 3.7.0 (build 3089) onwards.


Please see sub-section below current conditions if you are using an earlier 3.6.x version of MX.
Canadian Humidity Index (humidex) Dimensionless - no units
|<#TfeelslikeTH>
|<#RecentHumidex h=3> reports humidex 3 hours ago
|-
|-
|<#feelslikeTL>
|<#RecentDewPoint>
|[[File:Badge vMx.png]] Available from version 3.6.10    (NOT AVAILABLE IN CUMULUS 1)
|Dew Point
 
| <#RecentDewPoint h=25> reports the dew point temperature just over a day ago
Today's low feels like temperature
|<#TfeelslikeTL>
|-
|-
|<#humidexTH>
|<#RecentHeatIndex>
|[[File:Badge vMx.png]] Available from version 3.7.0    (NOT AVAILABLE IN CUMULUS 1)
|Heat Index
 
| <#RecentHeatIndex m=121> reports the heat index about 2 hours ago
Today's high Canadian Humidity Index
 
Please see sub-section below current conditions if you are using Cumulus 1 or an earlier version of MX.
|<#ThumidexTH>
|-
|-
|<#heatindexTH>
|<#RecentHumidity>
|Today's high heat index
|Relative Humidity
|<#TheatindexTH>
| 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)
|-
|-
|<#wchillTL>
|colspan="3" style="background:lightgray;"|Wind
|Today's greatest wind chill (i.e. lowest temperature, highest wind speed)
|<#TwchillTL>
|-
|-
|<#dewpointTH>
|<#RecentWindSpeed>
|Today's highest dew point
|Wind Speed
|<#TdewpointTH>
| <#RecentWindSpeed m=10> will display the average wind speed 10 minutes ago
|-
|-
|<#dewpointTL>
|<#RecentWindGust>
|Today's lowest dew point
|Wind Gust
|<#TdewpointTL>
 
(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
|-
|-
|<#humTH>
|<#RecentWindLatest>
|Today's highest humidity
|Wind Latest. Note: Wind 'Speed', 'Gust' and 'Latest' have the usual Cumulus meanings
|<#ThumTH>
| 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)
|-
|-
|<#humTL>
|<#RecentWindDir>
|Today's lowest humidity
|Wind Direction (instantaneous)
|<#ThumTL>
| <#RecentWindDir m=10> will tell you which direction the wind was blowing from 10 minutes ago
|-
|-
|colspan="3" style="background:lightgray;"|Precipitation
|<#RecentWindAvgDir>
|Wind Direction (average)
|<#RecentWindAvgDir d=6> will say what the calculated average wind direction was at this time at the start of the week
|-
|-
|<#rrateTM>
|colspan="3" style="background:lightgray;"|Pressure
|Today's maximum rain rate
|<#TrrateTM>
|-
|-
|<#hourlyrainTH>
|<#RecentPressure>
|Today's highest hourly rain
|Sea-level Pressure
|<#ThourlyrainTH>
| <#RecentPressure h=3 m=1> gives the sea level pressure when <#presstrendval> started tracking the pressure
|-
|-
|<#RG11RainToday>
|colspan="3" style="background:lightgray;"|Rainfall
|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
|-
|-
|colspan="3" style="background:lightgray;"|Pressure
|<#RecentRainToday>
|Daily rain total from last roll-over to specified time
| 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)
|-
|-
|<#pressTH>
|colspan="3" style="background:lightgray;"|Solar & UV
|Today's highest pressure reading
|<#TpressTH>
|-
|-
|<#pressTL>
|<#RecentSolarRad>
|Today's lowest pressure reading
|Solar Radiation
|<#TpressTL>
| 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)
|-
|-
|colspan="3" style="background:lightgray;"|Wind
|<#RecentUV>
|-
|UV Index
|<#windTM>
| 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's maximum (average) wind speed
|}
|<#TwindTM>
 
|-
=== Other weather derivatives ===
|<#wgustTM>
 
|Today's maximum wind gust
Although Humidex, 'Apparent Temperature', 'Feels Like temperature' and others listed in Current Conditions section, are not available at all versions, they can be calculated in a script from recent 'outside temperature', 'wind speed', and 'relative humidity' values (using the same time selection for all). There are other derivatives that can be calculated similarly from a set of simultaneous values. Note that Cumulus 1 and MX do not always use identical formula, and although MX added Feels Like it has changed the formula a few times.
|<#TwgustTM>
|-
|<#bearingTM>
|The wind bearing at the time of today's high gust (<#wgustTM>) in degrees
|<#TwgustTM>
|-
|<#Tbeaufort>
|Today's highest wind speed, expressed in the Beaufort scale
|<#TwindTM>
|-
|<#Tbeaufortnumber>
|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
|-
| <#windAvg>
| [[File:Badge vMx.png]] (Available from release 3.12.0 onwards)


The wind run divided by time passed since rollover to express it as an average wind speed
The relevant formulae using JavaScript, adjust for other languages, for some of these are shown below:
| n/a
 
|-
==== Canadian Humidity Index ====
|<#domwindbearing>
 
|Today's dominant wind direction in degrees
If you are in USA and use Fahrenheit instead of Celsius, you will need to omit the 5/9 term, but as the index is dimensionless no other conversion is needed. This example is for 3 hours ago, change the input parameters to suit your need.
|n/a
 
|-
Cumulus 1:
|<#domwinddir>
 
|Today's dominant wind direction as compass point
H = <#RecentOutsideTemp h=3> + 5/9 * (6.1094 * Math.exp(5417.753 *(1/273.16 - 1/ (273.16 + <#RecentDewPoint h=3> )))-10);
|n/a
 
|-
Cumulus MX:
|<#Tbeaudesc>
 
|Beaufort 'description' for today's high wind speed
svp = 6.112 * Math.exp((17.62 * <#RecentOutsideTemp h=3) / (243.12 + parseFloat(<#RecentOutsideTemp h=3)));
|n/a
H = (5/9 * (<#RecentHumidity h=3> /100 * svp - 10)) + <#RecentOutsideTemp h=3;
|-
 
|colspan="3" style="background:lightgray;"|Miscellaneous
==== Apparent Temperature and Feels Like ====
|-
 
|<#ET>
Note this apparent temperature formula uses Celsius for temperature and '''metres per second''' for wind speed. You will need to do the appropriate conversions from the quoted recent history tags if you use different units. The Australian Apparent temperature formula is same for Cumulus 1 and MX:
|Today's [http://en.wikipedia.org/wiki/Evapotranspiration evapotranspiration]. Applies only to Davis stations, equipped with a solar sensor.
"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]]."
|N/A
|-
|<#heatdegdays>
|Today's [[Heat/cold_degree_days_and_Chill_hours|heating degree days]]
|n/a
|-
|<#cooldegdays>
|Today's [[Heat/cold_degree_days_and_Chill_hours|cooling degree days]]
|n/a
|-
|<#solarTH>
|Today's high solar radiation value (Solar sensor needed)
|<#TsolarTH>
|-
|<#UVTH>
|Today's high UV Index (UV sensor needed)
|<#TUVTH>
|-
|<#SunshineHours>
|Today's hours of sunshine so far. Added in Cumulus 2, then to 1.9.1 build 957, also in MX. From version 3.7.0 takes a parameter "dp=n" so the number of decimal places required can be specified
|n/a
|}


== No Commas ==
var actualVaporPress = <#RecentHumidity h=3>/100) * 6.105 * Math.exp(17.27 * <#RecentOutsideTemp h=3>) / (237.7 + parseFloat(<#RecentOutsideTemp h=3>))));
var appTempDegC = parseFloat(<#RecentOutsideTemp h=3) + (0.33 * actualVaporPress) - (0.7 * <#RecentWindSpeed h=3>) - 4;


Note that Cumulus does not use thousand separators, so the only places a comma can be used are as a field separator or as a decimal separator. Obviously it cannot be used for both. This section is for those locales where a comma is used instead of a full stop to separate the integer and decimal parts of a number. Some computer languages like JavaScript will not accept a comma being used for this purpose, and Cumulus uses JavaScript for various tasks, as do various third party web pages.  From '''version 1.9.3''' build 1045, Cumulus 1 (and MX) has provided some current conditions web tags, some today web tags, and some recent history web tags in an alternative format where (regardless of locale) the number is always output in a format that uses a decimal point. They all correspond to the same tag with 'RC' removed.
Feels Like was implemented as a recent history web tag at version 3.6.11 (see [[#Feels_Like|Feels Like section below Current condition web tags]]) for the gradual introduction of feels like elsewhere. For earlier MX versions, and if you are using Cumulus 1, you can calculate it:


===CURRENT CONDITIONS:===
The formulas below use Celsius for temperature and '''km per hour''' for wind speed. Again, you will need to do the appropriate conversions from the quoted recent history tags if you use different units.


<#RCtemp>, <#RCdew>, <#RCheatindex>, <#RChum>, <#RCinhum>, <#RCintemp>, <#RCpress>, <#RCrfall>, <#RCrrate>, <#RCwchill>, <#RCwgust>, <#RCwspeed>, <#RCwlatest>
Calculation from recent history tags is much more complicated because there are 3 different calculations: Feels Like reports exactly same as wind chill for temperatures '''below''' 10°C or 50°F so the WC here should equal <#RecentWindChill h=3>:
 
<pre>if(<#RecentWindSpeed h=3> < 4.828) WC =  <#RecentOutsideTemp h=3>;
===TODAY:===
else{
wind_pow =  Math.pow(<#RecentWindSpeed h=3>, 0.16);
WC = (13.12 + 0.1625 * <#RecentOutsideTemp h=3>) - (11.37 * wind_pow) + (0.3965 * <#RecentOutsideTemp h=3> * wind_pow);// Brackets used to ensure "+" is interpreted as addition not concatenation
} </pre>


<#RCpressTH><#RCpressTL><#RCrrateTM><#RCtempTH>, <#RCtempTL>, <#RCwgustTM>, <#RCdewpointTH>, <#RCdewpointTL>, <#RCwchillTL>, <#RCheatindexTH>, <#RCapptempTH>, <#RCapptempTL>
For temperatures '''above''' 20°C or 68°F Feels Like uses a different way to calculate apparent temperature that it uses at these higher temperatures (this formula only used for 3.6.10 onwards):
<pre>var actualVaporPress = <#RecentHumidity h=3>/100) * 6.112* Math.exp((17.62 * <#RecentOutsideTemp h=3>)/(243.12 + <#RecentOutsideTemp h=3>)) / 10.0;  // Not same as at build 3084
/* uses kilometres per hour for wind speed */
/* What Cumulus MX will use to calculate apparent temperature for feels like is changed very slightly */
if(<#RecentWindSpeed h=3> > 72) <#RecentWindSpeed h=3> =72;
AT= (1.04 * <#RecentOutsideTemp h=3>) + (2 * actualVaporPress) - (0.1805553 * <#RecentWindSpeed h=3>) - 2.7;</pre>


===RECENT HISTORY:===
For in-between temperatures it uses a more complicated merge of the two formulas for AT and WC as defined above:
<pre>app_temp_mult = (<#RecentOutsideTemp h=3> - 10) / 10;
wind_chill_mult = 1 - app_temp_mult;


<#RCRecentOutsideTemp>, <#RCRecentWindSpeed>, <#RCRecentWindGust>, <#RCRecentWindLatest>, <#RCRecentWindChill>, <#RCRecentDewPoint>, <#RCRecentHeatIndex>, <#RCRecentPressure>, <#RCRecentRainToday>, <#RCRecentUV>
FL= AT * app_temp_mult + WC * wind_chill_mult;</pre>


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 the RC tags for 'outside temperature', 'wind speed', and 'relative humidity' values. In php language this is <tt>$RCapptempCALC = round(<#temp> + (0.33 * (<#hum> / 100 * 6.105 * exp (17.27 * <#temp> / (237.7 + <#temp>) ))) - (0.7 * $wspeed) - 4.0, 2);</tt>.
==Today==


There are other derivatives that can be calculated similarly from a set of simultaneous values, as described below the recent history section.
Cumulus MX provides more web tags than the original (now legacy) Cumulus software.  Please see individual entries for what is available in the flavour you are using. Where known, the actual release that introduces a particular web tag is indicated, but if you are using an old release please [[Webtags#GENERAL_TIP|see here]] for how to check which web tags are available.


From '''version 3.5.4''' build 3075, all web tags (except indoor temperature <#intemp> where rc parameter not available until version 3.6.8 build 3084), that produc
===Weather Diary===
=== Heading text ===
e decimal number output now support the "'''rc=y'''" option. e.g. <tt><#tempYH rc=y></tt> will report yesterday's highest temperature using a full stop to separate decimal part where the locale would normally use a comma.


==Yesterday==
Meteorologists report snowfall, and snow days, on a calendar day basis (i.e. midnight to midnight), and Cumulus software enables this by allowing you to declare the '''SnowDepthHour''' time (in [[Cumulus.ini#Section:_Station]], default is 9 a.m. for Cumulus 1, and default is midnight for MX).


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!
However, Cumulus software also allows you to choose one of 3 meteorological days:
# starting at 9:00 am, based on winter time, so switching to 10:00 during Daylight Saving (summer) time, or
# starting at 9:00 am, all year round, or
# aligned with calendar days.


Many of these web tags are used on the supplied '''yesterdayT.htm''' template.
For MX users who choose options 1, and 2, with the MX default for snow depth, there is a mismatch between the times for the web tags in the two tables below. The mismatch will also cause problems if you use any End of Day actions, such as using web tags for either a [[MX_Administrative_Interface#Another_daily_summary_table|custom database table update]], or for [[Cumulus.ini#MQTT|MQTT messages]]. For the original Cumulus 1 software, only one web tag is available, but by default this has a mismatch if you use midnight-midnight days; this was intentional as Steve Loft assumed you would record the snow depth at 9 a.m. rather than midnight even if your rollover is at midnight!


If you are using MX, the today and yesterday page in the [[MX_Administrative_Interface]] shows similar information by using the [[Cumulus_MX_Local_API#Today.2FYesterday_Data|local application programming interface]].
An alternative approach is to use a script to read the [[Weather Diary]], so you know that your output is for the right day.


For web tags that refer to a particular time of day, there is a corresponding web tag that can give the time of day. Please note none of the time web tags can be modified by output parameters to give a date, but they can be changed from the default time format that is 'h:mm'.
This first table lists all the web tags available for reporting what is recorded in the weather diary. Just to be clear, the web tags shown below, will report data for previous day if the current time is before the snow depth hour setting, and report data for the current day if the current time matches the snow depth hour or is later.
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | Web tag_name
!style="width:150px" | Web tag_name
!style="width:550px" | Function
!style="width:650px" | Function
!style="width:150px" | Time
|-
|-
|colspan="3" style="background:lightgray;"|Temperature & Humidity
|<#snowdepth>
|Meteorologists report snow depth in cm, so this is default unit for Cumulus.
 
If there is no entry in Weather Diary for the day explained above, reports zero.
 
{{Version badge 1}} Input and output is always as integer. Available from very early builds, weather diary input amended from version 1.8.6 14th April 2009 to allow units to be specified on diary edit screen. If you choose to enter as whole millimetres,  you can use JavaScript (or another script language) on your web page to divide the web tag by 10 and get centimetres to 1 decimal place on output.
 
[[File:Badge vMx.png]] Input is to 2 decimal places. Available from version 3.1.1 - build 3054 when weather diary editor was added to MX.  MX allows output in centimetres with decimal places without any script. You can't change the units shown in admin interface, but your value can be input as inches to 2 decimal places if you ignore "cm" that is displayed in that interface.
|-
|-
|<#tempYH>
|<#snowlying>
|Yesterday's highest temperature
|{{Version badge 1}}Although this tag is not available in Cumulus 1, your web page can use a script to check if <#snowdepth> is non zero, as that means snow is lying
|<#TtempYH>
 
[[File:Badge vMx.png]] Available from version 3.1.1 - build 3054.  If there is no entry in Weather Diary for the day explained above, , this web tag returns Null. Otherwise reports 1 if tick in diary, 0 is unticked.
|-
|-
|<#tempYL>
|<#snowfalling>
|Yesterday's lowest temperature
|{{Version badge 1}} Not available in Cumulus 1. There is no web page workaround, unless you write a script that reads [[Weather Diary]] and makes relevant information available on your web server.
|<#TtempYL>
 
|-
[[File:Badge vMx.png]] Available from version 3.1.1 - build 3054.    If there is no entry in Weather Diary for the day explained above, , this web tag returns Null. Otherwise reports 1 if tick in diary, 0 is unticked.
|<#avgtempY>
|}
|Yesterday's average temperature
 
|n/a
===Today.ini===
 
This second table takes most of its information from the data log for today, many of these web tags are used on the supplied '''todayT.htm''' template in the "/web" folder.  If you are using MX, the today and yesterday page in the [[MX_Administrative_Interface]] shows similar information by using the [[Cumulus_MX_Local_API#Today.2FYesterday_Data|local application programming interface]].
 
For web tags that report values that refer to a particular time of day, there is a corresponding web tag that can give the time of day, shown in same row of table below. For those that cover whole day so far, the final column contains "n/a".
 
Please note none of the time web tags can be modified by output parameters to give a date, but they can be changed from the default time format that is 'H:mm' (24 hour clock notation without leading zero for hour) for Cumulus 1 and MX. If you are using output modifiers to change how the time is reported, be careful to use ones that work for the flavour of Cumulus you are using (H and h are same for Cumulus 1, but not for MX; nn and mm are same for Cumulus 1, but not for MX).
{| class="wikitable" border="1"
|-
|-
|<#temprangeY>
!style="width:150px" | Web tag_name
|The temperature range (max - min) yesterday
!style="width:650px" | Function
|n/a
!style="width:150px" | Time tag_name
|-
|-
| <#Ychillhours>
|colspan="3" style="background:lightgray;"|Temperature & Humidity
| [[File:Badge vMx.png]] (Available from release 3.12.0 onwards)
 
The Cumulative [[Heat/cold_degree_days_and_Chill_hours#Chill_Hours_and.2For_Air_Frost|Chill Hours]] as recorded at rollover (the end of meteorological yesterday)
| n/a
|-
|-
|<#apptempYH>
|<#tempTH>
|Yesterday's high apparent temperature
|Today's highest temperature
|<#TapptempYH>
|<#TtempTH>
|-
|-
|<#apptempYL>
|<#tempTL>
|Yesterday's low apparent temperature
|Today's lowest temperature
|<#TapptempYL>
|<#TtempTL>
|-
|-
|<#feelslikeYH>
|<#avgtemp>
|[[File:Badge vMx.png]] Available from version 3.6.10   (NOT AVAILABLE IN CUMULUS 1)
|The [[Average_temperature|average]] temperature so far today (calculated from all temperature readings processed by Cumulus, [[Today.ini|today.ini]] stores a cumulative aggregate and counts the number of values processed, so a division gives this output)
|n/a
|-
|<#temprange>
|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
|-
|<#apptempTH>
|Today's high apparent temperature
|<#TapptempTH>
|-
|<#apptempTL>
|Today's low apparent temperature
|<#TapptempTL>
|-
|<#feelslikeTH>
|[[File:Badge vMx.png]] Available from version 3.6.10   (NOT AVAILABLE IN CUMULUS 1)


Yesterday's high feels like temperature
Today's high feels like temperature
|<#TfeelslikeYH>
 
Please see sub-section below current conditions if you are using an earlier 3.6.x version of MX.
|<#TfeelslikeTH>
|-
|-
|<#feelslikeYL>
|<#feelslikeTL>
|[[File:Badge vMx.png]] Available from version 3.6.10    (NOT AVAILABLE IN CUMULUS 1)
|[[File:Badge vMx.png]] Available from version 3.6.10    (NOT AVAILABLE IN CUMULUS 1)


Yesterday's low feels like temperature
Today's low feels like temperature
|<#TfeelslikeYL>
|<#TfeelslikeTL>
|-
|-
|<#humidexYH
|<#humidexTH>
|[[File:Badge vMx.png]] Available from version 3.7.0     (NOT AVAILABLE IN CUMULUS 1)
|[[File:Badge vMx.png]] Available from version 3.7.0   (NOT AVAILABLE IN CUMULUS 1)


Yesterday's low Canadian Humidity Index
Today's high Canadian Humidity Index
|<#ThumidexYH>
 
Please see sub-section below current conditions if you are using Cumulus 1 or an earlier version of MX.
|<#ThumidexTH>
|-
|-
|<#heatindexYH>
|<#heatindexTH>
|Yesterday's high heat index
|Today's high heat index
|<#TheatindexYH>
|<#TheatindexTH>
|-
|-
|<#wchillYL>
|<#wchillTL>
|Yesterday's greatest wind chill (i.e. lowest temperature)
|Today's greatest wind chill (i.e. lowest temperature, highest wind speed)
|<#TwchillYL>
|<#TwchillTL>
|-
|-
|<#dewpointYL>
|<#dewpointTH>
|Yesterday's lowest dew point
|Today's highest dew point
|<#TdewpointYL>
|<#TdewpointTH>
|-
|-
|<#dewpointYH>
|<#dewpointTL>
|Yesterday's highest dew point
|Today's lowest dew point
|<#TdewpointYH>
|<#TdewpointTL>
|-
|-
|<#humYH>
|<#humTH>
|High humidity yesterday
|Today's highest humidity
|<#ThumYH>
|<#ThumTH>
|-
|-
|<#humYL>
|<#humTL>
|Low humidity yesterday
|Today's lowest humidity
|<#ThumYL>
|<#ThumTL>
|-
|-
|colspan="3" style="background:lightgray;"|Rainfall
|colspan="3" style="background:lightgray;"|Precipitation
|-
|-
|<#rfallY>
|<#rrateTM>
|The total rainfall for yesterday according to the connected weather station
|Today's maximum rain rate
|n/a
|<#TrrateTM>
|-
|-
|<#RG11RainYest>
|<#hourlyrainTH>
|The total rainfall for yesterday according to an RG-11 rain sensor configured in "Tipping Bucket" mode
|Today's highest hourly rain
|n/a
|<#ThourlyrainTH>
|-
|-
|<#rrateYM>
|<#RG11RainToday>
|Yesterday's maximum rain rate
|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
|<#TrrateYM>
| n/a
|-
|<#hourlyrainYH>
|Yesterday's highest hourly rain
|<#ThourlyrainYH>
|-
|-
|colspan="3" style="background:lightgray;"|Pressure
|colspan="3" style="background:lightgray;"|Pressure
|-
|-
|<#pressYH>
|<#pressTH>
|Yesterday's highest pressure reading
|Today's highest pressure reading
|<#TpressYH>  
|<#TpressTH>  
|-
|-
|<#pressYL>
|<#pressTL>
|Yesterday's lowest pressure reading
|Today's lowest pressure reading
|<#TpressYL>  
|<#TpressTL>  
|-
|-
|colspan="3" style="background:lightgray;"|Wind
|colspan="3" style="background:lightgray;"|Wind
|-
|-
|<#windYM>
|<#windTM>
|Yesterday's maximum (average) wind speed
|Today's maximum (average) wind speed
|<#TwindYM>
|<#TwindTM>
|-
|-
|<#wgustYM>  
|<#wgustTM>  
|Yesterday's maximum wind gust
|Today's maximum wind gust
|<#TwgustYM>
|<#TwgustTM>
|-
|-
|<#bearingYM>
|<#bearingTM>
|The wind bearing at the time of yesterday's high gust
|The wind bearing at the time of today's high gust (<#wgustTM>) in degrees
|<#TwgustYM>
|<#TwgustTM>
|-
|-
|<#Ybeaufort>
|<#Tbeaufort>  
|Yesterday's highest wind speed, expressed in the Beaufort scale
|Today's highest wind speed, expressed in the Beaufort scale
|<#TwindYM>
|<#TwindTM>
|-
|-
|<#Ybeaufortnumber>
|<#Tbeaufortnumber>
|Yesterday's high wind speed on the Beaufort scale, without a leading "F", e.g. "6"
|Today's high wind speed on the Beaufort scale, without a leading "F", e.g. "6"
|<#TwindYM>
|<#TwindTM>
|-
|<#windrun>
|The total wind run so far today
|N/A
|-
|-
|<#Ybeaudesc>
| <#windAvg>
|Beaufort 'description' for yesterday's high wind speed
| [[File:Badge vMx.png]] (Available from release 3.12.0 onwards)
|n/a
 
The wind run divided by time passed since rollover to express it as an average wind speed
| n/a
|-
|-
|<#domwindbearingY>
|<#domwindbearing>
|Yesterday's dominant wind direction in degrees
|Today's dominant wind direction in degrees
|n/a
|n/a
|-
|-
|<#domwinddirY>
|<#domwinddir>
|Yesterday's dominant wind direction as compass point
|Today's dominant wind direction as compass point
|n/a
|n/a
|-
|-
|<#windrunY>
|<#Tbeaudesc>
|The total wind run for yesterday
|Beaufort 'description' for today's high wind speed
|n/a
|n/a
|-
| <#windAvgY>>
| [[File:Badge vMx.png]] (Available from release 3.12.0 onwards)
The wind run yesterday divided by 24 hours to express it as an average wind speed
| n/a
|-
|-
|colspan="3" style="background:lightgray;"|Miscellaneous
|colspan="3" style="background:lightgray;"|Miscellaneous
|-
|-
|<#heatdegdaysY>
|<#ET>
|Yesterday's [[Heat/cold_degree_days_and_Chill_hours|heating degree days]]
|Today's [http://en.wikipedia.org/wiki/Evapotranspiration evapotranspiration]. Applies only to Davis stations, equipped with a solar sensor.
"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]]."
|N/A
|-
|<#heatdegdays>
|Today's [[Heat/cold_degree_days_and_Chill_hours|heating degree days]]
|n/a
|n/a
|-
|-
|<#cooldegdaysY>
|<#cooldegdays>
|Yesterday's [[Heat/cold_degree_days_and_Chill_hours|cooling degree days]]
|Today's [[Heat/cold_degree_days_and_Chill_hours|cooling degree days]]
|n/a
|n/a
|-
|-
|<#SunshineHoursY>
|<#solarTH>
|Yesterday's hours of sunshine so far. Added in Cumulus 2, then to 1.9.1 build 957, also in MX. From version 3.7.0 takes a parameter "dp=n" so the number of decimal places required can be specified
|Today's high solar radiation value (Solar sensor needed)
|n/a
|<#TsolarTH>
|-
|-
|<#solarYH>
|<#UVTH>
|Yesterday's high solar radiation value (Solar sensor needed)  
|Today's high UV Index (UV sensor needed)
|<#TsolarYH>
|<#TUVTH>
|-
|-
|<#UVYH>
|<#SunshineHours>
|Yesterday's high UV Index (UV sensor needed)
|Today's hours of sunshine so far. Added in Cumulus 2, then to 1.9.1 build 957, also in MX. From version 3.7.0 takes a parameter "dp=n" so the number of decimal places required can be specified
|<#TUVYH>
|n/a
|}
|}


==Monthly==
== No Commas ==


This table shows the web tags used on the '''thismonthT.htm''' web template.
Note that Cumulus does not use thousand separators, so the only places a comma can be used are as a field separator or as a decimal separator. Obviously it cannot be used for both. This section is for those locales where a comma is used instead of a full stop to separate the integer and decimal parts of a number. Some computer languages like JavaScript will not accept a comma being used for this purpose, and Cumulus uses JavaScript for various tasks, as do various third party web pages.  From '''version 1.9.3''' build 1045, Cumulus 1 (and MX) has provided some current conditions web tags, some today web tags, and some recent history web tags in an alternative format where (regardless of locale) the number is always output in a format that uses a decimal point. They all correspond to the same tag with 'RC' removed.


Because the rainfall this month does not appear on '''thismonthT.htm''' web page, it is shown in [[#Current_Conditions|indexT.htm]] table earlier in this article which is for the web page where it does appear.
===CURRENT CONDITIONS:===


The web tags in the date column output dates in the format "dd MMMM" (for once this is same for Cumulus 1 and Cumulus MX). Should you require a different output format, this can be changed using the [[#Time.2FDate_.27format.27_Parameter|format parameters]] described above. For web tags that represent daily values, there are (obviously) no corresponding time web tags, but for high and low spot values the default 'h:mm' format of the time output can be changed using output parameters. Do make sure that you get the web tag names right and the output form at parameters right.
<#RCtemp>, <#RCdew>, <#RCheatindex>, <#RChum>, <#RCinhum>, <#RCintemp>, <#RCpress>, <#RCrfall>, <#RCrrate>, <#RCwchill>, <#RCwgust>, <#RCwspeed>, <#RCwlatest>


As another example of inconsistency in how web tags added in different versions are coded, there are two web tags (highest minimum/lowest maximum temperatures) where a standard web tag is not provided by Cumulus (1 or MX) for the associated time-stamp. Consequently, for these 2 (and their corresponding tags in the this year group), there are mandatory output parameters required as shown in the table. Obviously Cumulus 1 lets you use "NN", "nn", "MM", or "mm" for the minutes, but minutes can only be represented in one way in Cumulus MX.
===TODAY:===
 
<#RCpressTH>,  <#RCpressTL>,  <#RCrrateTM>,  <#RCtempTH>, <#RCtempTL>, <#RCwgustTM>,  <#RCdewpointTH>, <#RCdewpointTL>, <#RCwchillTL>, <#RCheatindexTH>, <#RCapptempTH>, <#RCapptempTL>
 
===RECENT HISTORY:===
 
<#RCRecentOutsideTemp>, <#RCRecentWindSpeed>, <#RCRecentWindGust>, <#RCRecentWindLatest>, <#RCRecentWindChill>, <#RCRecentDewPoint>, <#RCRecentHeatIndex>, <#RCRecentPressure>, <#RCRecentRainToday>, <#RCRecentUV>
 
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 the RC tags for 'outside temperature', 'wind speed', and 'relative humidity' values. In php language this is <tt>$RCapptempCALC =  round(<#temp> + (0.33 * (<#hum> / 100 * 6.105 * exp (17.27 * <#temp> / (237.7 + <#temp>) ))) - (0.7 * $wspeed) - 4.0, 2);</tt>.
 
There are other derivatives that can be calculated similarly from a set of simultaneous values, as described below the recent history section.
 
From '''version 3.5.4''' build 3075, all web tags (except indoor temperature <#intemp> where rc parameter not available until version 3.6.8 build 3084), that produc
=== Heading text ===
e decimal number output now support the "'''rc=y'''" option. e.g. <tt><#tempYH rc=y></tt> will report yesterday's highest temperature using a full stop to separate decimal part where the locale would normally use a comma.
 
==Yesterday==
 
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!
 
Many of these web tags are used on the supplied '''yesterdayT.htm''' template.
 
If you are using MX, the today and yesterday page in the [[MX_Administrative_Interface]] shows similar information by using the [[Cumulus_MX_Local_API#Today.2FYesterday_Data|local application programming interface]].


For web tags that refer to a particular time of day, there is a corresponding web tag that can give the time of day. Please note none of the time web tags can be modified by output parameters to give a date, but they can be changed from the default time format that is 'h:mm'.
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
!style="width:150px"|Web tag_name
!style="width:150px" | Web tag_name
!style="width:300px"|Function
!style="width:550px" | Function
!style="width:150px"|Time
!style="width:150px" | Time
!style="width:150px"|Date
|-
|-
|colspan="4" style="background:lightgray;"|Temperature & Humidity
|colspan="3" style="background:lightgray;"|Temperature & Humidity
|-
|-
|<#MonthTempH>
|<#tempYH>
|This months high temperature
|Yesterday's highest temperature
|<#MonthTempHT>
|<#TtempYH>
|<#MonthTempHD>
|-
|-
|<#MonthTempL>
|<#tempYL>
|This months low temperature
|Yesterday's lowest temperature
|<#MonthTempLT>
|<#TtempYL>
|<#MonthTempLD>
|-
|-
|<#MonthMinTempH>
|<#avgtempY>
|This months highest daily minimum temperature
|Yesterday's average temperature
|[[File:badge v1.png]]<#MonthMinTempHD format=hh:nn> or <#MonthMinTempHD format=HH:mm> for Cumulus 1, 
|n/a
[[File:Badge vMx.png]] <#MonthMinTempHD format=HH:mm> for Cumulus MX
|<#MonthMinTempHD>
|-
|-
|<#MonthMaxTempL>
|<#temprangeY>
|This months lowest daily maximum temperature
|The temperature range (max - min) yesterday
|[[File:badge v1.png]]<#MonthMaxTempLD format=HH:mm> or <#MonthMaxTempLD format=hh:nn> for Cumulus 1,
[[File:Badge vMx.png]]<#MonthMaxTempLD format=HH:mm> for Cumulus MX
|<#MonthMaxTempLD>
|-
|<#MonthHighDailyTempRange>
|High Daily Temp Range
|n/a
|n/a
|<#MonthHighDailyTempRangeD>
|-
|-
|<#MonthLowDailyTempRange>
| <#Ychillhours>
|Low Daily Temp Range
| [[File:Badge vMx.png]] (Available from release 3.12.0 onwards)
|n/a
 
|<#MonthLowDailyTempRangeD>
The Cumulative [[Heat/cold_degree_days_and_Chill_hours#Chill_Hours_and.2For_Air_Frost|Chill Hours]] as recorded at rollover (the end of meteorological yesterday)
| n/a
|-
|-
|<#MonthHeatIndexH>
|<#apptempYH>
|This months high USA heat index
|Yesterday's high apparent temperature
|<#MonthHeatIndexHT>
|<#TapptempYH>
|<#MonthHeatIndexHD>
|-
|-
|<#MonthWChillL>
|<#apptempYL>
|This months greatest wind chill (i.e. lowest temperature)
|Yesterday's low apparent temperature
|<#MonthWChillLT>
|<#TapptempYL>
|<#MonthWChillLD>
|-
|-
|<#MonthAppTempH>
|<#feelslikeYH>
|This month's high apparent temperature
|[[File:Badge vMx.png]] Available from version 3.6.10    (NOT AVAILABLE IN CUMULUS 1)
|<#MonthAppTempHT>
 
|<#MonthAppTempHD>
Yesterday's high feels like temperature
|<#TfeelslikeYH>
|-
|-
|<#MonthAppTempL>
|<#feelslikeYL>
|This month's low apparent temperature
|[[File:Badge vMx.png]] Available from version 3.6.10    (NOT AVAILABLE IN CUMULUS 1)
|<#MonthAppTempLT>
 
|<#MonthAppTempLD>
Yesterday's low feels like temperature
|<#TfeelslikeYL>
|-
|-
|<#MonthFeelsLikeH>
|<#humidexYH
|This month's highest feels like temperature (available from [[File:Badge vMx.png]] 3.6.0(NOT AVAILABLE IN CUMULUS 1)
|[[File:Badge vMx.png]] Available from version 3.7.0     (NOT AVAILABLE IN CUMULUS 1)
|<#MonthFeelsLikeHT>
 
|<#MonthFeelsLikeHD>
Yesterday's low Canadian Humidity Index
|<#ThumidexYH>
|-
|-
|<#MonthFeelsLikeL>
|<#heatindexYH>
|This months lowest feels like temperature (available from [[File:Badge vMx.png]] 3.6.0)  (NOT AVAILABLE IN CUMULUS 1)
|Yesterday's high heat index
|<#MonthFeelsLikeLT>
|<#TheatindexYH>
|<#MonthFeelsLikeLD>
|-
|-
|<#MonthHumidexH>
|<#wchillYL>
|[[File:Badge vMx.png]] (Available from version 3.7.0)   (NOT AVAILABLE IN CUMULUS 1)
|Yesterday's greatest wind chill (i.e. lowest temperature)
 
|<#TwchillYL>
This month's highest Canadian Humidity Index
|<#MonthHumidexHT>
|<#MonthHumidexHD>
|-
|-
|<#MonthDewPointH>
|<#dewpointYL>
|This month's high dew point
|Yesterday's lowest dew point
|<#MonthDewPointHT>
|<#TdewpointYL>
|<#MonthDewPointHD>
|-
|<#MonthDewPointL>
|This month's low dew point
|<#MonthDewPointLT>
|<#MonthDewPointLD>
|-
|-
|<#MonthHumH>
|<#dewpointYH>
|This month's highest humidity
|Yesterday's highest dew point
|<#MonthHumHT>
|<#TdewpointYH>
|<#MonthHumHD>
|-
|-
|<#MonthHumL>
|<#humYH>
|This month's lowest humidity
|High humidity yesterday
|<#MonthHumLT>
|<#ThumYH>
|<#MonthHumLD>
|-
|-
|colspan="4" style="background:lightgray;"|Pressure
|<#humYL>
|Low humidity yesterday
|<#ThumYL>
|-
|-
|<#MonthPressH>
|colspan="3" style="background:lightgray;"|Rainfall
|This month's highest pressure
|<#MonthPressHT>
|<#MonthPressHD>
|-
|-
|<#MonthPressL>
|<#rfallY>
|This month's lowest pressure
|The total rainfall for yesterday according to the connected weather station
|<#MonthPressLT>
|n/a
|<#MonthPressLD>
|-
|-
|colspan="4" style="background:lightgray;"|Wind
|<#RG11RainYest>
|The total rainfall for yesterday according to an RG-11 rain sensor configured in "Tipping Bucket" mode
|n/a
|-
|-
|<#MonthGustH>
|<#rrateYM>
|This month's highest wind gust
|Yesterday's maximum rain rate
|<#MonthGustHT>
|<#TrrateYM>
|<#MonthGustHD>
|-
|-
|<#MonthWindH>
|<#hourlyrainYH>
|This month's highest wind speed
|Yesterday's highest hourly rain
|<#MonthWindHT>
|<#ThourlyrainYH>
|<#MonthWindHD>
|-
|-
|<#MonthWindRunH>
|colspan="3" style="background:lightgray;"|Pressure
|This month's high Daily Wind Run
|n/a
|<#MonthWindRunHD>
|-
|-
|colspan="4" style="background:lightgray;"|Rainfall
|<#pressYH>
|Yesterday's highest pressure reading
|<#TpressYH>
|-
|-
|<#MonthRainRateH>
|<#pressYL>
|This month's highest rainfall rate
|Yesterday's lowest pressure reading
|<#MonthRainRateHT>
|<#TpressYL>  
|<#MonthRainRateHD>
|-
|-
|<#MonthHourlyRainH>
|colspan="3" style="background:lightgray;"|Wind
|This month's highest hourly rain
|<#MonthHourlyRainHT>
|<#MonthHourlyRainHD>
|-
|-
|<#MonthDailyRainH>
|<#windYM>
|This month's wettest day (greatest daily rain)
|Yesterday's maximum (average) wind speed
|n/a
|<#TwindYM>
|<#MonthDailyRainHD>
|-
|-
|<#MonthLongestDryPeriod>
|<#wgustYM>  
|Longest dry period ending this month (days)
|Yesterday's maximum wind gust
|n/a
|<#TwgustYM>
|<#MonthLongestDryPeriodD>
|-
|-
|<#MonthLongestWetPeriod>
|<#bearingYM>
|Longest period of rain every day, ending this month (days)
|The wind bearing at the time of yesterday's high gust
|n/a
|<#TwgustYM>
|<#MonthLongestWetPeriodD>
|-
|-
|colspan="4" style="background:lightgray;"|Solar
|<#Ybeaufort>
 
|Yesterday's highest wind speed, expressed in the Beaufort scale
[[File:Badge vMx.png]] (Available from release 3.12.0 onwards)
|<#TwindYM>
|-
|-
| <#SunshineHoursMonth>
|<#Ybeaufortnumber>
| the total sunshine hours in month-to-date, or with [[Webtags/Parameters#Input_modification_Parameters|input modification parameters using either '''y''' and '''m''' or '''r''']] for a past month
|Yesterday's high wind speed on the Beaufort scale, without a leading "F", e.g. "6"
| n/a
|<#TwindYM>
| n/a
|}
 
==Yearly==
 
This table shows most of the web tags used on the "thisyearT.htm" web template.
 
The web tags in the date column output dates in the format "dd MMMM" (for once this is same for Cumulus 1 and Cumulus MX). Should you require a different output format, this can be changed using the [[#Time.2FDate_.27format.27_Parameter|format parameters]] described above. For web tags that represent daily values, there are (obviously) no corresponding time web tags, but for high and low spot values the default 'h:mm' format of the time output can be changed using output parameters. Do make sure that you get the web tag names right and the output form at parameters right.
 
As another example of inconsistency in how web tags added in different versions are coded, there are two web tags (highest minimum/lowest maximum temperatures) where a standard web tag is not provided by Cumulus (1 or MX) for the associated time-stamp. Consequently, for these 2 (and their corresponding tags in the this month group), there are mandatory output parameters required as shown in the table. Obviously Cumulus 1 lets you use "NN", "nn", "MM", or "mm" for the minutes, but minutes can only be represented in one way in Cumulus MX.
 
Remember that the Year-to-date runs from roll-over time on 1 January for all web tags listed here.
 
The list below does NOT include any web tags that represent seasonal derivatives, i.e. where you define the month from which they start counting. (Cumulative seasonal Chill Hours <#chillhours> and Total seasonal rainfall <#ryear> can both be found in [[Webtags#Current_Conditions|Current Conditions]]). Note, that does not imply both are included in '''indexT.htm'''.
 
 
{| class="wikitable" border="1"
|-
|-
!style="width:150px"|Web tag_name
|<#Ybeaudesc>
!style="width:300px"|Function
|Beaufort 'description' for yesterday's high wind speed
!style="width:350px"|Time
|n/a
!style="width:150px"|Date
|-
|-
|colspan="4" style="background:lightgray;"|Temperature & Humidity
|<#domwindbearingY>
|Yesterday's dominant wind direction in degrees
|n/a
|-
|-
|<#YearTempH>
|<#domwinddirY>
|This year's highest temperature
|Yesterday's dominant wind direction as compass point
|<#YearTempHT>
|n/a
|<#YearTempHD>
|-
|<#windrunY>
|The total wind run for yesterday
|n/a
|-
| <#windAvgY>>
| [[File:Badge vMx.png]] (Available from release 3.12.0 onwards)
 
The wind run yesterday divided by 24 hours to express it as an average wind speed
| n/a
|-
|-
|<#YearTempL>
|colspan="3" style="background:lightgray;"|Miscellaneous
|This year's lowest temperature
|<#YearTempLT>
|<#YearTempLD>
|-
|-
|<#YearHighDailyTempRange>
|<#heatdegdaysY>
|This year's highest Daily Temp Range
|Yesterday's [[Heat/cold_degree_days_and_Chill_hours|heating degree days]]
|n/a
|n/a
|<#YearHighDailyTempRangeD>
|-
|-
|<#YearLowDailyTempRange>
|<#cooldegdaysY>
|This year's lowest Daily Temp Range
|Yesterday's [[Heat/cold_degree_days_and_Chill_hours|cooling degree days]]
|n/a
|n/a
|<#YearLowDailyTempRangeD>
|-
|-
|<#YearHeatIndexH>
|<#SunshineHoursY>
|This year's highest USA heat index
|Yesterday's hours of sunshine so far. Added in Cumulus 2, then to 1.9.1 build 957, also in MX. From version 3.7.0 takes a parameter "dp=n" so the number of decimal places required can be specified
|<#YearHeatIndexHT>
|n/a
|<#YearHeatIndexHD>
|-
|-
|<#YearWChillL>
|<#solarYH>
|This year's greatest wind chill (i.e. lowest temperature)
|Yesterday's high solar radiation value (Solar sensor needed)  
|<#YearWChillLT>
|<#TsolarYH>
|<#YearWChillLD>
|-
|-
|<#YearAppTempH>
|<#UVYH>
|This year's highest apparent temperature
|Yesterday's high UV Index (UV sensor needed)
|<#YearAppTempHT>
|<#TUVYH>
|<#YearAppTempHD>
|}
 
==Monthly==
 
This table shows the web tags used on the '''thismonthT.htm''' web template.
 
Because the rainfall this month does not appear on '''thismonthT.htm''' web page, it is shown in [[#Current_Conditions|indexT.htm]] table earlier in this article which is for the web page where it does appear.
 
The web tags in the date column output dates in the format "dd MMMM" (for once this is same for Cumulus 1 and Cumulus MX). Should you require a different output format, this can be changed using the [[#Time.2FDate_.27format.27_Parameter|format parameters]] described above. For web tags that represent daily values, there are (obviously) no corresponding time web tags, but for high and low spot values the default 'h:mm' format of the time output can be changed using output parameters. Do make sure that you get the web tag names right and the output form at parameters right.
 
As another example of inconsistency in how web tags added in different versions are coded, there are two web tags (highest minimum/lowest maximum temperatures) where a standard web tag is not provided by Cumulus (1 or MX) for the associated time-stamp. Consequently, for these 2 (and their corresponding tags in the this year group), there are mandatory output parameters required as shown in the table. Obviously Cumulus 1 lets you use "NN", "nn", "MM", or "mm" for the minutes, but minutes can only be represented in one way in Cumulus MX.
 
{| class="wikitable" border="1"
|-
|-
|<#YearAppTempL>
!style="width:150px"|Web tag_name
|This year's lowest apparent temperature
!style="width:300px"|Function
|<#YearAppTempLT>
!style="width:150px"|Time
|<#YearAppTempLD>
!style="width:150px"|Date
|-
|-
|<#YearFeelsLikeH>
|colspan="4" style="background:lightgray;"|Temperature & Humidity
|[[File:Badge vMx.png]]This year's highest feels like temperature (available from 3.6.0)  (NOT AVAILABLE IN CUMULUS 1)
|<#YearFeelsLikeHT>
|<#YearFeelsLikeHD>
|-
|-
|<#YearFeelsLikeL>
|<#MonthTempH>
|[[File:Badge vMx.png]]This year's lowest feels like temperature (available from 3.6.0)  (NOT AVAILABLE IN CUMULUS 1)
|This months high temperature
|<#YearFeelsLikeLT>
|<#MonthTempHT>
|<#YearFeelsLikeLD>
|<#MonthTempHD>
|-
|-
|<#YearHumidexH>
|<#MonthTempL>
|[[File:Badge vMx.png]] (Available from version 3.7.0)    (NOT AVAILABLE IN CUMULUS 1)
|This months low temperature
 
|<#MonthTempLT>
This year's highest Canadian Humidity Index
|<#MonthTempLD>
|<#YearHumidexHT>
|<#YearHumidexHD>
|-
|-
|<#YearDewPointH>
|<#MonthMinTempH>
|This year's highest dew point
|This months highest daily minimum temperature
|<#YearDewPointHT>
|[[File:badge v1.png]]<#MonthMinTempHD format=hh:nn> or <#MonthMinTempHD format=HH:mm> for Cumulus 1, 
|<#YearDewPointHD>
[[File:Badge vMx.png]] <#MonthMinTempHD format=HH:mm> for Cumulus MX
|<#MonthMinTempHD>
|-
|-
|<#YearDewPointL>
|<#MonthMaxTempL>
|This year's lowest dew point
|This months lowest daily maximum temperature
|<#YearDewPointLT>
|[[File:badge v1.png]]<#MonthMaxTempLD format=HH:mm> or <#MonthMaxTempLD format=hh:nn> for Cumulus 1,
|<#YearDewPointLD>
[[File:Badge vMx.png]]<#MonthMaxTempLD format=HH:mm> for Cumulus MX
|<#MonthMaxTempLD>
|-
|-
|<#YearMinTempH>
|<#MonthHighDailyTempRange>
|This year's highest daily minimum temperature
|High Daily Temp Range
|Flavour specific mandatory output parameters:
|n/a
* <#YearMinTempHD format=HH:nn> ''for Cumulus 1'',
|<#MonthHighDailyTempRangeD>
* <#YearMinTempHD format=HH:mm> ''for Cumulus MX''
|<#YearMinTempHD>
|-
|-
|<#YearMaxTempL>
|<#MonthLowDailyTempRange>
|This year's lowest daily maximum temperature
|Low Daily Temp Range
|Flavour specific mandatory output parameters:
|n/a
* <#YearMaxTempHD format=HH:nn> ''for Cumulus 1'',
|<#MonthLowDailyTempRangeD>
* <#YearMaxTempHD format=HH:mm> ''for Cumulus MX''
 
|<#YearMaxTempLD>
|-
|-
|<#YearHumH>
|<#MonthHeatIndexH>
|This year's high humidity
|This months high USA heat index
|<#YearHumHT>
|<#MonthHeatIndexHT>
|<#YearHumHD>
|<#MonthHeatIndexHD>
|-
|-
|<#YearHumL>
|<#MonthWChillL>
|This year's low humidity
|This months greatest wind chill (i.e. lowest temperature)
|<#YearHumLT>
|<#MonthWChillLT>
|<#YearHumLD>
|<#MonthWChillLD>
|-
|-
|colspan="4" style="background:lightgray;"|Pressure
|<#MonthAppTempH>
|This month's high apparent temperature
|<#MonthAppTempHT>
|<#MonthAppTempHD>
|-
|-
|<#YearPressH>
|<#MonthAppTempL>
|This year's high pressure
|This month's low apparent temperature
|<#YearPressHT>
|<#MonthAppTempLT>
|<#YearPressHD>
|<#MonthAppTempLD>
|-
|-
|<#YearPressL>
|<#MonthFeelsLikeH>
|This year's low pressure
|This month's highest feels like temperature (available from [[File:Badge vMx.png]] 3.6.0)  (NOT AVAILABLE IN CUMULUS 1)
|<#YearPressLT>
|<#MonthFeelsLikeHT>
|<#YearPressLD>
|<#MonthFeelsLikeHD>
|-
|-
|colspan="4" style="background:lightgray;"|Wind
|<#MonthFeelsLikeL>
|This months lowest feels like temperature (available from [[File:Badge vMx.png]] 3.6.0)  (NOT AVAILABLE IN CUMULUS 1)
|<#MonthFeelsLikeLT>
|<#MonthFeelsLikeLD>
|-
|-
|<#YearGustH>
|<#MonthHumidexH>
|This year's high wind gust
|[[File:Badge vMx.png]] (Available from version 3.7.0)    (NOT AVAILABLE IN CUMULUS 1)
|<#YearGustHT>
 
|<#YearGustHD>
This month's highest Canadian Humidity Index
|<#MonthHumidexHT>
|<#MonthHumidexHD>
|-
|-
|<#YearWindH>
|<#MonthDewPointH>
|This year's high wind speed
|This month's high dew point
|<#YearWindHT>
|<#MonthDewPointHT>
|<#YearWindHD>
|<#MonthDewPointHD>
|-
|-
|<#YearWindRunH>
|<#MonthDewPointL>
This year's highest Daily Wind Run
|This month's low dew point
|n/a
|<#MonthDewPointLT>
|<#YearWindRunHD>  
|<#MonthDewPointLD>
|-
|-
|colspan="4" style="background:lightgray;"|Rainfall
|<#MonthHumH>
|This month's highest humidity
|<#MonthHumHT>
|<#MonthHumHD>
|-
|-
|<#YearRainRateH>
|<#MonthHumL>
|This year's highest rainfall rate
|This month's lowest humidity
|<#YearRainRateHT>
|<#MonthHumLT>
|<#YearRainRateHD>
|<#MonthHumLD>
|-
|-
|<#YearHourlyRainH>
|colspan="4" style="background:lightgray;"|Pressure
|This year's highest hourly rain
|<#YearHourlyRainHT>
|<#YearHourlyRainHD>
|-
|-
|<#YearDailyRainH>
|<#MonthPressH>
|This year's high daily rain
|This month's highest pressure
|n/a
|<#MonthPressHT>
|<#YearDailyRainHD>
|<#MonthPressHD>
|-
|-
|<#YearMonthlyRainH>
|<#MonthPressL>
|This year's high monthly rain
|This month's lowest pressure
|n/a
|<#MonthPressLT>
|<#YearMonthlyRainHD>
|<#MonthPressLD>
|-
|-
|<#YearLongestDryPeriod>
|colspan="4" style="background:lightgray;"|Wind
|Longest period without rain ending this year (days)
|n/a
|<#YearLongestDryPeriodD>
|-
|-
|<#YearLongestWetPeriod>
|<#MonthGustH>
|Longest period of rain every day ending this year (days)
|This month's highest wind gust
|n/a
|<#MonthGustHT>
|<#YearLongestWetPeriodD>
|<#MonthGustHD>
|-
|-
|colspan="4" style="background:lightgray;"|Solar
|<#MonthWindH>
 
|This month's highest wind speed
[[File:Badge vMx.png]] (Available from release 3.12.0 onwards)
|<#MonthWindHT>
|<#MonthWindHD>
|-
|-
| <#SunshineHoursYear>
|<#MonthWindRunH>
| the total sunshine hours in year-to-date, or with [[Webtags/Parameters#Input_modification_Parameters|input modification parameters using either '''y''' or '''r''']] for a past year
|This month's high Daily Wind Run
| n/a
|n/a
| n/a
|<#MonthWindRunHD>
|}
 
==All Time==
 
This table lists the web tags that appear in the '''recordsT.htm''' example template that is included in each release since version 1.5.1 10th January 2006.  Additional tags correctly populated from 3.6.10 (build 3086) or 3.7.0 (build 3089) are marked with a "MX" icon as they are not available in Cumulus 1. Please note the 3.6.10 release was available from 24 June 2020, if the date shown for those MX only tags is before when you installed that (or a later release), the output may show incorrect values.
 
The output from the web tags shown in the date/time column have the default format that is seen on "records.htm" in the standard web pages:
*The default format for an extreme month is to show the month name in full i.e. format 'MMMM' followed by the year in full.
*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' again ending with the year.
*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 (i.e. on the standard web page the time comes first, not as seen in admin interface).
 
You can change the default output on either the standard web template, or in your own file,  by 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. Please see examples section above for advice.
 
Note that unlike the this month and this year web tags, the time and the date are both included in the default format of the standard time-stamp web tags for the 'highest minimum' and 'lowest maximum' temperatures, yet another inconsistency!
 
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | Web tag_name
|colspan="4" style="background:lightgray;"|Rainfall
!style="width:400px" | Function
!style="width:150px" | Date/Time
|-
|-
|colspan="3" style="background:lightgray;"|Temperature & Humidity
|<#MonthRainRateH>
|This month's highest rainfall rate
|<#MonthRainRateHT>
|<#MonthRainRateHD>
|-
|-
|<#tempH>
|<#MonthHourlyRainH>
|All time high temperature
|This month's highest hourly rain
|<#TtempH>
|<#MonthHourlyRainHT>
|<#MonthHourlyRainHD>
|-
|-
|<#tempL>
|<#MonthDailyRainH>
|All time low temperature
|This month's wettest day (greatest daily rain)
|<#TtempL>
|n/a
|<#MonthDailyRainHD>
|-
|-
|<#mintempH>
|<#MonthLongestDryPeriod>
|All time high minimum temperature
|Longest dry period ending this month (days)
|<#TmintempH>
|n/a
|<#MonthLongestDryPeriodD>
|-
|-
|<#maxtempL>
|<#MonthLongestWetPeriod>
|All time low maximum temperature
|Longest period of rain every day, ending this month (days)
|<#TmaxtempL>
|n/a
|<#MonthLongestWetPeriodD>
|-
|-
|<#LowDailyTempRange>
|colspan="4" style="background:lightgray;"|Solar
|All time low daily temperature range
 
|<#TLowDailyTempRange>
[[File:Badge vMx.png]] (Available from release 3.12.0 onwards)
|-
|-
|<#HighDailyTempRange>
| <#SunshineHoursMonth>
|All time high daily temperature range
| the total sunshine hours in month-to-date, or with [[Webtags/Parameters#Input_modification_Parameters|input modification parameters using either '''y''' and '''m''' or '''r''']] for a past month
|<#THighDailyTempRange>
| n/a
| n/a
|}
 
==Yearly==
 
This table shows most of the web tags used on the "thisyearT.htm" web template.
 
The web tags in the date column output dates in the format "dd MMMM" (for once this is same for Cumulus 1 and Cumulus MX). Should you require a different output format, this can be changed using the [[#Time.2FDate_.27format.27_Parameter|format parameters]] described above. For web tags that represent daily values, there are (obviously) no corresponding time web tags, but for high and low spot values the default 'h:mm' format of the time output can be changed using output parameters. Do make sure that you get the web tag names right and the output form at parameters right.
 
As another example of inconsistency in how web tags added in different versions are coded, there are two web tags (highest minimum/lowest maximum temperatures) where a standard web tag is not provided by Cumulus (1 or MX) for the associated time-stamp. Consequently, for these 2 (and their corresponding tags in the this month group), there are mandatory output parameters required as shown in the table. Obviously Cumulus 1 lets you use "NN", "nn", "MM", or "mm" for the minutes, but minutes can only be represented in one way in Cumulus MX.
 
Remember that the Year-to-date runs from roll-over time on 1 January for all web tags listed here.
 
The list below does NOT include any web tags that represent seasonal derivatives, i.e. where you define the month from which they start counting. (Cumulative seasonal Chill Hours <#chillhours> and Total seasonal rainfall <#ryear> can both be found in [[Webtags#Current_Conditions|Current Conditions]]). Note, that does not imply both are included in '''indexT.htm'''.
 
 
{| class="wikitable" border="1"
|-
|-
|<#apptempH>
!style="width:150px"|Web tag_name
|All time high apparent temperature
!style="width:300px"|Function
|<#TapptempH>
!style="width:350px"|Time
!style="width:150px"|Date
|-
|-
|<#apptempL>
|colspan="4" style="background:lightgray;"|Temperature & Humidity
|All time low apparent temperature
|<#TapptempL>
|-
|-
|<#feelslikeH>
|<#YearTempH>
|[[File:Badge vMx.png]]All time high feels like temperature (available from 3.6.0)
|This year's highest temperature
|<#TfeelslikeH>
|<#YearTempHT>
|<#YearTempHD>
|-
|-
|<#feelslikeL>
|<#YearTempL>
|[[File:Badge vMx.png]]All time low feels like temperature (available from 3.6.0)
|This year's lowest temperature
|<#TfeelslikeL>
|<#YearTempLT>
|<#YearTempLD>
|-
|-
|<#humidexH>
|<#YearHighDailyTempRange>
|[[File:Badge vMx.png]]All time high Canadian Humidity Index (available from 3.7.0)
|This year's highest Daily Temp Range
|<#ThumidexH>
|n/a
|<#YearHighDailyTempRangeD>
|-
|-
|<#heatindexH>
|<#YearLowDailyTempRange>
|All time high USA heat index
|This year's lowest Daily Temp Range
|<#TheatindexH>
|n/a
|<#YearLowDailyTempRangeD>
|-
|-
|<#dewpointH>
|<#YearHeatIndexH>
|All time high dew point
|This year's highest USA heat index
|<#TdewpointH>
|<#YearHeatIndexHT>
|<#YearHeatIndexHD>
|-
|-
|<#dewpointL>
|<#YearWChillL>
|All time low dew point
|This year's greatest wind chill (i.e. lowest temperature)
|<#TdewpointL>
|<#YearWChillLT>
|<#YearWChillLD>
|-
|-
|<#humH>
|<#YearAppTempH>
|All time high humidity
|This year's highest apparent temperature
|<#ThumH>
|<#YearAppTempHT>
|<#YearAppTempHD>
|-
|-
|<#humL>
|<#YearAppTempL>
|All time low humidity
|This year's lowest apparent temperature
|<#ThumL>
|<#YearAppTempLT>
|<#YearAppTempLD>
|-
|-
|<#wchillH>
|<#YearFeelsLikeH>
|All time greatest wind chill (i.e. lowest temperature, but highest wind speed)  
|[[File:Badge vMx.png]]This year's highest feels like temperature (available from 3.6.0)  (NOT AVAILABLE IN CUMULUS 1)
|<#TwchillH>
|<#YearFeelsLikeHT>
|<#YearFeelsLikeHD>
|-
|-
|colspan="3" style="background:lightgray;"|Rainfall
|<#YearFeelsLikeL>
|[[File:Badge vMx.png]]This year's lowest feels like temperature (available from 3.6.0)  (NOT AVAILABLE IN CUMULUS 1)
|<#YearFeelsLikeLT>
|<#YearFeelsLikeLD>
|-
|-
|<#rrateM>
|<#YearHumidexH>
|All time high rain rate
|[[File:Badge vMx.png]] (Available from version 3.7.0)    (NOT AVAILABLE IN CUMULUS 1)
|<#TrrateM>
 
This year's highest Canadian Humidity Index
|<#YearHumidexHT>
|<#YearHumidexHD>
|-
|-
|<#rfallH>
|<#YearDewPointH>
|All time high daily rain
|This year's highest dew point
|<#TrfallH>
|<#YearDewPointHT>
|<#YearDewPointHD>
|-
|-
|<#rfallhH>
|<#YearDewPointL>
|All time high hourly rain
|This year's lowest dew point
|<#TrfallhH>
|<#YearDewPointLT>
|<#YearDewPointLD>
|-
|-
|<#rfallmH>
|<#YearMinTempH>
|All time high monthly rain
|This year's highest daily minimum temperature
|<#TrfallmH>
|Flavour specific mandatory output parameters:
* <#YearMinTempHD format=HH:nn> ''for Cumulus 1'',
* <#YearMinTempHD format=HH:mm> ''for Cumulus MX''
|<#YearMinTempHD>
|-
|-
|<#LongestDryPeriod>
|<#YearMaxTempL>
|All time longest dry period (days)
|This year's lowest daily maximum temperature
|<#TLongestDryPeriod>
|Flavour specific mandatory output parameters:
* <#YearMaxTempHD format=HH:nn> ''for Cumulus 1'',
* <#YearMaxTempHD format=HH:mm> ''for Cumulus MX''
 
|<#YearMaxTempLD>
|-
|-
|<#LongestWetPeriod>
|<#YearHumH>
|All time longest wet period (days)
|This year's high humidity
|<#TLongestWetPeriod>
|<#YearHumHT>
|<#YearHumHD>
|-
|-
|colspan="3" style="background:lightgray;"|Pressure
|<#YearHumL>
|This year's low humidity
|<#YearHumLT>
|<#YearHumLD>
|-
|-
|<#pressH>
|colspan="4" style="background:lightgray;"|Pressure
|All time high pressure
|<#TpressH>
|-
|-
|<#pressL>
|<#YearPressH>
|All time low pressure  
|This year's high pressure
|<#TpressL>
|<#YearPressHT>
|<#YearPressHD>
|-
|-
|colspan="3" style="background:lightgray;"|Wind
|<#YearPressL>
|This year's low pressure
|<#YearPressLT>
|<#YearPressLD>
|-
|-
|<#gustM>
|colspan="4" style="background:lightgray;"|Wind
|All time high wind gust
|<#TgustM>
|-
|-
|<#wspeedH>
|<#YearGustH>
|All time high average wind speed
|This year's high wind gust
|<#TwspeedH>
|<#YearGustHT>
|<#YearGustHD>
|-
|-
|<#windrunH>
|<#YearWindH>
|All time high daily wind run
|This year's high wind speed
|<#TwindrunH>
|<#YearWindHT>
|}
|<#YearWindHD>
 
==Monthly All Time Records==
 
This table includes web tags that show the values in [[Monthlyalltime.ini]] log file, which was introduced in version 1.9.3 (build 1033, 10 Apr 2012).
 
These 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.  To supply both optional input modification, and optional output modification parameters, separate them with spaces, e.g. <#ByMonthTempHT mon=7 format=hh:nn>. In that example,  the highest ever temperature in July is returned in the value after processing by Cumulus.
 
For full details of the input modification parameters, see [[Webtags/Parameters#Input_modification_Parameters|Parameters]] page.
 
Additional tags correctly populated from 3.6.10 (build 3086) or 3.7.0 (build 3089) are marked with a "MX" icon as they are not available in Cumulus 1. Please note the 3.6.10 release was available from 24 June 2020, if the date/time shown for those MX only tags is before when you installed that (or a later release), the feels like output may show incorrect values.
{| class="wikitable" border="1"
|-
|-
!style="width:150px"|Web tag_name
|<#YearWindRunH>
!style="width:400px"|Function
This year's highest Daily Wind Run
!style="width:150px"|Date/Time
|n/a
|<#YearWindRunHD>
|-
|-
|colspan="3" style="background:lightgray;"|Temperature & Humidity
|colspan="4" style="background:lightgray;"|Rainfall
|-
|-
|<#ByMonthTempH>
|<#YearRainRateH>
|High Temperature
|This year's highest rainfall rate
|<#ByMonthTempHT>
|<#YearRainRateHT>
|<#YearRainRateHD>
|-
|-
|<#ByMonthTempL>
|<#YearHourlyRainH>
|Low Temperature
|This year's highest hourly rain
|<#ByMonthTempLT>
|<#YearHourlyRainHT>
|<#YearHourlyRainHD>
|-
|-
|<#ByMonthHeatIndexH>
|<#YearDailyRainH>
|High Heat Index
|This year's high daily rain
|<#ByMonthHeatIndexHT>
|n/a
|<#YearDailyRainHD>
|-
|-
|<#ByMonthWChillL>
|<#YearMonthlyRainH>
|Greatest wind chill (i.e. lowest temperature and highest wind speed)
|This year's high monthly rain
|<#ByMonthWChillLT>
|n/a
|<#YearMonthlyRainHD>
|-
|-
|<#ByMonthAppTempH>
|<#YearLongestDryPeriod>
|High Apparent Temperature
|Longest period without rain ending this year (days)
|<#ByMonthAppTempHT>
|n/a
|<#YearLongestDryPeriodD>
|-
|-
|<#ByMonthAppTempL>
|<#YearLongestWetPeriod>
|Low Apparent Temperature
|Longest period of rain every day ending this year (days)
|<#ByMonthAppTempLT>
|n/a
|<#YearLongestWetPeriodD>
|-
|-
|<#ByMonthFeelsLikeH>
|colspan="4" style="background:lightgray;"|Solar
|[[File:Badge vMx.png]]High Feels Like Temperature (available from 3.6.10)
 
|<#ByMonthFeelsLikeHT>
[[File:Badge vMx.png]] (Available from release 3.12.0 onwards)
|-
|-
|<#ByMonthFeelsLikeL>
| <#SunshineHoursYear>
|[[File:Badge vMx.png]]Low Feels Like Temperature (available from 3.6.10)
| the total sunshine hours in year-to-date, or with [[Webtags/Parameters#Input_modification_Parameters|input modification parameters using either '''y''' or '''r''']] for a past year
|<#ByMonthFeelsLikeLT>
| n/a
|-
| n/a
|<#ByMonthHumidexH>
|}
|[[File:Badge vMx.png]]High Canadian Humidity Index (Humidex) - available from version 3.7.0
 
|<#ByMonthHumidexHT>
==All Time==
 
This table lists the web tags that appear in the '''recordsT.htm''' example template that is included in each release since version 1.5.1 10th January 2006.  Additional tags correctly populated from 3.6.10 (build 3086) or 3.7.0 (build 3089) are marked with a "MX" icon as they are not available in Cumulus 1. Please note the 3.6.10 release was available from 24 June 2020, if the date shown for those MX only tags is before when you installed that (or a later release), the output may show incorrect values.
 
The output from the web tags shown in the date/time column have the default format that is seen on "records.htm" in the standard web pages:
*The default format for an extreme month is to show the month name in full i.e. format 'MMMM' followed by the year in full.
*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' again ending with the year.
*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 (i.e. on the standard web page the time comes first, not as seen in admin interface).
 
You can change the default output on either the standard web template, or in your own file,  by 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. Please see examples section above for advice.
 
Note that unlike the this month and this year web tags, the time and the date are both included in the default format of the standard time-stamp web tags for the 'highest minimum' and 'lowest maximum' temperatures, yet another inconsistency!
 
{| class="wikitable" border="1"
|-
|-
|<#ByMonthHumidexL>
!style="width:150px" | Web tag_name
|[[File:Badge vMx.png]]Low Canadian Humidity Index (Humidex) - available from version 3.7.0
!style="width:400px" | Function
|<#ByMonthHumidexLT>
!style="width:150px" | Date/Time
|-
|-
|<#ByMonthDewPointH>
|colspan="3" style="background:lightgray;"|Temperature & Humidity
|High Dew Point
|<#ByMonthDewPointHT>
|-
|-
|<#ByMonthDewPointL>
|<#tempH>
|Low Dew Point
|All time high temperature
|<#ByMonthDewPointLT>
|<#TtempH>
|-
|-
|<#ByMonthMinTempH>
|<#tempL>
|Highest Daily Minimum Temperature
|All time low temperature
|<#ByMonthMinTempHT>
|<#TtempL>
|-
|-
|<#ByMonthMaxTempL>
|<#mintempH>
|Lowest Daily Maximum Temperature
|All time high minimum temperature
|<#ByMonthMaxTempLT>
|<#TmintempH>
|-
|-
|<#ByMonthHighDailyTempRange>
|<#maxtempL>
|High Daily Temp Range
|All time low maximum temperature
|<#ByMonthHighDailyTempRangeT>  
|<#TmaxtempL>
|-
|-
|<#ByMonthLowDailyTempRange>
|<#LowDailyTempRange>
|Low Daily Temp Range
|All time low daily temperature range
|<#ByMonthLowDailyTempRangeT>
|<#TLowDailyTempRange>
|-
|-
|<#ByMonthHumH>
|<#HighDailyTempRange>
|High Humidity
|All time high daily temperature range
|<#ByMonthHumHT>
|<#THighDailyTempRange>
|-
|-
|<#ByMonthHumL>
|<#apptempH>
|Low Humidity
|All time high apparent temperature
|<#ByMonthHumLT>  
|<#TapptempH>
|-
|-
|colspan="4" style="background:lightgray;"|Pressure
|<#apptempL>
|All time low apparent temperature
|<#TapptempL>
|-
|-
|<#ByMonthPressH>
|<#feelslikeH>
|High Pressure
|[[File:Badge vMx.png]]All time high feels like temperature (available from 3.6.0)
|<#ByMonthPressHT>
|<#TfeelslikeH>
|-
|-
|<#ByMonthPressL>
|<#feelslikeL>
|Low Pressure
|[[File:Badge vMx.png]]All time low feels like temperature (available from 3.6.0)
|<#ByMonthPressLT>
|<#TfeelslikeL>
|-
|-
|colspan="4" style="background:lightgray;"|Wind
|<#humidexH>
|[[File:Badge vMx.png]]All time high Canadian Humidity Index (available from 3.7.0)
|<#ThumidexH>
|-
|-
|<#ByMonthGustH>
|<#heatindexH>
|High Wind Gust
|All time high USA heat index
|<#ByMonthGustHT>
|<#TheatindexH>
|-
|-
|<#ByMonthWindH>
|<#dewpointH>
|High Wind Speed
|All time high dew point
|<#ByMonthWindHT>
|<#TdewpointH>
|-
|-
|<#ByMonthWindRunH>
|<#dewpointL>
|High Daily Wind Run
|All time low dew point
|<#ByMonthWindRunHT>
|<#TdewpointL>
|-
|-
|colspan="4" style="background:lightgray;"|Rainfall
|<#humH>
|All time high humidity
|<#ThumH>
|-
|-
|<#ByMonthRainRateH>
|<#humL>
|High Rain Rate
|All time low humidity
|<#ByMonthRainRateHT>
|<#ThumL>
|-
|-
|<#ByMonthMonthlyRainH>
|<#wchillH>
|High Monthly Rainfall
|All time greatest wind chill (i.e. lowest temperature, but highest wind speed)
|<#ByMonthMonthlyRainHT>
|<#TwchillH>
|-
|-
|<#ByMonthHourlyRainH>
|colspan="3" style="background:lightgray;"|Rainfall
|High Hourly Rain
|<#ByMonthHourlyRainHT>
|-
|-
|<#ByMonthDailyRainH>
|<#rrateM>
|High Daily Rain
|All time high rain rate
|<#ByMonthDailyRainHT>
|<#TrrateM>
|-
|-
|<#ByMonthLongestDryPeriod>
|<#rfallH>
|Longest Dry Period
|All time high daily rain
|<#ByMonthLongestDryPeriodT>
|<#TrfallH>
|-
|-
|<#ByMonthLongestWetPeriod>
|<#rfallhH>
|Longest Wet Period
|All time high hourly rain
|<#ByMonthLongestWetPeriodT>
|<#TrfallhH>
|}
 
==Day/Night/Sun/Moon==
In Cumulus 1 most of these are only calculated at UTC zero hours, but are updated each hour to refer to current time-zone.
 
MX is more complicated, but most of these are calculated hourly.
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | Web tag_name
|<#rfallmH>
!style="width:900px" | Function
|All time high monthly rain
|<#TrfallmH>
|-
|-
|<#sunrise>
|<#LongestDryPeriod>
|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.
|All time longest dry period (days)
|<#TLongestDryPeriod>
|-
|-
|<#sunset>
|<#LongestWetPeriod>
|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.
|All time longest wet period (days)
|<#TLongestWetPeriod>
|-
|-
|<#daylength>
|colspan="3" style="background:lightgray;"|Pressure
|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.
|-
|-
|<#IsSunUp>
|<#pressH>
|A flag to indicate if the Sun is above the horizon or not, based on the sunrise and sunset times.
|All time high pressure
 
|<#TpressH>
Possible values are 0 or 1, where 1 is when the Sun is above the horizon for the station location.
|-
|-
|<#dawn>
|<#pressL>
|Start of last Civil Twilight at the station as at last midnight UTC
|All time low pressure
|<#TpressL>
|-
|colspan="3" style="background:lightgray;"|Wind
|-
|-
|<#dusk>
|<#gustM>
|End of next Civil Twilight at the station as at last midnight UTC
|All time high wind gust
|<#TgustM>
|-
|-
|<#daylightlength>
|<#wspeedH>
| Approximate length of daylight in hours and minutes (dawn to dusk) - if your timezone is UTC or a few hours off that,  the dusk may well be that just passed, and the dawn that to come as at the zero hours UTC when Cumulus 1 does this calculation
|All time high average wind speed
|<#TwspeedH>
|-
|-
|<#isdaylight>
|<#windrunH>
|A flag to indicate if the location for the station is in civil daylight or not, based on the dawn and dusk times.
|All time high daily wind run
|<#TwindrunH>
|}


Possible values are 0 or 1, where 1 notes that it is currently within the hours of daylight.
==Monthly All Time Records==


|-
This table includes web tags that show the values in [[Monthlyalltime.ini]] log file, which was introduced in version 1.9.3 (build 1033, 10 Apr 2012).
|<#tomorrowdaylength>
|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, basically because of the note for <#daylightlength>, and its use was not recommended. Its use is therefore not supported by Steve Loft (i.e. you use it at your own risk) in the legacy Cumulus.
These 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.  To supply both optional input modification, and optional output modification parameters, separate them with spaces, e.g. <#ByMonthTempHT mon=7 format=hh:nn>. In that example,  the highest ever temperature in July is returned in the value after processing by Cumulus.
|-
|<#moonphase>
|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]].
|-
|<#MoonAge>
|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"
For full details of the input modification parameters, see [[Webtags/Parameters#Input_modification_Parameters|Parameters]] page.


There is some PHP script code below this table showing how this can be converted to days, hours, minutes, seconds*
Additional tags correctly populated from 3.6.10 (build 3086) or 3.7.0 (build 3089) are marked with a "MX" icon as they are not available in Cumulus 1. Please note the 3.6.10 release was available from 24 June 2020, if the date/time shown for those MX only tags is before when you installed that (or a later release), the feels like output may show incorrect values.
 
{| class="wikitable" border="1"
If the "dp" parameter is supplied, then supplying "rc=y" in addition will cause any decimal comma to be converted to a decimal point.
|-
|-
|<#moonrise>
!style="width:150px"|Web tag_name
|Current moonrise time at the station (if moon rises on current calendar day)
!style="width:400px"|Function
!style="width:150px"|Date/Time
|-
|-
|<#moonset>
|colspan="3" style="background:lightgray;"|Temperature & Humidity
|Current moonset time at the station (if moon sets on current calendar day)
|-
|-
|<#MoonPercent>
|<#ByMonthTempH>
|Current percentage of moon visible (negative value indicates 'waning')
|High Temperature
 
|<#ByMonthTempHT>
MX b3047 adds the 'dp' and 'rc' parameters as <#MoonAge> above
|-
|-
|<#MoonPercentAbs>
|<#ByMonthTempL>
|Current percentage of moon visible (always positive)
|Low Temperature
 
|<#ByMonthTempLT>
MX b3047 adds the 'dp' and 'rc' parameters as <#MoonAge> above
|-
|-
|<#SunshineHours>
|<#ByMonthHeatIndexH>
| see[[#Today.ini]] Miscellaneous
|High Heat Index
|<#ByMonthHeatIndexHT>
|-
|-
|<#SunshineHoursY>
|<#ByMonthWChillL>
|see [[#Yesterday]] Miscellaneous
|Greatest wind chill (i.e. lowest temperature and highest wind speed)
|<#ByMonthWChillLT>
|-
|-
|<#CurrentSolarMax>
|<#ByMonthAppTempH>
|[[FAQ#What_is_this_.22Solar_Max.22_value_which_Cumulus_is_displaying.3F | Current theoretical maximum solar radiation]]
|High Apparent Temperature
|<#ByMonthAppTempHT>
|-
|-
|<#IsSunny>
|<#ByMonthAppTempL>
|Returns 1 if the sun is shining, otherwise 0 (Solar sensor needed)
|Low Apparent Temperature
|}
|<#ByMonthAppTempLT>
*<code>
$MoonAgeDays = <#MoonAge dp=0> +0;
$moonDecimalPart = <#MoonAge dp=4> - $MoonAgeDays;
$MoonAgeHours = round($moonDecimalPart * 24, 0);
$MoonAgeMinutes  = round(($moonDecimalPart * 24 * 60) - ($MoonAgeHours * 60), 0);
$MoonAgeSeconds = round(($moonDecimalPart * 24 * 60 * 60) - ($MoonAgeHours * 60 * 60) - ($MoonAgeMinutes * 60), 3);
$MoonAge      =    $MoonAgeDays . '&nbsp;days, ' .  $MoonAgeHours . '&nbsp;hours, '
. $MoonAgeMinutes . '&nbsp;minutes, ' . $MoonAgeSeconds . '&nbsp;seconds';
// Change the English words 'days, ', ' hours, ', and 'minutes' to the equivalents in your language</code>
 
==Alarms==
 
[[File:badge v1.png]]There are a set of tags available in Cumulus 1 for various alarm states. In Cumulus 1, the main page will change the colour of the relevant element when an alarm condition is entered or left. You can add sounds, and enable disable each alarm parameter on the Main Cumulus screen, Edit menu.
 
[[File:Badge vMx.png]]Alarms are also available in later MX versions. In MX, the alarm conditions are shown on the bottom of the Dashboard page of the user interface. You can add sounds, and enable/disable each alarm parameter on the Alarms screen within Settings menu.
 
For both flavours, there are web tags for each alarm condition, they give a value of '1' if the alarm condition is enabled and is still currently met; otherwise '0'.
{| class="wikitable" border="1"
|-
|-
!style="width:150px" |Web tag_name
|<#ByMonthFeelsLikeH>
!style="width:600px" |Function
|[[File:Badge vMx.png]]High Feels Like Temperature (available from 3.6.10)
|<#ByMonthFeelsLikeHT>
|-
|-
|<#LowTempAlarm>  
|<#ByMonthFeelsLikeL>
|Low temperature alarm
|[[File:Badge vMx.png]]Low Feels Like Temperature (available from 3.6.10)
|<#ByMonthFeelsLikeLT>
|-
|-
|<#HighTempAlarm>  
|<#ByMonthHumidexH>
|High temperature alarm
|[[File:Badge vMx.png]]High Canadian Humidity Index (Humidex) - available from version 3.7.0
|<#ByMonthHumidexHT>
|-
|-
|<#TempChangeUpAlarm>  
|<#ByMonthHumidexL>
|Temperature increase alarm
|[[File:Badge vMx.png]]Low Canadian Humidity Index (Humidex) - available from version 3.7.0
|<#ByMonthHumidexLT>
|-
|-
|<#TempChangeDownAlarm>  
|<#ByMonthDewPointH>
|Temperature decrease alarm
|High Dew Point
|<#ByMonthDewPointHT>
|-
|-
|<#LowPressAlarm>  
|<#ByMonthDewPointL>
|Low pressure alarm
|Low Dew Point
|<#ByMonthDewPointLT>
|-
|-
|<#HighPressAlarm>  
|<#ByMonthMinTempH>
|High pressure alarm
|Highest Daily Minimum Temperature
|<#ByMonthMinTempHT>
|-
|-
|<#PressChangeUpAlarm>  
|<#ByMonthMaxTempL>
|Pressure increase alarm
|Lowest Daily Maximum Temperature
|<#ByMonthMaxTempLT>
|-
|-
|<#PressChangeDownAlarm>  
|<#ByMonthHighDailyTempRange>
|Pressure decrease alarm
|High Daily Temp Range
|<#ByMonthHighDailyTempRangeT>
|-
|-
|<#HighRainTodayAlarm>  
|<#ByMonthLowDailyTempRange>
|High rain today alarm
|Low Daily Temp Range
|<#ByMonthLowDailyTempRangeT>
|-
|-
|<#HighRainRateAlarm>  
|<#ByMonthHumH>
|High rainfall rate alarm
|High Humidity
|<#ByMonthHumHT>
|-
|-
|<#HighWindGustAlarm>  
|<#ByMonthHumL>
|High wind gust alarm
|Low Humidity
|<#ByMonthHumLT>
|-
|-
|<#HighWindSpeedAlarm>
|colspan="4" style="background:lightgray;"|Pressure
|High wind speed alarm
|-
|-
|<#DataStopped>
|<#ByMonthPressH>
|1 if the station has apparently stopped sending data to Cumulus, otherwise 0
|High Pressure
|<#ByMonthPressHT>
|-
|-
|<#DataSpikeAlarm>
|<#ByMonthPressL>
|[[File:Badge vMx.png]] Available from version 3.7.0
|Low Pressure
 
|<#ByMonthPressLT>
Alarm raised if a data spike is detected, or a data limit exceeded
|-
|-
| <#HttpUploadAlarm>
|colspan="4" style="background:lightgray;"|Wind
|[[File:Badge vMx.png]] Available from version 3.11.2
|-
 
|<#ByMonthGustH>
Alarm raised if a HTTP upload alarm has been triggered
|High Wind Gust
|<#ByMonthGustHT>
|-
|<#ByMonthWindH>
|High Wind Speed
|<#ByMonthWindHT>
|-
|<#ByMonthWindRunH>
|High Daily Wind Run
|<#ByMonthWindRunHT>
|-
|-
| <#MySqlUploadAlarm>
|colspan="4" style="background:lightgray;"|Rainfall
|[[File:Badge vMx.png]] Available from version 3.11.2
 
Alarm raised if a MySQL upload alarm has been triggered
|-
|-
| <#UpgradeAlarm>
|<#ByMonthRainRateH>
| Alarm raised if MX upgrade (a newer release) is available
|High Rain Rate
|}
|<#ByMonthRainRateHT>
 
|-
== Extreme Records ==
|<#ByMonthMonthlyRainH>
 
|High Monthly Rainfall
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).
|<#ByMonthMonthlyRainHT>
 
=== Differences depending on Cumulus versions ===
 
[[File:Badge v1.png]] Cumulus 1.9.x supports all the web tags listed in table below, with the exception of those relating to "humidex" and "feels like".
 
[[File:Badge v1.png]] For Cumulus 1 the tags are cleared in one of two ways:
#Generation of a web page where the web tag is set, clears the record for that web tag.
#Viewing of an extreme screen tab clears all records listed on that tab.
 
[[File:Badge vMx.png]] For versions up to 3.5.0 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). From version 3.7.0, Cumulus MX offers all the web tags listed in table below, at earlier versions it offers a subset of those listed.
 
[[File:Badge vMx.png]] For MX these web tags will be set from the time of the record until a timeout value is met (by default each record remains set for 24 hours).
 
'''You can change the default MX timeout''':
*Add a <tt>RecordSetTimeoutHrs=NN</tt> entry to [[Cumulus.ini#Section:_Station|[Station] section in Cumulus.ini]]
*'''NN''' can be set to any reasonable integer representing hours (for the default set the number '''NN''' to '24').
 
=== Table of web tags available for extreme records ===
 
{| class="wikitable" border="1"
|-
|-
!style="width:150px" |Web tag_name
|<#ByMonthHourlyRainH>
!style="width:600px" |Function
|High Hourly Rain
|<#ByMonthHourlyRainHT>
|-
|-
|<#recordsbegandate>
|<#ByMonthDailyRainH>
|The date that Cumulus began tracking all time records (does not prevent earlier record dates being set manually)
|High Daily Rain
|<#ByMonthDailyRainHT>
|-
|-
|<#newrecord>  
|<#ByMonthLongestDryPeriod>
|Indicates when any tracked extreme is changed.
|Longest Dry Period
*{{Version badge 1}}In Cumulus 1.x.x:
|<#ByMonthLongestDryPeriodT>
** 1 if 'new record' light is flashing,
**0 if not
*[[File:Badge vMx.png]]In Cumulus MX: 1 from when new record is set until
** either all records have cleared
**or until next rollover is completed,
*0 otherwise
|-
|-
|<#TempRecordSet>
|<#ByMonthLongestWetPeriod>
|1 if any temperature-based extreme has been updated, 0 if not
|Longest Wet Period
|<#ByMonthLongestWetPeriodT>
|}
 
==Day/Night/Sun/Moon==
In Cumulus 1 most of these are only calculated at UTC zero hours, but are updated each hour to refer to current time-zone.
 
MX is more complicated, but most of these are calculated hourly.
{| class="wikitable" border="1"
|-
|-
|<#HighTempRecordSet>
!style="width:150px" | Web tag_name
|1 if the all-time highest temperature extreme has been updated, 0 if not
!style="width:900px" | Function
|-
|-
|<#LowTempRecordSet>
|<#sunrise>
|1 if the all-time lowest temperature extreme has been updated, 0 if not
|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.
|-
|-
|<#HighTempRangeRecordSet>
|<#sunset>
|1 if the all-time high daily temperature range extreme has been updated, 0 if not
|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.
|-
|-
|<#LowTempRangeRecordSet>
|<#daylength>
|1 if the all-time low daily temperature range extreme has been updated, 0 if not
|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.
|-
|-
|<#HighAppTempRecordSet>
|<#IsSunUp>
|1 if the all-time high apparent temperature extreme has been updated, 0 if not
|A flag to indicate if the Sun is above the horizon or not, based on the sunrise and sunset times.
 
Possible values are 0 or 1, where 1 is when the Sun is above the horizon for the station location.
|-
|-
|<#LowAppTempRecordSet>
|<#dawn>
|1 if the all-time low apparent temperature extreme has been updated, 0 if not
|Start of last Civil Twilight at the station as at last midnight UTC
|-
|-
|<#HighHeatIndexRecordSet>
|<#dusk>
|1 if the all-time high USA heat index extreme has been updated, 0 if not
|End of next Civil Twilight at the station as at last midnight UTC
|-
|-
|<#HighHumidexRecordSet>
|<#daylightlength>
|[[File:Badge vMx.png]]1 if the all-time high Canadian Humidity index extreme has been updated, 0 if not (from version 3.7.0)
| Approximate length of daylight in hours and minutes (dawn to dusk) - if your timezone is UTC or a few hours off that,  the dusk may well be that just passed, and the dawn that to come as at the zero hours UTC when Cumulus 1 does this calculation
|-
|-
|<#LowWindChillRecordSet>
|<#isdaylight>
|1 if the all-time greatest wind chill extreme has been updated, 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.
 
|-
|-
|<#HighFeelsLikeRecordSet>
|<#tomorrowdaylength>
|[[File:Badge vMx.png]]1 if the all-time high feels like temperature extreme has been updated, 0 if not (from version 3.6.0)
|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, basically because of the note for <#daylightlength>, and its use was not recommended. Its use is therefore not supported by Steve Loft (i.e. you use it at your own risk) in the legacy Cumulus.
|-
|-
|<#LowFeelsLikeRecordSet>
|<#moonphase>
|[[File:Badge vMx.png]]1 if the all-time low feels like temperature extreme has been updated, 0 if not (from version 3.6.0)
|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]].
|-
|-
|<#HighDewPointRecordSet>
|<#MoonAge>
|1 if the all-time high dew point extreme has been updated, 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"
 
There is some PHP script code below this table showing how this can be converted to days, hours, minutes, seconds*
 
If the "dp" parameter is supplied, then supplying "rc=y" in addition will cause any decimal comma to be converted to a decimal point.
|-
|-
|<#LowDewPointRecordSet>
|<#moonrise>
|1 if the all-time low dew point extreme has been updated, 0 if not
|Current moonrise time at the station (if moon rises on current calendar day)
|-
|-
|<#HighMinTempRecordSet>
|<#moonset>
|1 if the all-time high minimum temperature extreme has been updated, 0 if not
|Current moonset time at the station (if moon sets on current calendar day)
|-
|-
|<#LowMaxTempRecordSet>
|<#MoonPercent>
|1 if the all-time low maximum temperature extreme has been updated, 0 if not
|Current percentage of moon visible (negative value indicates 'waning')
 
MX b3047 adds the 'dp' and 'rc' parameters as <#MoonAge> above
|-
|-
|<#HighWindGustRecordSet>
|<#MoonPercentAbs>
|1 if the all-time high wind gust extreme has been updated, 0 if not
|Current percentage of moon visible (always positive)
 
MX b3047 adds the 'dp' and 'rc' parameters as <#MoonAge> above
|-
|-
|<#HighWindSpeedRecordSet>
|<#SunshineHours>
|1 if the all-time high wind speed extreme has been updated, 0 if not
| see[[#Today.ini]] Miscellaneous
|-
|-
|<#RainRecordSet>
|<#SunshineHoursY>
|1 if any rainfall based extreme has been updated, 0 if not
|see [[#Yesterday]] Miscellaneous
|-
|-
|<#HighRainRateRecordSet>
|<#CurrentSolarMax>
|1 if the all-time high rain rate extreme has been updated, 0 if not
|[[FAQ#What_is_this_.22Solar_Max.22_value_which_Cumulus_is_displaying.3F | Current theoretical maximum solar radiation]]
|-
|-
|<#HighHourlyRainRecordSet>
|<#IsSunny>
|1 if the all-time high hourly rain extreme has been updated, 0 if not
|Returns 1 if the sun is shining, otherwise 0 (Solar sensor needed)
|}
<pre>
* Footnote: PHP code extract:
$MoonAgeDays = <#MoonAge dp=0> +0;
$moonDecimalPart = <#MoonAge dp=4> - $MoonAgeDays;
$MoonAgeHours = round($moonDecimalPart * 24, 0);
$MoonAgeMinutes  = round(($moonDecimalPart * 24 * 60) - ($MoonAgeHours * 60), 0);
$MoonAgeSeconds = round(($moonDecimalPart * 24 * 60 * 60) - ($MoonAgeHours * 60 * 60) - ($MoonAgeMinutes * 60), 3);
$MoonAge      =    $MoonAgeDays . '&nbsp;days, ' .  $MoonAgeHours . '&nbsp;hours, '
. $MoonAgeMinutes . '&nbsp;minutes, ' . $MoonAgeSeconds . '&nbsp;seconds';
// Change the English words 'days, ', ' hours, ', and 'minutes' to the equivalents in your language</pre>
 
==Alarms==
 
[[File:badge v1.png]]There are a set of tags available in Cumulus 1 for various alarm states. In Cumulus 1, the main page will change the colour of the relevant element when an alarm condition is entered or left. You can add sounds, and enable disable each alarm parameter on the Main Cumulus screen, Edit menu.
 
[[File:Badge vMx.png]]Alarms are also available in later MX versions. In MX, the alarm conditions are shown on the bottom of the Dashboard page of the user interface. You can add sounds, and enable/disable each alarm parameter on the Alarms screen within Settings menu.
 
For both flavours, there are web tags for each alarm condition, they give a value of '1' if the alarm condition is enabled and is still currently met; otherwise '0'.
{| class="wikitable" border="1"
|-
|-
|<#HighDailyRainRecordSet>
!style="width:150px" |Web tag_name
|1 if the all-time high daily rain extreme has been updated, 0 if not
!style="width:600px" |Function
|-
|-
|<#HighMonthlyRainRecordSet>
|<#LowTempAlarm>  
|1 if the all-time high monthly rain  extreme has been updated, 0 if not
|Low temperature alarm
|-
|-
|<#LongestDryPeriodRecordSet>
|<#HighTempAlarm>  
|1 if the all-time longest dry period extreme has been updated, 0 if not
|High temperature alarm
|-
|-
|<#LongestWetPeriodRecordSet>
|<#TempChangeUpAlarm>  
|1 if the all-time longest wet period extreme has been updated, 0 if not
|Temperature increase alarm
|-
|-
|<#HumidityRecordSet>
|<#TempChangeDownAlarm>  
|1 if either the highest or lowest humidity extreme has been updated, 0 if not
|Temperature decrease alarm
|-
|-
|<#HighHumidityRecordSet>
|<#LowPressAlarm>  
|1 if the all-time high humidity light extreme has been updated, 0 if not
|Low pressure alarm
|-
|-
|<#LowHumidityRecordSet>
|<#HighPressAlarm>  
|1 if the all-time low humidity extreme has been updated, 0 if not
|High pressure alarm
|-
|-
|<#PressureRecordSet>
|<#PressChangeUpAlarm>  
|1 if either the highest or lowest pressure extreme has been updated, 0 if not
|Pressure increase alarm
|-
|-
|<#HighPressureRecordSet>
|<#PressChangeDownAlarm>  
|1 if the all-time high pressure extreme has been updated, 0 if not
|Pressure decrease alarm
|-
|-
|<#LowPressureRecordSet>
|<#HighRainTodayAlarm>  
|1 if the all-time low pressure extreme has been updated, 0 if not
|High rain today alarm
|-
|-
|<#WindRecordSet>
|<#HighRainRateAlarm>
|1 if any wind speed based extreme has been updated, 0 if not
|High rainfall rate alarm
|-
|<#HighWindGustAlarm>
|High wind gust alarm
|-
|<#HighWindSpeedAlarm>
|High wind speed alarm
|-
|<#DataStopped>
|1 if the station has apparently stopped sending data to Cumulus, otherwise 0
|-
|-
|<#HighWindrunRecordSet>
|<#DataSpikeAlarm>
|1 if the all-time high wind run extreme has been updated, 0 if not
|[[File:Badge vMx.png]] Available from version 3.7.0
|}


==Special tags==
Alarm raised if a data spike is detected, or a data limit exceeded
|-
| <#HttpUploadAlarm>
|[[File:Badge vMx.png]] Available from version 3.11.2


===OS WMR Series===
Alarm raised if a HTTP upload alarm has been triggered
|-
| <#MySqlUploadAlarm>
|[[File:Badge vMx.png]] Available from version 3.11.2


There are a set of tags for the WMR928, WR100/200 extra sensors:
Alarm raised if a MySQL upload alarm has been triggered
 
{| class="wikitable" border="1"
|-
|-
!style="width:150px" |Web tag_name
| <#UpgradeAlarm>
!style="width:600px" |Function
| Alarm raised if MX upgrade (a newer release) is available
|-
|n/a
|Now incorporated into the Extra Sensors section above
|}
|}


===Davis===
== Extreme 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).
 
=== Differences depending on Cumulus versions ===
 
[[File:Badge v1.png]] Cumulus 1.9.x supports all the web tags listed in table below, with the exception of those relating to "humidex" and "feels like".
 
[[File:Badge v1.png]] For Cumulus 1 the tags are cleared in one of two ways:
#Generation of a web page where the web tag is set, clears the record for that web tag.
#Viewing of an extreme screen tab clears all records listed on that tab.
 
[[File:Badge vMx.png]] For versions up to 3.5.0 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). From version 3.7.0, Cumulus MX offers all the web tags listed in table below, at earlier versions it offers a subset of those listed.


'''Please be aware that the tags available are not the same in all versions.
[[File:Badge vMx.png]] For MX these web tags will be set from the time of the record until a timeout value is met (by default each record remains set for 24 hours).  
[[File:Badge vMx.png]]At present this table has not yet been updated for latest MX version.'''


All (see note for THSWindex) of the following web tags for the Davis PWS are available from Cumulus 1.9.2. Most of the following web tags are available in Cumulus MX 3.0.0 beta from build 3019, Storm tags from 3021.
'''You can change the default MX timeout''':
*Add a <tt>RecordSetTimeoutHrs=NN</tt> entry to [[Cumulus.ini#Section:_Station|[Station] section in Cumulus.ini]]
*'''NN''' can be set to any reasonable integer representing hours (for the default set the number '''NN''' to '24').


'''Both flavours update the values of the reception tags every 15 minutes.''' In Cumulus 1 this applies from 1.9.3, in 1.9.2 they were read, and updated, every minute, in earlier versions not available.
=== Table of web tags available for extreme records ===


{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
!style="width:150px" |Web tag_name
!style="width:150px" |Web tag_name
!style="width:120px" |Applicability
!style="width:600px" |Function
!style="width:600px" |Function
|-
|-
|<#DavisTotalPacketsReceived>
|<#recordsbegandate>
|1.9.2 onwards and MX
|The date that Cumulus began tracking all time records (does not prevent earlier record dates being set manually)
|Total number of data packets received.
|-
|-
|<#DavisTotalPacketsMissed>
|<#newrecord>  
|1.9.2 onwards and MX
|Indicates when any tracked extreme is changed.
|Number of missed data packets.  From version 3.6.0 build 3076, optionally add "tx=n" parameter, where n=1-8 and equals the desired transmitter id.
*{{Version badge 1}}In Cumulus 1.x.x:
** 1 if 'new record' light is flashing,
**0 if not
*[[File:Badge vMx.png]]In Cumulus MX: 1 from when new record is set until
** either all records have cleared
**or until next rollover is completed,
*0 otherwise
|-
|-
|<#DavisMaxInARow>
|<#TempRecordSet>
|1.9.2 onwards and MX
|1 if any temperature-based extreme has been updated, 0 if not
|Longest streak of consecutive packets received.  From version 3.6.0 build 3076, optionally add "tx=n" parameter, where n=1-8 and equals the desired transmitter id.
|-
|-
|<#DavisNumCRCerrors>
|<#HighTempRecordSet>
|1.9.2 onwards and MX
|1 if the all-time highest temperature extreme has been updated, 0 if not
|Number of packets received with CRC errors.  From version 3.6.0 build 3076, optionally add "tx=n" parameter, where n=1-8 and equals the desired transmitter id.
|-
|-
|<#DavisNumberOfResynchs>
|<#LowTempRecordSet>
|1.9.2 onwards and MX
|1 if the all-time lowest temperature extreme has been updated, 0 if not
|Number of times the console resynchronised with the transmitter
|-
|-
|<#DavisFirmwareVersion>
|<#HighTempRangeRecordSet>
|1.9.2 onwards and MX
|1 if the all-time high daily temperature range extreme has been updated, 0 if not
|The console firmware version
|-
|-
|<#THWindex>
|<#LowTempRangeRecordSet>
|1.9.x
|1 if the all-time low daily temperature range extreme has been updated, 0 if not
|A derived temperature using Temperature/Humidity/Wind values read from Davis DLL in Cumulus 1.9.x.
*The THW Index uses humidity and temperature (like Heat Index), but includes the cooling effects of wind (like wind chill).
*Available from 1.9.2 Build 1009 (Aug 2011).
|-
|-
|<#THSWindex>
|<#HighAppTempRecordSet>
|(1.9.x and) MX
|1 if the all-time high apparent temperature extreme has been updated, 0 if not
|A heat stress indicator using Temperature/Humidity/Solar/Wind values.
|-
*The THSW Index uses humidity and temperature (like the Heat Index), but also includes the heating effects of sunshine, and the cooling effects of wind.
|<#LowAppTempRecordSet>
*Therefore requires Davis station with solar sensor.
|1 if the all-time low apparent temperature extreme has been updated, 0 if not
[http://digitalcommons.unl.edu/cgi/viewcontent.cgi?article=1223&context=animalscinbcr  Approx calculation]: Decrease heat index by 1 unit for each 1 mph increase in wind speed, and for each, either 3 Langley increase in solar radiation, or 10% increase in cloud cover.
 
'''IMPORTANT NOTES:'''
#Although this tag is available in Cumulus 1.9.x, there is an issue somewhere in the Davis code that prevents Cumulus 1 obtaining the value (so tag always displays zero).
#Search the forum for several discussions about "THSW".
#Cumulus MX reads "LOOP2" packets, and the correct value for this tag can be read there and displayed on 'Now' template.
|-
|-
|<#battery>
|<#HighHeatIndexRecordSet>
|1.x.x and MX
|1 if the all-time high USA heat index extreme has been updated, 0 if not
|The console battery condition in volts. eg "4.82v"
|-
|-
|<#txbattery>
|<#HighHumidexRecordSet>
<#txbattery channel=1>
|[[File:Badge vMx.png]]1 if the all-time high Canadian Humidity index extreme has been updated, 0 if not (from version 3.7.0)
|1.8.9 onwards and MX
|The transmitter battery condition, by default it returns the status of all transmitters. (This was displayed from version 1.9.4 to 1.8.9 on the main screen).
'''Cumulus 1.9.3 onwards Only:''' The optional 'channel' parameter returns the status for a particular transmitter, up to channel=8. The channel result is just the string "ok" or "LOW" for a low battery
|-
|-
|<#StormRain>
|<#LowWindChillRecordSet>
|1.x.x and MX
|1 if the all-time greatest wind chill extreme has been updated, 0 if not
|The console 'storm rain' current amount (build 1090 onwards for Cumulus 1; 3021 onwards for MX)
|-
|-
|<#StormRainStart>
|<#HighFeelsLikeRecordSet>
|1.x.x and MX
|[[File:Badge vMx.png]]1 if the all-time high feels like temperature extreme has been updated, 0 if not (from version 3.6.0)
|The console reported '''date''' of the start of the 'storm' (the console does not report start time, but it appears a minimum of 2 tips within 3 hours will trigger a storm start, so using <#LastRainTipISO> in a script might help), but standard Cumulus [[Webtags#Time.2FDate_.27format.27_Parameter| date/time formatting]] can be applied to that date.
|}
 
===Davis WLL ===
 
New from version 3.6.0. Not available for earlier MX, not available for Cumulus 1.
 
{| class="wikitable" border="1"
|-
|-
!style="width:150px" |Web tag_name
|<#LowFeelsLikeRecordSet>
!style="width:600px" |Function
|[[File:Badge vMx.png]]1 if the all-time low feels like temperature extreme has been updated, 0 if not (from version 3.6.0)
|-
|-
|<#DavisReceptionPercent tx=1>
|<#HighDewPointRecordSet>
|WLL transmitter reception percentage (replace 1 by any other transmitter number up to 8)
|1 if the all-time high dew point extreme has been updated, 0 if not
|-
|-
|<#DavisTxRssi tx=0>
|<#LowDewPointRecordSet>
|WLL RSSI of the WiFi connection
|1 if the all-time low dew point extreme has been updated, 0 if not
|-
|-
|<#DavisTxRssi tx=1>
|<#HighMinTempRecordSet>
|WLL RSSI of Transmitter #1 (replace 1 by any other transmitter number up to 8)
|1 if the all-time high minimum temperature extreme has been updated, 0 if not
|}
 
=== Davis AirLink ===
New from version 3.9.0. Not available for earlier MX, not available for Cumulus 1.
 
Note, that you can configure an Indoor or Outdoor (or both) AirLink, most people will use an outdoor. There are a similar set of tags for each device.
 
{| class="wikitable" border="1"
|-
|-
!style="width:150px" |Web tag_name
|<#LowMaxTempRecordSet>
!style="width:600px" |Function
|1 if the all-time low maximum temperature extreme has been updated, 0 if not
|-
|-
|colspan="2" style="background:lightgray;"|Particulate Matter
|<#HighWindGustRecordSet>
|1 if the all-time high wind gust extreme has been updated, 0 if not
|-
|-
|<#AirLinkPm1[InǀOut]>
|<#HighWindSpeedRecordSet>
|Current particulate matter of 1 μm, or less count
|1 if the all-time high wind speed extreme has been updated, 0 if not
|-
|-
|<#AirLinkPm2p5[InǀOut]>
|<#RainRecordSet>
|Currentparticulate matter of 2.5 μm, or less, count
|1 if any rainfall based extreme has been updated, 0 if not
|-
|-
|<#AirLinkPm2p5_1hr[InǀOut]>
|<#HighRainRateRecordSet>
|Last hour average particulate matter of 2.5 μm, or less, count
|1 if the all-time high rain rate extreme has been updated, 0 if not
|-
|-
|<#AirLinkPm2p5_3hr[InǀOut]>
|<#HighHourlyRainRecordSet>
|Last 3 hours average particulate matter of 2.5 μm, or less, count
|1 if the all-time high hourly rain extreme has been updated, 0 if not
|-
|-
|<#AirLinkPm2p5_24hr[InǀOut]>
|<#HighDailyRainRecordSet>
|Last 24 hours average particulate matter of 2.5 μm, or less, count
|1 if the all-time high daily rain extreme has been updated, 0 if not
|-
|-
|<#AirLinkPm2p5_Nowcast[InǀOut]>
|<#HighMonthlyRainRecordSet>
|The 24 hour "nowcast" weighted average particulate matter of 2.5 μm, or less, count
|1 if the all-time high monthly rain  extreme has been updated, 0 if not
|-
|-
|<#AirLinkPm10[InǀOut]>
|<#LongestDryPeriodRecordSet>
|Current particulate matter of 10 μm, or less, count
|1 if the all-time longest dry period extreme has been updated, 0 if not
|-
|-
|<#AirLinkPm10_1hr[InǀOut]>
|<#LongestWetPeriodRecordSet>
|Last hour average particulate matter of 10 μm, or less, count
|1 if the all-time longest wet period extreme has been updated, 0 if not
|-
|-
|<#AirLinkPm10_3hr[InǀOut]>
|<#HumidityRecordSet>
|Last 3 hours average particulate matter of 10 μm, or less, count
|1 if either the highest or lowest humidity extreme has been updated, 0 if not
|-
|-
|<#AirLinkPm10_24hr[InǀOut]>
|<#HighHumidityRecordSet>
|Last 24 hours average particulate matter of 10 μm, or less, count
|1 if the all-time high humidity light extreme has been updated, 0 if not
|-
|-
|<#AirLinkPm10_Nowcast[InǀOut]>
|<#LowHumidityRecordSet>
|The 24 hour "nowcast" weighted average particulate matter of 10 μm, or less, count
|1 if the all-time low humidity extreme has been updated, 0 if not
|-
|-
|colspan="2" style="background:lightgray;"|Air Quality Index Values
|<#PressureRecordSet>
|1 if either the highest or lowest pressure extreme has been updated, 0 if not
|-
|-
|<#AirLinkAqiPm2p5[InǀOut]>
|<#HighPressureRecordSet>
|Current particulate matter of 2.5 μm, or less AQI value - allows use of the "dp=n" and "tc=y" parameters
|1 if the all-time high pressure extreme has been updated, 0 if not
|-
|-
|<#AirLinkAqiPm2p5_1hr[InǀOut]>
|<#LowPressureRecordSet>
|Last hour average particulate matter of 2.5 μm, or less, AQI value - allows use of the "dp=n" and "tc=y" parameters
|1 if the all-time low pressure extreme has been updated, 0 if not
|-
|-
|<#AirLinkAqiPm2p5_3hr[InǀOut]>
|<#WindRecordSet>
|Last 3 hour average particulate matter of 2.5 μm, or less, AQI value - allows use of the "dp=n" and "tc=y" parameters
|1 if any wind speed based extreme has been updated, 0 if not
|-
|-
|<#AirLinkAqiPm2p5_24hr[InǀOut]>
|<#HighWindrunRecordSet>
|Last 24 hour average particulate matter of 2.5 μm, or less, AQI value - allows use of the "dp=n" and "tc=y" parameters
|1 if the all-time high wind run extreme has been updated, 0 if not
|-
|}
|<#AirLinkAqiPm2p5_Nowcast[InǀOut]>
 
|Last 24 hour "nowcast" weighted average particulate matter of 2.5 μm, or less, AQI value - allows use of the "dp=n" and "tc=y" parameters
==Special tags==
 
 
 
===Davis===
 
'''Please be aware that the tags available are not the same in all versions.
[[File:Badge vMx.png]]At present this table has not yet been updated for latest MX version.'''
 
All (see note for THSWindex) of the following web tags for the Davis PWS are available from Cumulus 1.9.2. Most of the following web tags are available in Cumulus MX 3.0.0 beta from build 3019, Storm tags from 3021.
 
'''Both flavours update the values of the reception tags every 15 minutes.''' In Cumulus 1 this applies from 1.9.3, in 1.9.2 they were read, and updated, every minute, in earlier versions not available.
 
{| class="wikitable" border="1"
|-
!style="width:150px" |Web tag_name
!style="width:120px" |Applicability
!style="width:600px" |Function
|-
|-
|<#AirLinkAqiPm210[InǀOut]>
|<#DavisTotalPacketsReceived>
|Current particulate matter of 10 μm, or less value - allows use of the "dp=n" and "tc=y" parameters
|1.9.2 onwards and MX
|Total number of data packets received.
|-
|-
|<#AirLinkAqiPm10_1hr[InǀOut]>
|<#DavisTotalPacketsMissed>
|Last hour average particulate matter of 10 μm, or less, AQI value - allows use of the "dp=n" and "tc=y" parameters
|1.9.2 onwards and MX
|Number of missed data packets.  From version 3.6.0 build 3076, optionally add "tx=n" parameter, where n=1-8 and equals the desired transmitter id.
|-
|-
|<#AirLinkAqiPm10_3hr[InǀOut]>
|<#DavisMaxInARow>
|Last 3 hour average particulate matter of 10 μm, or less AQI value - allows use of the "dp=n" and "tc=y" parameters
|1.9.2 onwards and MX
|Longest streak of consecutive packets received.  From version 3.6.0 build 3076, optionally add "tx=n" parameter, where n=1-8 and equals the desired transmitter id.
|-
|-
|<#AirLinkAqiPm10_24hr[InǀOut]>
|<#DavisNumCRCerrors>
|Last 24 hour average particulate matter of 10 μm, or less AQI value - allows use of the "dp=n" and "tc=y" parameters
|1.9.2 onwards and MX
|-
|Number of packets received with CRC errors.  From version 3.6.0 build 3076, optionally add "tx=n" parameter, where n=1-8 and equals the desired transmitter id.
|<#AirLinkAqiPm10_Nowcast[InǀOut]>
|-
|Last 24 hour "nowcast" weighted average particulate matter of 10 μm, or less AQI value - allows use of the "dp=n" and "tc=y" parameters
|<#DavisNumberOfResynchs>
|-
|1.9.2 onwards and MX
|colspan="2" style="background:lightgray;"|Stats Values
|Number of times the console resynchronised with the transmitter
|-
|-
|<#AirLinkPct_1hr[InǀOut]>
|<#DavisFirmwareVersion>
|Percentage of possible values that were included in the 1 hour averages
|1.9.2 onwards and MX
|-
|The console firmware version
|<#AirLinkPct_3hr[InǀOut]>
|-
|Percentage of possible values that were included in the 3 hour averages
|<#THWindex>
|-
|1.9.x
|<#AirLinkPct_24hr[InǀOut]>
|A derived temperature using Temperature/Humidity/Wind values read from Davis DLL in Cumulus 1.9.x.
|Percentage of possible values that were included in the 24 hour averages
*The THW Index uses humidity and temperature (like Heat Index), but includes the cooling effects of wind (like wind chill).
|-
*Available from 1.9.2 Build 1009 (Aug 2011).
|<#AirLinkPct_1hr[InǀOut]>
|-
|Percentage of possible values that were included in the 24 hour weighted averages
|<#THSWindex>
|-
|(1.9.x and) MX
|colspan="2" style="background:lightgray;"|Sensor Info
|A heat stress indicator using Temperature/Humidity/Solar/Wind values.
|-
*The THSW Index uses humidity and temperature (like the Heat Index), but also includes the heating effects of sunshine, and the cooling effects of wind.
|<#AirLinkFirmwareVersion[InǀOut]>
*Therefore requires Davis station with solar sensor.
|Shows the AirLink firmware version as a date string.
[http://digitalcommons.unl.edu/cgi/viewcontent.cgi?article=1223&context=animalscinbcr  Approx calculation]: Decrease heat index by 1 unit for each 1 mph increase in wind speed, and for each, either 3 Langley increase in solar radiation, or 10% increase in cloud cover.
NOTE: This web tag requires a WeatherLink Pro subscription to work
 
|-
'''IMPORTANT NOTES:'''
|<#AirLinkTemp[InǀOut]>
#Although this tag is available in Cumulus 1.9.x, there is an issue somewhere in the Davis code that prevents Cumulus 1 obtaining the value (so tag always displays zero).
|The sensors internal temperatue value
#Search the forum for several discussions about "THSW".
|-
#Cumulus MX reads "LOOP2" packets, and the correct value for this tag can be read there and displayed on 'Now' template.
|<#AirLinkHum[InǀOut]>
|-
|The sensors internal humidity value
|<#battery>
|-
|1.x.x and MX
|<#AirLinkWifiRssi[InǀOut]>
|The console battery condition in volts. eg "4.82v"
|The sensors WiFi signal strength in dB - anything below -90 is considered very poor.
|-
NOTE: This web tag requires a WeatherLink Pro subscription to work
|<#txbattery>
<#txbattery channel=1>
|1.8.9 onwards and MX
|The transmitter battery condition, by default it returns the status of all transmitters. (This was displayed from version 1.9.4 to 1.8.9 on the main screen).
'''Cumulus 1.9.3 onwards Only:''' The optional 'channel' parameter returns the status for a particular transmitter, up to channel=8. The channel result is just the string "ok" or "LOW" for a low battery
|-
|<#StormRain>
|1.x.x and MX
|The console 'storm rain' current amount (build 1090 onwards for Cumulus 1; 3021 onwards for MX)
|-
|<#StormRainStart>
|1.x.x and MX
|The console reported '''date''' of the start of the 'storm' (the console does not report start time, but it appears a minimum of 2 tips within 3 hours will trigger a storm start, so using <#LastRainTipISO> in a script might help), but standard Cumulus [[Webtags#Time.2FDate_.27format.27_Parameter| date/time formatting]] can be applied to that date.
|}
 
===Davis WLL ===
 
New from version 3.6.0. Not available for earlier MX, not available for Cumulus 1.
 
{| class="wikitable" border="1"
|-
!style="width:150px" |Web tag_name
!style="width:600px" |Function
|-
|<#DavisReceptionPercent tx=1>
|WLL transmitter reception percentage (replace 1 by any other transmitter number up to 8)
|-
|<#DavisTxRssi tx=0>
|WLL RSSI of the WiFi connection
|-
|<#DavisTxRssi tx=1>
|WLL RSSI of Transmitter #1  (replace 1 by any other transmitter number up to 8)
|}
|}






===Ecowitt WH45 CO₂ sensor===
{{Version badge 1}} Not available in Cumulus 1.
[[File:Badge vMx.png]] Unless otherwise indicated these web tags become available from release 3.9.5.
<big>THE INFORMATION HERE IS TAKEN FROM RELEASE ANNOUNCEMENTS THAT DO NOT EXPLAIN WHAT THESE WEB TAGS REPORT
PLEASE WOULD SOMEBODY WHO UNDERSTANDS THIS TERMINOLOGY UPDATE THE FOLLOWING TABLE</big>
{| class="wikitable" border="1"
|-
!style="width:150px" |Web tag_name
!style="width:600px" |Function
|-
| <#CO2-pm2p5>
| Air Quality expressed in terms of particulate matter of 2.5 micrometres or less
|-
| <#CO2-pm2p5-24h>
| Air Quality expressed in terms of particulate matter of 2.5 μm, or less, Last 24 hours average
WILL SOMEBODY WHO KNOWS UPDATE THIS ENTRY AND OTHERS
|-
| <#CO2-pm10>
| Air Quality expressed in terms of particulate matter of 10 μm, or less
|-
| <#CO2-pm10-24h>
| Air Quality expressed in terms of particulate matter of 10 μm, or less, Last 24 hours average
WILL SOMEBODY WHO KNOWS UPDATE THIS ENTRY AND OTHERS
|-
| <#CO2-temp>
| Temperature as reported by Air Quality monitor
|-
| <#CO2-hum>
| Relative Humidity as reported by Air Quality monitor
|}




5,838

edits

Navigation menu