smear_api package

smear_api.tools module

smear_api.tools.getData(variables, dates=None, start=None, end=None, quality='ANY', averaging='1', avg_type='NONE')[source]

Get timeseries of variables using Smart SMEAR API

Parameters:
variablesstring or array of strings

name of a measured quantity in the database (tablevariable)

datesdatetime object or string or array of datetime objects or strings

the date(s) for which measurements are downloaded

startdatetime object or string

begin of measurement

enddatetime object or string

end of measurement

qualitystring

“ANY”

averagingstring

“1” (no averaging), “30” (30 min) or “60” (60 min)

avg_typestring

“NONE”, “ARITHMETIC”, “MEDIAN”, “MIN” or “MAX”

Returns:
pandas DataFrame or list of DataFrames

downloaded data, list is given for array of date objects

smear_api.tools.getDmpsData(station='HYY', start=None, end=None, dates=None, quality='ANY', averaging='1', avg_type='NONE')[source]

Get DMPS data using Smart SMEAR API

Parameters:
stationstring

“HYY”, “KUM” or “VAR”

datesdatetime object or string or array of datetime objects or strings

the days for which data is are downloaded

startdatetime object or string

begin time for data

enddatetime object or string

end time for data

qualitystring

“ANY”

averagingstring

“1” (no averaging), “30” (30 minutes) or “60” (60 minutes)

avg_typestr

“NONE”, “ARITHMETIC”, “MEDIAN”, “MIN” or “MAX”

Returns:
pandas DataFrame or list of DataFrames

downloaded data, list is given when dates is array

index = time (utc+2) columns = bin geometric mean diameters (m) values = dN/dlogDp (cm-3)

smear_api.tools.getVariableMetadata(variables)[source]

Get variable metadata using Smart SMEAR API

Parameters:
variablesstring or array of strings

name (tablevariable) of a measured quantity in the database

Returns:
dictionary or list of dictionaries

metadata for given tablevariables

smear_api.tools.listAllData(search_term=None, verbose=False)[source]

List and describe variables in the SMEAR database

Parameters:
search_termstring

search term for searching the database, if None all results are returned.

verboseboolean

verbose or not verbose output

Returns:
pandas DataFrame