aemo (version 0.4.3)

aemo_units: NEM generators (DUID registry)

Description

Downloads the DUDETAILSUMMARY table from the most recent MMSDM monthly archive and returns one row per registered DUID (Dispatchable Unit Identifier) with station, region, dispatch type, classification, and schedule type. Typical output is 500+ DUIDs covering scheduled, semi-scheduled, and non-scheduled generators, bidirectional storage (BESS), and loads.

Usage

aemo_units(as_of = NULL)

Value

An aemo_tbl keyed by duid. Columns include (from DUDETAILSUMMARY): duid, stationid, regionid, dispatchtype (GENERATOR / LOAD), connectionpointid, schedule_type (SCHEDULED / SEMI-SCHEDULED / NON-SCHEDULED), start_date, end_date.

Arguments

as_of

Optional Date or POSIXct. Returns the DUID registry as it was on that date. NULL (default) returns the current registry.

Details

Effective-date filtering. DUDETAILSUMMARY is effective-dated (START_DATE, END_DATE per row with multiple VERSIONNO vintages per DUID over time). The default (as_of = NULL) returns rows whose [START_DATE, END_DATE] interval covers the date the MMSDM archive was published: i.e. the current registry. Pass an as_of date to get the registry as it was on that date (essential for historical analysis: Liddell's four DUIDs were retired in April 2023; pre-2023 queries need them).

This matches the as-of-join pattern documented in Gorman et al. (2018) NEMOSIS (APSRC) for correct historical joins.

See Also

Other reference: aemo_dlf(), aemo_interconnectors(), aemo_mlf(), aemo_participants(), aemo_price_caps(), aemo_regions(), aemo_settlement(), aemo_snapshot()

Examples

# \donttest{
op <- options(aemo.cache_dir = tempdir())
try({
  # Current DUID registry
  u <- aemo_units()

  # DUIDs as they were on 1 March 2023 (pre-Liddell retirement)
  u_2023 <- aemo_units(as_of = "2023-03-01")
})
options(op)
# }