uataq.sites.Site#

class uataq.sites.Site(SID, config, instruments)[source]#

A class representing a site where atmospheric measurements are taken.

Variables:
  • SID (str) – The site identifier.

  • config (dict) – A dictionary containing configuration information for the site.

  • instruments (InstrumentEnsemble) – An instance of the InstrumentEnsemble class representing the instruments at the site.

  • groups (set of str) – The research groups that collect data at the site.

  • loggers (set of str) – The loggers used by research groups that record data at a site.

  • pollutants (set of str) – The pollutants measured at the site, in upper case ('NOX' for NOx). get_obs takes them in any case.

  • pollutant_instruments (dict[str, list[Instrument]]) – The instruments that measure each pollutant, keyed by the pollutant’s upper-case name, as in pollutants.

__init__(SID, config, instruments)[source]#

Initialize a Site object with the given site ID.

Parameters:
  • SID (str) – The site identifier.

  • config (dict) –

    A dictionary containing configuration information for the site:

    {
        name: str,
        is_active: bool,
        is_mobile: bool,
        latitude: float,
        longitude: float,
        zagl: float,
        loggers: dict,
        instruments: {
            instrument: {
                loggers: dict
                installation_date: str,
                removal_date: str,
            }
        }
    }
    

  • instruments (InstrumentEnsemble) – An instance of the InstrumentEnsemble class representing the instruments at the site.

Methods

get_obs([pollutants, format, group, ...])

Get observations for each pollutant, combining instruments by pollutants.

get_recent_obs([recent, pollutants, format, ...])

Get recent observations from site instruments.

read_data([instruments, group, lvl, ...])

Read data for the specified instruments and level.