tseda.dataloader.uci_air_quality_data_loader module

Data loader for UCI Air Quality hourly data.

class tseda.dataloader.uci_air_quality_data_loader.UCIAirQualityDataLoader(file_path: str = 'data/uci_air_quality_hourly_co.csv')

Bases: LocalDataLoader

Download, normalize, and expose UCI Air Quality data as a signal series.

Configure output location for prepared hourly CO series.

DATASET_URL = 'https://archive.ics.uci.edu/static/public/360/air+quality.zip'

CSV_NAME_IN_ZIP = 'AirQualityUCI.csv'

__init__(file_path: str = 'data/uci_air_quality_hourly_co.csv') → None

Configure output location for prepared hourly CO series.

download_and_prepare() → pandas.DataFrame

Download UCI Air Quality zip, prepare data, and write CSV to data directory.

load_air_quality(refresh: bool = False) → pandas.DataFrame

Load prepared air-quality data; download first if missing or refresh requested.

Returns:

DataFrame with columns date and signal. Returns an empty DataFrame if source data cannot be loaded.

get_series(refresh: bool = False) → pandas.Series

Return the air-quality CO signal as a pandas Series indexed by date.

Returns:

signal series indexed by date. Returns an empty float series when no data is available.