Skip to contents

Generic constraint equations and RHS terms (GENCONDATA)

Source: R/constraints.R
aemo_gencon.Rd

Downloads the GENCONDATA table from the most recent MMSDM monthly archive. GENCONDATA contains the equation definitions for every generic constraint active in the NEM: the constraint ID, the type (equality/inequality), a description of what the constraint models (thermal limit, voltage stability, system strength, etc.), and the default RHS value.

Usage

aemo_gencon(constraint_id = NULL, type = NULL)

Source

AEMO NEMweb MMSDM archive, GENCONDATA table. AEMO Copyright Permissions Notice.

Arguments

constraint_id

Optional character vector of constraint IDs to filter on. NULL returns all equations.

type

Optional constraint type filter (e.g. "LE" for <=, "GE" for >=, "EQ" for =). NULL returns all types.

Value

An aemo_tbl with columns including genconid (constraint ID), constrainttype, description, genericconstraintrhs (default RHS value). Additional columns from GENCONDATA (effective dates, generic constraint equation weights) will be present when available.

Details

Pair this with aemo_constraints() to go from a binding dispatch interval to the underlying network equation. The workflow is: aemo_constraints() tells you which constraint bound and how hard (marginalvalue = shadow price); aemo_gencon() tells you what the constraint is (which elements and why the RHS was set at that level).

See also

aemo_constraints() for the real-time binding constraint shadow prices.

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

Examples

# \donttest{
op <- options(aemo.cache_dir = tempdir())
try({
  # Find equations for the Heywood interconnector thermal limits
  g <- aemo_gencon(constraint_id = c("V::S_NIL_TBSE", "V::S_NIL_FCSPS"))
  head(g)
})
#> ℹ Downloading <https://nemweb.com.au/Data_Archive/Wholesale_Electricity/MMSDM/2…
#> ✖ Downloading <https://nemweb.com.au/Data_Archive/Wholesale_Electricity/MMSDM/2…
#> 
#> ℹ Downloading <https://nemweb.com.au/Data_Archive/Wholesale_Electricity/MMSDM/2…
#> ✖ Downloading <https://nemweb.com.au/Data_Archive/Wholesale_Electricity/MMSDM/2…
#> 
#> ℹ Downloading <https://nemweb.com.au/Data_Archive/Wholesale_Electricity/MMSDM/2…
#> ✖ Downloading <https://nemweb.com.au/Data_Archive/Wholesale_Electricity/MMSDM/2…
#> 
#> ℹ Downloading <https://nemweb.com.au/Data_Archive/Wholesale_Electricity/MMSDM/2…
#> ✖ Downloading <https://nemweb.com.au/Data_Archive/Wholesale_Electricity/MMSDM/2…
#> 
#> ℹ Downloading <https://nemweb.com.au/Data_Archive/Wholesale_Electricity/MMSDM/2…
#> ✖ Downloading <https://nemweb.com.au/Data_Archive/Wholesale_Electricity/MMSDM/2…
#> 
#> ℹ 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_gencon(constraint_id = c("V::S_NIL_TBSE", "V::S_NIL_FCSPS")) : 
#>   Could not retrieve GENCONDATA from MMSDM.
#> ℹ Check your internet connection or use `aemo_nemweb_download()` with an MMSDM
#>   URL directly.
#> ℹ MMSDM path:
#>   DATA/Archive/Wholesale_Electricity/MMSDM/<YYYY>/<month>/MMSDM_Historical_Data_SQLLoader/DATA/PUBLIC_DVD_GENCONDATA_<YYYYMM>010000.zip
options(op)
# }