___                            _      ______ _            _               _
 / _ \                          (_)     | ___ \ |          | |             | |
/ /_\ \_ __ _ __ ___   ___ _ __  _  __ _| |_/ / | __ _  ___| | _____  _   _| |_ ___   ___  _ __ __ _
|  _  | '__| '_ ` _ \ / _ \ '_ \| |/ _` | ___ \ |/ _` |/ __| |/ / _ \| | | | __/ __| / _ \| '__/ _` |
| | | | |  | | | | | |  __/ | | | | (_| | |_/ / | (_| | (__|   < (_) | |_| | |_\__ \| (_) | | | (_| |
\_| |_/_|  |_| |_| |_|\___|_| |_|_|\__,_\____/|_|\__,_|\___|_|\_\___/ \__,_|\__|___(_)___/|_|  \__, |
                                                                                                __/ |
Official data repository of ArmeniaBlackouts.org                                               |___/

This repository contains the data used by ArmeniaBlackouts.org. The data is updated hourly, you can use it
freely on your own projects.

Please note that the data is provided as is, and we do not guarantee its accuracy. If you find any issues,
please report them to us by email: druidvav@gmail.com.

We kindly ask you to keep the bandwidth usage to a minimum. Please, download the data only once per hour
and only data you need.

=======================
Available files
=======================

sensors.csv - Contains the list of sensors and their stations. Updated hourly.

    id - unique sensor ID
    station_id - station ID, several sensors can be located at the same station
    city_slug - city of the sensor
    district_slug - district of the sensor, can be empty
    address_en - address in English
    title - title of the sensor, can be empty
    provider - sensor provider: sensor_community, yerevan_gis, purple_air, clarity.
    external_id - sensor ID in the provider's system
    sensor_type - sensor type: SDS011, BME280 or other
    latitude
    longitude
    altitude - altitude in meters, can be empty
    first_measurement_time - timestamp of the first measurement
    last_measurement_time - timestamp of the last measurement
    is_suspicious - true if the sensor data looks suspicious, false otherwise

sensor_avg_daily.csv - Contains the daily average values of the sensors. Updated daily.

    sensor_id - sensor ID
    timestamp - date of the measurement in the format YYYY-MM-DD 00:00:00
    avg_pm2.5 - average corrected PM2.5 value
    avg_pm10 - average PM10 value
    avg_temperature - average temperature in Celsius
    avg_pressure - average pressure in Pa
    avg_humidity - average humidity in percent

station_avg_daily.csv - Contains the daily average values of the stations. Updated daily.

    station_id - station ID
    timestamp - date of the measurement in the format YYYY-MM-DD 00:00:00
    avg_pm2.5 - average corrected PM2.5 value
    avg_pm10 - average PM10 value
    avg_temperature - average temperature in Celsius
    avg_pressure - average pressure in Pa
    avg_humidity - average humidity in percent

sensor_avg_hourly/sensor_avg_hourly_{year}.csv
 - Contains the hourly average values of the sensors. Updated daily. Last file updated hourly.
   Same format as sensor_avg_daily.csv.

station_avg_hourly/station_avg_hourly_{year}.csv
 - Contains the hourly average values of the stations. Updated daily. Last file updated hourly.
   Same format as station_avg_daily.csv.

measurements/measurements_{year}_{month}.csv
 - Contains the raw measurements of the sensors. Updated daily. Last file updated hourly.

    sensor_id - sensor ID
    timestamp - date of the measurement in the format YYYY-MM-DD HH:MM:SS
    time_start - start of the measurement period in the format YYYY-MM-DD HH:MM:SS (for average values)
    time_end - end of the measurement period in the format YYYY-MM-DD HH:MM:SS (for average values)
    pm2.5 - raw PM2.5 value
    pm2.5_corrected - corrected PM2.5 value
    pm10 - raw PM10 value
    temperature - temperature in Celsius
    pressure - pressure in Pa
    humidity - humidity in percent