1,953
edits
AirLink: Difference between revisions
m
→Inifile Parameters
(Initial edit) |
|||
| (14 intermediate revisions by the same user not shown) | |||
|
== Introduction ==
{|align=right
In 2020 support for the [https://www.davisinstruments.com/airlink/ Davis Airlink] device was introduced in CumulusMX. Although AirQuality sensors had been supported by CumulusMX as Extra Sensors - which are not supported by CumulusUtils - this Davis device had specific tables and support incorporated and as such could be supported by CumulusUtils. The Davis Airlink is supported by a Table view and by graphing the measured values. Future AirQuality devices will need a consistent use of an underlying data structure and interface to be supported. ▼
|__TOC__
|}
'''''NOTE: Before version 6.1 this section was named AirQuality'''''
▲In 2020 support for the [https://www.davisinstruments.com/airlink/ Davis Airlink] device was introduced in CumulusMX. Although
Air Quality in the context of the AirLink is about Particulate Matter or fine dust particles of size of less then 10<math>\mu{m}</math> and less than 2.5<math>\mu{m}</math>. Duration of exposure of a certain average value gives an Air Quality Index which differs per country. On the forum information about this is available and linked below.
== Operation ==
The operation requires two steps:
#creating the
#creating the datafile to be used by the
The commands for the above named steps are:
''utils/bin/cumulusutils.exe
and:
''utils/bin/cumulusutils.exe [[UserAskedData]]'' => this command produces the
=== Country settings ===
''CumulusMX'' knows the following country settings:
US, UK, EUAQI, EUCAQI, CA, AU, NL, BE
The type indicator has been left out except for the EU so USA-EPA becomes simply US in this example.
''CumulusUtils'' knows the following countries:
US, UK, CA, EU, AU, NL, BE
These match one to one which is easy to understand except for the EU. Both EU settings from CumulusMX are projected on EU in CumulusUtils.
These country systems are explained in [https://cumulus.hosiene.co.uk/viewtopic.php?p=148658#p148658 this post here].
As you can see in that forum post linked above, the values for the two EU AQI standards do not differ that much so I merged them into EU-CAQI. The choice of these AQI calculations leads in CUtils to the reference lines. CUtils does chart the concentrations only, not the AQI.
The Canadian system is the only one which uses a formula and not a table. That is why it only accepts 3 hr averages.
To program the exact AQI representation at certain concentrations for specific particle size is - according to me, i.e. [https://cumulus.hosiene.co.uk/memberlist.php?mode=viewprofile&u=9016 HansR] - an incorrect presentation of the danger levels involved (apart from the complexity in doing so). Danger levels involved must be uniform and the same everywhere in the world, as they are to be projected on humans and not dependent on politics of a country (compare e.g. the danger levels of the US to those of the EU). So CumulusUtils deviates here from CMX and it may in future even remove the AQI per country completely and replace that with the WHO reference which recently has become available (see my link to the forum post above).
== Output ==
The output is the file: ''
The output for the datafiles is: ''airlinkdataOut2p5.json'' and ''airlinkdataOut10.json''
== Inifile Parameters ==
The
(Before version
[Airlink]
CountrySelected=EU => Determines the country for which the AQI must be calculated. This value must be identical to what is entered in CMX
WantToSeeNow=true => If true will show the raw data
WantToSee24hr=true => If true will show the 24 hour running average
WantToSeeWind=true => If true will show the windbarbs in the chart indicating the wind direction
CleanupAirlinkLogs=false => If true will remove old logfiles and keep only the current and the previous month
ReferenceLineThickness=4 => The thickness of the reference lines in points. Default is 4.
== Inner working ==
For each sensor (In and Out) similar code is produced with similar coding of variable names.
Then, for facilitating realtime behaviour, the file ''airlinkrealtime.txt'' is generated which the user has to enter in the ''Extra Webfiles'' section in the settings of CumulusMX. The target directory must be the webroot (where the
Then the menu is generated, creating two buttons to enable the user to switch between Table view and Graph view. In case of the Website Generator there is also a help button displaying information about the
=== TableView ===
for (i = 0; i < 5; i++) { (i+1 == nowcastPM10_OutAQIint ? $('#nowcastPM10ArrowOut'+i).html('▲') : $('#nowcastPM10ArrowOut'+i).html(' ') ); }
Where the coding of the fields and variables is rigid and should not be
=== GraphView ===
The line colouring obeys the default colouring of the current theme. No colouring is applied or defined with the graph itself.
One special feature for all charts in CumulusUtils is the possibility for the background image. This is described in [[Website_Generator#Chart_Background_Images|the chapter on the website]]
=== The Air Quality Index (AQI) ===
The AQI is different per country. It is the warning level translation from the actual concentrations of Particulate matter measured. The AQI differs per country but differs not only in value but also in the series of value used. I created [https://cumulus.hosiene.co.uk/viewtopic.php?f=44&t=18602 thread on the forum] (first two
=== The Help Button ===
Because the Help button is not available in the the modular use of the
In Air Quality (with either the cheap sensors or the government published data) it is important to know about the Air Quality Indices (AQI) and PM concentrations. Those are very different things. The AQI differ very much per country, per period (1 hr, 3 hr or 24 hr averages) and in scales (6 divisions or 10 divisions with subdivisions). To make it even more complex, some countries did combine the fine dust (PM) AQIs with indices for SO2 and NO2. That is ignored here. These graphs only deal with Particulate Matter sensors. <b>Please be aware that the scaling of the graphs is dynamic.</b>
| |||