airbase.parquet_api.dataset module

class airbase.parquet_api.dataset.AggregationType(value)[source]

Bases: str, Enum

represents whether the data collected is obtaining the values: 1. Hourly data. 2. Daily data. 3. Variable intervals (different than the previous observations such as weekly, monthly, etc.)

https://eeadmz1-downloads-webapp.azurewebsites.net/content/documentation/How_To_Downloads.pdf

Daily = 'day'

Hourly = 'hour'

Other = 'var'

VariableIntervals = 'var'

class airbase.parquet_api.dataset.Dataset(value)[source]

Bases: IntEnum

1. Unverified data transmitted continuously (Up-To-Date/UTD/E2a) data from the beginning of 2024. 2. Verified data (E1a) from 2013 to 2023 reported by countries by 30 September each year for the previous year. 3. Historical Airbase data delivered between 2002 and 2012 before Air Quality Directive 2008/50/EC entered into force.

https://eeadmz1-downloads-webapp.azurewebsites.net/content/documentation/How_To_Downloads.pdf

Airbase = 3

E1a = 2

E2a = 1

Historical = 3

UDT = 1

Unverified = 1

Verified = 2

class airbase.parquet_api.dataset.ParquetData(country, dataset, pollutant=None, city=None, frequency=None, source='API')[source]

Bases: NamedTuple

info needed for requesting the URLs for country and dataset the request can be further restricted with the pollutant, city and frequency

Create new instance of ParquetData(country, dataset, pollutant, city, frequency, source)

Parameters:

country (str) –
dataset (Dataset) –
pollutant (frozenset[str] | None) –
city (str | None) –
frequency (AggregationType | None) –
source (str) –

city: str | None: Alias for field number 3

country: str: Alias for field number 0

dataset: Dataset: Alias for field number 1

frequency: AggregationType | None: Alias for field number 4

payload()[source]

Return type:: ParquetDataJSON

pollutant: frozenset[str] | None: Alias for field number 2

source: str: Alias for field number 5

airbase.parquet_api.dataset.request_info_by_city(dataset, *cities, pollutants=None, frequency=None)[source]

download info one city at the time

Parameters:

dataset (Dataset) –
pollutants (frozenset[str] | set[str] | None) –
frequency (AggregationType | None) –

Return type:

set[airbase.parquet_api.dataset.ParquetData]

airbase.parquet_api.dataset.request_info_by_country(dataset, *countries, pollutants=None, frequency=None)[source]

download info one country at the time

Parameters:

dataset (Dataset) –
pollutants (frozenset[str] | set[str] | None) –
frequency (AggregationType | None) –

Return type:

set[airbase.parquet_api.dataset.ParquetData]