turkiye

docs/data/countries.json

@@ -188,7 +188,7 @@
     "TO": "Tonga",
     "TT": "Trinidad and Tobago",
     "TN": "Tunisia",
-    "TR": "Turkey",
+    "TR": "Türkiye",
     "TM": "Turkmenistan",
     "TV": "Tuvalu",
     "UG": "Uganda",

docs/data/turkiye/breakpoints.csv

@@ -0,0 +1,31 @@
+ISO,variant,category,hex,category_lower,category_upper,pollutant,units,averaging_period,concentration_lower,concentration_upper
+TR,,Good,#11af66,0,50,SO2,ug/m3,1,0,100
+TR,,Good,#11af66,0,50,NO2,ug/m3,1,0,100
+TR,,Good,#11af66,0,50,CO,ug/m3,8,0,5500
+TR,,Good,#11af66,0,50,O3,ug/m3,8,0,120
+TR,,Good,#11af66,0,50,PM10,ug/m3,24,0,50
+TR,,Medium,#fff013,51,100,SO2,ug/m3,1,101,250
+TR,,Medium,#fff013,51,100,NO2,ug/m3,1,101,200
+TR,,Medium,#fff013,51,100,CO,ug/m3,8,5501,10000
+TR,,Medium,#fff013,51,100,O3,ug/m3,8,121,160
+TR,,Medium,#fff013,51,100,PM10,ug/m3,24,51,100
+TR,,Sensitive,#ff9523,101,150,SO2,ug/m3,1,251,500
+TR,,Sensitive,#ff9523,101,150,NO2,ug/m3,1,201,500
+TR,,Sensitive,#ff9523,101,150,CO,ug/m3,8,10001,16000
+TR,,Sensitive,#ff9523,101,150,O3,ug/m3,8,161,180
+TR,,Sensitive,#ff9523,101,150,PM10,ug/m3,24,101,260
+TR,,Unhealthy,#e20000,151,200,SO2,ug/m3,1,501,850
+TR,,Unhealthy,#e20000,151,200,NO2,ug/m3,1,501,1000
+TR,,Unhealthy,#e20000,151,200,CO,ug/m3,8,16001,24000
+TR,,Unhealthy,#e20000,151,200,O3,ug/m3,8,181,240
+TR,,Unhealthy,#e20000,151,200,PM10,ug/m3,24,261,400
+TR,,Bad,#d10d65,201,300,SO2,ug/m3,1,851,1100
+TR,,Bad,#d10d65,201,300,NO2,ug/m3,1,1001,2000
+TR,,Bad,#d10d65,201,300,CO,ug/m3,8,24001,32000
+TR,,Bad,#d10d65,201,300,O3,ug/m3,8,241,700
+TR,,Bad,#d10d65,201,300,PM10,ug/m3,24,401,520
+TR,,Dangerous,#b31340,301,500,SO2,ug/m3,1,1101,
+TR,,Dangerous,#b31340,301,500,NO2,ug/m3,1,2001,
+TR,,Dangerous,#b31340,301,500,CO,ug/m3,8,32001,
+TR,,Dangerous,#b31340,301,500,O3,ug/m3,8,701,
+TR,,Dangerous,#b31340,301,500,PM10,ug/m3,24,521,

docs/indices/turkiye.md

@@ -0,0 +1,54 @@
+
+# Türkiye
+
+## Hava Kalitesi İndeksi (HKİ)
+
+```js
+import {breakpointsTable} from "../components/table.js";
+import { parseBreakpointsCsv, tableReshape, colorScaleReshape } from '../utils/utils.js';
+import { colorScale } from '../components/color-scale.js';
+const breakpoints = await FileAttachment('../data/turkiye/breakpoints.csv').text();
+const data = parseBreakpointsCsv(breakpoints);
+```
+
+## Background
+
+The Hava Kalitesi İndeksi (HKİ) was developed by the Ministry of Environment, Urbanisation and Climate Change, Türkiye Cumhuriyeti Çevre, Şehircilik ve İklim Değişikliği Bakanlığı (CSB). Five criteria pollutants, PM<sub>10</sub>, CO, O<sub>3</sub>, SO<sub>2</sub>, and NO<sub>2</sub>, are covered in the methodology. The HKİ reports an hourly AQI value based on the reported pollutants.
+
+## Color scale
+
+The HKİ scale is composed of 6 value bands ranging from 0 to 500, with a distinct color for each band.
+
+```js
+colorScale(colorScaleReshape(data))
+```
+
+_Note_: Adapted from "Hava Kalitesi İndeksi" (n.d.), [https://egethm.csb.gov.tr/hava-kalitesi-indeksi-i-87403](https://egethm.csb.gov.tr/hava-kalitesi-indeksi-i-87403). Accessed October 1, 2024.
+
+## Methods
+
+The HKİ uses a sub-index method where each pollutant is calculated against pollutant-specific breakpoints into a pollutant sub-index value. All pollutants are then compared and the largest sub-index value determines the full composite AQI value. The CSB provides no specific guidance provided on the minimum number of pollutants required to compute a full composite index.
+
+Pollutant breakpoints are defined in the table below:
+
+```js
+breakpointsTable(data)
+```
+
+_Note_: Adapted from "Hava Kalitesi İndeksi" (n.d.), [https://egethm.csb.gov.tr/hava-kalitesi-indeksi-i-87403](https://egethm.csb.gov.tr/hava-kalitesi-indeksi-i-87403). Accessed October 1, 2024.
+
+Using the breakpoint values in the table above, a [piecewise linear function](/methods#piecewise-linear-function) is used to convert the concentration values to HKİ values. This method is not explicity listed in the source doucmented but is listed as following the same method as the US EPA. There is no specific guidance in the source material about rounding or truncating concentration values, but based on the table above, values are either whole numbers or up to one decimal place of precision. Given there are no upper bounds on the pollutant thresholds for the "Dangerous" category, it is unclear from the source material what upper breakpoint values is used for the piecewise function. The piecewise linear function is defined as:
+
+```js
+import {piecewiseLatexDoc} from '../components/piecewise.js';
+```
+
+```js
+piecewiseLatexDoc('HKİ')
+```
+
+## References
+
+https://egethm.csb.gov.tr/hava-kalitesi-indeksi-i-87403
+
+https://cevre.ibb.istanbul/hava-kalitesi/hava-kalitesi-indeksi/

observablehq.config.js

@@ -45,6 +45,7 @@ export default {
         {name: "South Korea", path: "/indices/south-korea"},
         {name: "Taiwan", path: "/indices/taiwan"},
         {name: "Thailand", path: "/indices/thailand"},
+        {name: "Türkiye", path: "/indices/turkiye"},
         {name: "United Arab Emirates", path: "/indices/uae"},
         {name: "United Kingdom", path: "/indices/uk"},
         {name: "United States of America", path: "/indices/us"},