aemo_dispatch_units: Per-DUID dispatch output

View source: R/dispatch.R

aemo_dispatch_unitsR Documentation

Per-DUID dispatch output

Description

Returns 5-minute generator output for one or more DUIDs. Three measures are available:

Usage

aemo_dispatch_units(
  duid = NULL,
  start,
  end,
  measure = c("scada_mw", "target_mw", "both")
)

Arguments

duid

Optional character vector of DUIDs. NULL returns all generators.

start, end

Window (inclusive).

measure

One of "scada_mw" (default), "target_mw", or "both".

Details

  • "scada_mw" (default): actual metered output from DISPATCH_UNIT_SCADA (SCADAVALUE).

  • "target_mw": dispatch target from DISPATCHLOAD (TOTALCLEARED). This is the MW AEMO asked the unit to produce at the end of the interval.

  • "both": returns SCADAVALUE, INITIALMW (SCADA at the start of the interval) and TOTALCLEARED (target at the end) in a single row per DUID per interval. Use this for ramp-trajectory research: the ramp applied during the interval is the straight line from INITIALMW to TOTALCLEARED.

Timestamps are AEST (UTC+10, no DST).

Value

An aemo_tbl with columns settlementdate, duid, and the requested measure(s).

See Also

Other dispatch: aemo_bids(), aemo_constraints(), aemo_fcas_enablement(), aemo_gencon(), aemo_interconnector(), aemo_market_notices(), aemo_outages(), aemo_rooftop_pv(), aemo_spd_constraints()

Examples


op <- options(aemo.cache_dir = tempdir())
try({
  now <- Sys.time()
  # SCADA actual
  d <- aemo_dispatch_units(duid = "BW01", start = now - 3600,
                            end = now)

  # Paired: INITIALMW, TOTALCLEARED, SCADAVALUE (ramp research)
  d_both <- aemo_dispatch_units(duid = "BW01",
                                 start = now - 3600, end = now,
                                 measure = "both")
})
options(op)


aemo documentation built on April 29, 2026, 1:07 a.m.