spaemis.scaling.proxy

Proxy scaler

A proxy scaler uses a proxy (a 2d pattern) to disaggregate an emissions timeseries over a target area.

The proxy must cover the area of interest of the emissions timeseries

ProxyScaler

class ProxyScaler(proxy, variable_id, source_id, sector)[source]

Bases: BaseScaler

Combine global emissions with a proxy

The spatial pattern of the global emissions are ignored, but the quantity over the area of interest is preserved.

classmethod create_from_config(method)[source]

Create a scaler from configuration

Return type:

spaemis.scaling.proxy.ProxyScaler

get_proxy

get_proxy(proxy_name, inventory)[source]

Retrieve a proxy given a name

The prefix of the proxy species the type of proxy used. The options for proxies are:

  • population - Spatial population from SEDACS

  • residential_density - Map of residential density over Australia

  • inventory|X - Data for a sector X from the current inventory. The NOx variable is used

  • australian_inventory|X - Data for a sector X from the Australian inventory. The NOx

    variable is used

For the population and residential_density proxies, a precalculated file is used. The scripts for generating these files are in scripts/. By default, the location for these proxies is data/processed/proxies, but this can be overridden using the SPAEMIS_PROXY_DIRECTORY environment variable.

Parameters:
  • proxy_name (str) –

    Name of proxy

    Can include a “|” to denote hierarchy

  • inventory (spaemis.inventory.EmissionsInventory) – An emission inventory in the case the “inventory” proxy is used

Returns:

xarray.core.dataarray.DataArray – Selected proxy field with dimensions lat and lon

The latitude/longitude grid of the proxy may differ depending on the choice