AirLink: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
2,062 bytes added ,  10:22, 3 September 2022
m
mNo edit summary
 
(9 intermediate revisions by the same user not shown)
Line 5: Line 5:
'''''NOTE: Before version 6.1 this section was named AirQuality'''''
'''''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 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 Air Quality devices will need a consistent use of an underlying data structure and interface to be supported.
In 2020 support for the [https://www.davisinstruments.com/airlink/ Davis Airlink] device was introduced in CumulusMX. Although Air Quality sensors had been supported by CumulusMX as Extra Sensors, this Davis device had specific tables and support incorporated and as such required specific support by CumulusUtils. The Davis Airlink is supported by a Table view and by graphing the measured values. Future Air Quality devices will need a consistent use of an underlying data structure and interface to be supported.


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.
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.
Line 19: Line 19:
and:
and:
   ''utils/bin/cumulusutils.exe [[UserAskedData]]''  => this command produces the Airlink datafiles with only those data required for the user wanted display.
   ''utils/bin/cumulusutils.exe [[UserAskedData]]''  => this command produces the Airlink datafiles with only those data required for the user wanted display.
=== 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 ==
== Output ==
Line 38: Line 59:
   WantToSee24hr=true            => If true will show the 24 hour running average
   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
   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 ==
== Inner working ==
Line 72: Line 95:


The line colouring obeys the default colouring of the current theme. No colouring is applied or defined with the graph itself.
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 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 messages) with information. For the calculations the values produced by CMX are used. The spreadsheet shows the values used in countries and their relation with the actual PM concentration. See also the Help button.
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 posts) with information. For the calculations the values produced by CMX are used. The spreadsheet shows the values used in countries and their relation with the actual PM concentration. See also the Help button.


=== The Help Button ===
=== The Help Button ===

Navigation menu