Binding transmission and system constraints

Returns the DISPATCHCONSTRAINT table from NEMweb: one row per binding (or near-binding) constraint per 5-minute dispatch interval. Each row records the constraint ID, the left-hand side (LHS) and right-hand side (RHS) values, the marginal value (shadow price on the constraint in AUD/MWh), and the violation degree if any.

Usage

aemo_constraints(
  start,
  end,
  constraint_id = NULL,
  intervention = FALSE,
  min_marginal_value = 0.01
)

Source

AEMO NEMweb DISPATCHIS_Reports, DISPATCHCONSTRAINT table.

Arguments

start, end: Window (inclusive), character or POSIXct.
constraint_id: Optional character vector of constraint IDs (e.g. "N>>N-NIL_1", "V::S_NIL_TBSE"). NULL returns all binding constraints in the window.
intervention: Logical. Default FALSE.
min_marginal_value: Numeric. Only return constraints with marginal value at or above this threshold (AUD/MWh). 0 returns every row; the default of 0.01 filters out near-zero shadow prices that are typically noise.

Value

An aemo_tbl with columns settlementdate, constraintid, rhs, marginalvalue, violationdegree, lhs, plus the intervention flag.

Details

This is the table that answers the question "why was the RRP so high at 17:35?": the sum of marginal values across binding constraints at the Regional Reference Node equals the regional price component attributable to network limits.

Constraint equations and RHS terms (GENCONDATA, GENCONSETINVOKE) are published through MMSDM on a separate cadence and are not exposed directly by this function; use aemo_nemweb_download() on an MMSDM URL for those.

Examples

# \donttest{
op <- options(aemo.cache_dir = tempdir())
try({
  now <- Sys.time()
  c <- aemo_constraints(start = now - 3600, end = now)
  head(c)
})
#> ℹ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> ✔ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> 
#> ℹ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> ✔ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> 
#> ℹ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> ✔ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> 
#> ℹ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> ✔ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> 
#> ℹ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> ✔ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> 
#> ℹ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> ✔ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> 
#> ℹ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> ✔ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> 
#> ℹ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> ✔ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> 
#> ℹ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> ✔ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> 
#> ℹ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> ✔ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> 
#> ℹ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> ✔ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> 
#> ℹ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> ✔ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> 
#> ℹ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> ✔ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> 
#> ℹ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> ✔ Downloading <http://nemweb.com.au/Reports/Current/DispatchIS_Reports/PUBLIC_D…
#> 
#> # aemo_tbl: AEMO dispatch constraints (shadow prices)
#> # Source:   http://nemweb.com.au
#> # Licence:  AEMO Copyright Permissions Notice
#> # Retrieved: 2026-05-04 19:18 UTC 
#> # Rows: 6  Cols: 13
#> 
#>        settlementdate runno      constraintid dispatchinterval intervention
#> 1 2026-05-05 04:20:00     1  F_MAIN+APD_TL_L5      20260505004            0
#> 2 2026-05-05 04:20:00     1  F_MAIN+APD_TL_L6      20260505004            0
#> 3 2026-05-05 04:20:00     1 F_MAIN+APD_TL_L60      20260505004            0
#> 4 2026-05-05 04:20:00     1  F_MAIN+BIP_ML_L1      20260505004            0
#> 5 2026-05-05 04:20:00     1  F_MAIN+LREG_0210      20260505004            0
#> 6 2026-05-05 04:20:00     1  F_MAIN+NIL_MG_R1      20260505004            0
#>         rhs marginalvalue violationdegree         lastchanged duid
#> 1 520.72117          0.01               0 2026/05/05 04:15:07 <NA>
#> 2 373.50726          0.01               0 2026/05/05 04:15:07 <NA>
#> 3 460.10368          0.01               0 2026/05/05 04:15:07 <NA>
#> 4 102.78112          0.01               0 2026/05/05 04:15:07 <NA>
#> 5  210.0001          0.99               0 2026/05/05 04:15:07 <NA>
#> 6 496.42832          0.03               0 2026/05/05 04:15:07 <NA>
#>   genconid_effectivedate genconid_versionno       lhs
#> 1             2024-07-11                  1 520.72117
#> 2             2024-07-11                  1 373.50726
#> 3             2024-07-11                  1 460.10368
#> 4             2024-09-09                  1 102.78112
#> 5             2019-05-16                  1  210.0001
#> 6             2025-02-17                  1 496.42832
options(op)
# }