aemo (version 0.4.3)

aemo_mlf: Marginal Loss Factors (MLF) by DUID and financial year

Description

Returns the Marginal Loss Factor applicable to each DUID for the requested financial year(s). MLFs measure the incremental network loss at a connection point relative to the Regional Reference Node (RRN); a DUID with MLF = 0.97 receives 97% of the regional RRP per MWh generated.

Usage

aemo_mlf(year = NULL, duid = NULL)

Value

An aemo_tbl with one row per connection point and effective date: financial_year, connectionpointid, regionid, mlf, effectivedate, versionno, secondary_tlf and lastchanged, plus duid when duid is given. A factor revised during the year appears once per effective date.

Arguments

year

Financial year(s) as "YYYY-YY" strings (e.g. "2025-26"). NULL (the default) returns the current financial year. Multiple years accepted; each needs up to 13 small downloads.

duid

Optional character vector of DUIDs to filter on. MMSDM publishes MLFs by connection point, so DUIDs are mapped to connection points through the unit registry (aemo_units()), which adds a duid column. NULL returns every connection point.

Details

MLFs are published annually by AEMO under NER 3.6.2 and are used in settlement calculations and in PPA revenue reconstruction. Each year's determination is read from the TRANSMISSIONLOSSFACTOR table of the June MMSDM archive that precedes it, together with the revisions in the monthly archives after it. There is no bundled fallback: if MMSDM cannot be reached the function errors rather than return unsourced values.

See Also

aemo_units() for the DUID registry, aemo_price() for regional RRPs.

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

Examples

# \donttest{
op <- options(aemo.cache_dir = tempdir())
try({
  mlf <- aemo_mlf(year = "2024-25")
  head(mlf)
})
options(op)
# }