Skip to contents

Marginal Loss Factors (MLF) by DUID and financial year

Source: R/loss_factors.R
aemo_mlf.Rd

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)

Source

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

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.

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.

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.

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)
})
#> ℹ Downloading <https://nemweb.com.au/Data_Archive/Wholesale_Electricity/MMSDM/2…
#> ✔ Downloading <https://nemweb.com.au/Data_Archive/Wholesale_Electricity/MMSDM/2…
#> 
#> Error in aemo_mlf(year = "2024-25") : 
#>   Could not retrieve TRANSMISSIONLOSSFACTOR from MMSDM.
#> ℹ MLFs are published annually by AEMO under NER 3.6.2. For historical analysis,
#>   download the determination PDF directly from aemo.com.au, or retry when the
#>   MMSDM archive is reachable.
#> ℹ No fallback is provided: unsourced MLF values would be a correctness trap in
#>   settlement and PPA workflows.
options(op)
# }