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

View source: R/loss_factors.R

aemo_mlfR Documentation

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)

Arguments

year

Financial year(s) as "YYYY-YY" strings (e.g. "2024-25"). NULL returns all available years. Multiple years accepted.

duid

Optional character vector of DUIDs to filter on. NULL returns all DUIDs. See aemo_units() for the full DUID registry.

Details

MLFs are published annually by AEMO under NER 3.6.2 and are used in settlement calculations and in PPA revenue reconstruction. The function first attempts to download the TRANSMISSIONLOSSFACTOR table from the most recent MMSDM monthly archive; if that fails it returns a bundled static table covering FY 2020-21 to FY 2025-26 for ~20 well-known DUIDs.

Value

An aemo_tbl with columns financial_year, duid, connectionpointid, regionid, mlf. From a live MMSDM download additional columns (participantid, lastchanged) may also be present.

Source

AEMO MMSDM archive, TRANSMISSIONLOSSFACTOR table. AEMO Copyright Permissions Notice.

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


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


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