Webtags/Parameters (preserving history): Difference between revisions

m
m (Text replacement - "[[Setting_up_Raspberry_Pi" to "[[MX_on_Linux")
Line 47: Line 47:
An input parameter is used where the same web tag can represent a value for a number of different past time instants. Each of those past time instants is represented by a different value for the input parameter. So a combination of web tag name and input parameter lets Cumulus to pick the value you want to see.  
An input parameter is used where the same web tag can represent a value for a number of different past time instants. Each of those past time instants is represented by a different value for the input parameter. So a combination of web tag name and input parameter lets Cumulus to pick the value you want to see.  


There are currently only two groups of tags where an input parameter is mandatory:
For the legacy Cumulus 1, there are only two groups of tags where an input parameter is mandatory:
#The [[Webtags#Recent_History|'''recent history tags''']] where a separate value exists for potentially every individual minute in last week.
#The [[Webtags#Recent_History|'''recent history tags''']] where a separate value exists for potentially every individual minute in last week.
#* These tags need between one and three input parameters  as explained below.
#* These tags need between one and three input parameters  as explained below.
#The [[Webtags#Monthly_All_Time_Records|'''monthly all-time records''']] where a separate value exists for each particular month (of any year).  
#The [[Webtags#Monthly_All_Time_Records|'''monthly all-time records''']] where a separate value exists for each particular month (of any year).  
#*These tags need an input parameter specifying which month.  
#*These tags need an input parameter specifying which month.  
#*To save you looking up the linked section, a single input parameter is needed (which is 1 for January to 12 for December, or 0 for current month).
#*To save you looking up the linked section, a single input parameter is needed (which is 1 for January to 12 for December, or 0 for current month), e.g. <#ByMonthDewPointH mon=3> is highest monthly dew point for any March and <#ByMonthDewPointHT mon=3> is the related time and date.
 
MX release 3.12.0 onwards adds a third group of tags where an input parameter is optional:
* The web tag <#SunshineHoursMonth> is new in 3.12.0 and optionally take parameters
** Without input parameters, the above two web tags will return the total sunshine hours for the current month, and current year, respectively
** Use <code><#SunshineHoursMonth m=xx y=nnnn></code> to show the monthly total sunshine hours for month number xx and 4 digit year nnnn e.g. <#SunshineHoursMonth y=2021 m=1> for the January 2021 total
** Alternatively use <code><#SunshineHoursMonth r=-ww></code> to show the monthly total sunshine hours for relative month number e.g. <#SunshineHoursMonth r=-1> for last months total, and <#SunshineHoursMonth r=-12> for same month as current month, but one tear ago
* The web tag  <#SunshineHoursYear> is also new in 3.12.0 and optionally take parameters
** Use <code><#SunshineHoursYear y=nnnn></code> to show the yearly total sunshine hours for a previous year, e.g. <#SunshineHoursYear y=2019> for the total for 2019
** Alternatively use <code><#SunshineHoursyear r=-ww></code> to show the yearly total sunshine hours for relative year number, e.g. <#SunshineHoursYear r=-2> total for the year before last




5,838

edits