Skip to content

GENERICEQUATIONRHS

GENERICEQUATIONRHS stores the formulation of commonly used Generic Constraint Right Hand Side Equations referenced from Generic Constraint Right Hand Side definitions stored in GENERICCONSTRAINTRHS. The Generic Equation definitions are versioned and the latest effective version is applied to the dispatch process.

GENERICEQUATIONRHS data is public to all participants.

Source

GENERICEQUATIONRHS updates whenever a generic equation is created or modified.

Volume

Approximately 1,000 records per year

Note

GENERICEQUATIONRHS and GENERICEQUATIONDESC allow commonly used constraint right hand side formulations to be defined as a generic equation. Once defined, the generic equation can be referenced from any Generic constraint RHS formulation defined in GENERICCONSTRAINTRHS.

To reference a generic equation from a generic constraint RHS definition, specify a SPD_TYPE of ‘X’ and the SPD_ID equivalent to the EQUATIONID field in GENERICEQUATIONRHS.

Column Schema

EFFECTIVEDATE

Effective date of this record

SQL Type: DATE Polars Type: pl.Date()

This column is mandatory, and a primary key.

Example: 2026/09/01 00:00:00

Note that AEMO represents dates as datetimes with a midnight time component.

EQUATIONID

Generic Equation Identifier

SQL Type: VARCHAR2(20) Polars Type: str

This column is mandatory, and a primary key.

Examples:

  • X-7C2K350N_DS
  • X-7C2K350N_PD
  • X-7C2K350N_ST
  • X-7C2K350_DS
  • X-7C2K350_PD
  • X-7C2K350_ST
  • X-7C2KH350_DS
  • X-7C2KH350_PD
  • X-7C2KH350_ST
  • X-7CH50(2G)_DS

TERMID

The unique identifier for the a equation RHS term

SQL Type: NUMBER(3,0) Polars Type: pl.Int16

This column is mandatory, and a primary key.

Examples: 1, 136

VERSIONNO

Version no of this record for the effective date

SQL Type: NUMBER(3,0) Polars Type: pl.UInt16

This column is mandatory, and a primary key.

Example: 1

DEFAULTVALUE

Default value if primary source given by SPD_ID and SPD_TYPE not available.

SQL Type: NUMBER(16,6) Polars Type: pl.Float64

This column is not mandatory.

Examples: 0, -1, 1, 600

FACTOR

Multiplier applied to operator result

SQL Type: NUMBER(16,6) Polars Type: pl.Float64

This column is not mandatory.

Examples: 0.01, 0, -1, -370

GROUPID

ID of super-term, if this is a sub-term

SQL Type: NUMBER(3,0) Polars Type: pl.Int16

This column is not mandatory.

Examples: 1, 109

LASTCHANGED

Last date and time record changed

For more information, see the dedicated documentation page.

SQL Type: DATE Polars Type: pl.Datetime()

This column is not mandatory.

Example: 2026/09/01 14:56:19

OPERATION

Unitary operator to apply to data value

SQL Type: VARCHAR2(10) Polars Type: str

This column is not mandatory.

Examples:

  • MAX
  • MUL
  • PUSH
  • STEP

PARAMETERTERM1

The unique identifier for the first term (logic expression) to use in a Branch term

SQL Type: VARCHAR2(12) Polars Type: str

This column is not mandatory.

PARAMETERTERM2

The unique identifier for the second term (logic<=0 result) to use in a Branch term

SQL Type: VARCHAR2(12) Polars Type: str

This column is not mandatory.

PARAMETERTERM3

The unique identifier for the third term (logic>0 result) to use in a Branch term

SQL Type: VARCHAR2(12) Polars Type: str

This column is not mandatory.

SPD_ID

ID defining data source

SQL Type: VARCHAR2(21) Polars Type: str

This column is not mandatory.

Examples:

  • 250H
  • 250_TV
  • 350H
  • 350_TV
  • 50_H_TV
  • 7C
  • CALL+GLAD_>=2
  • CALL_B1_ONSTATUS
  • CALL_B2_ONSTATUS
  • CALL_B_1.QCAB1

SPD_TYPE

ID describing type of data source

SQL Type: VARCHAR2(1) Polars Type: pl.Categorical

This column is not mandatory.

Examples:

  • A
  • C
  • E
  • G
  • S
  • T
  • U

New Data Timing

When a generic equation is created or modified

Code Examples

Polars

Casting is enums, categoricals etc is not essential, but may speed up parsing. Swapping int for pl.UInt16, pl.Int32 would also speed up parsing. However some of the datatypes are inferred, so they may be wrong.

This code deduplicates for you. Deduplication is normally only required across multiple months.

This code assumes that all columns are present, which may not be true for older files.

import polars as pl
import polars.selectors as cs

# e.g. "2029/03/15 00:05:00"
dt_s_fmt = "%Y/%m/%d %H:%M:%S"

# Dates are represented as datetimes at midnight

d_fmt = "%Y/%m/%d 00:00:00"

csv_paths = ["SOMEFILE.CSV", "OTHERFILE.CSV"]

lf = (
    pl.concat(
        [
            pl.scan_csv(
                csv_path,  # must be unzipped beforehand
                skip_rows=1,  # skip the header
                infer_schema=False,  # much faster
            )
            .filter(cs.by_index(0) == "D")  # drop the footer
            .select(~cs.by_index(range(4)))  # drop metadata columns
            for csv_path in csv_paths
        ],
        how="diagonal_relaxed",
    )
    .with_columns(
        pl.col("LASTCHANGED").str.strptime(pl.Datetime, dt_s_fmt),
        pl.col("EFFECTIVEDATE").str.strptime(pl.Date, d_fmt),
    )
    .cast(
        {
            "EFFECTIVEDATE": pl.Date(),
            "EQUATIONID": str,
            "TERMID": int,  # or pl.Int16
            "VERSIONNO": int,  # or pl.UInt16
            "DEFAULTVALUE": pl.Float64,
            "FACTOR": pl.Float64,
            "GROUPID": int,  # or pl.Int16
            "OPERATION": str,
            "PARAMETERTERM1": str,
            "PARAMETERTERM2": str,
            "PARAMETERTERM3": str,
            "SPD_ID": str,
            "SPD_TYPE": pl.Categorical,
        }
    )
    # Deduplicate
    # We want one row per ['EFFECTIVEDATE', 'EQUATIONID', 'TERMID', 'VERSIONNO']
    # Tie-breaker: greatest value of ['LASTCHANGED']
    .sort(["LASTCHANGED"], descending=False)
    .unique(subset=["EFFECTIVEDATE", "EQUATIONID", "TERMID", "VERSIONNO"], keep="last")
)

Nemosis

This table is not yet available in Nemosis.

Example File

From PUBLIC_ARCHIVE_GENERICEQUATIONRHS_FILE01_202609010000.zip

EQUATIONIDEFFECTIVEDATEVERSIONNOTERMIDGROUPIDSPD_IDSPD_TYPEFACTOROPERATIONDEFAULTVALUEPARAMETERTERM1PARAMETERTERM2PARAMETERTERM3LASTCHANGED
X-7C2K350N_DS2026/09/01 00:00:0011STAN_>=2G1STEP02026/09/01 14:56:19
X-7C2K350N_DS2026/09/01 00:00:0017STAN+CALL_>=3G1STEP02026/09/01 14:56:19
X-7C2K350N_DS2026/09/01 00:00:00117CALL+GLAD_>=2G1STEP02026/09/01 14:56:19
X-7C2K350N_DS2026/09/01 00:00:00129STAN+CALL+GLAD_>=7G1STEP02026/09/01 14:56:19
X-7C2K350N_DS2026/09/01 00:00:00145KAREEYA_>=2G1STEP02026/09/01 14:56:19
X-7C2K350N_DS2026/09/01 00:00:00151NQ_LOAD>=350G1STEP02026/09/01 14:56:19
X-7C2K350N_DS2026/09/01 00:00:00154NQ_LOAD_A>=370G1STEP02026/09/01 14:56:19
X-7C2K350N_DS2026/09/01 00:00:00157ROSS+FN_LOAD>=150G1STEP02026/09/01 14:56:19
X-7C2K350N_DS2026/09/01 00:00:00160ROSS+FN_LOAD_A>=170G1STEP02026/09/01 14:56:19
X-7C2K350N_DS2026/09/01 00:00:00163SOLAR_OFFG1STEP02026/09/01 14:56:19
X-7C2K350N_DS2026/09/01 00:00:00173CHECK_CONSTANTC-902026/09/01 14:56:19
...

CSETP.WORLDDVD_GENERICEQUATIONRHSAEMOPUBLIC2026/10/0915:36:58001791524218557MONTHLY_ARCHIVE001791524218557
IGEQRHSNULL1EQUATIONIDEFFECTIVEDATEVERSIONNOTERMIDGROUPIDSPD_IDSPD_TYPEFACTOROPERATIONDEFAULTVALUEPARAMETERTERM1PARAMETERTERM2PARAMETERTERM3LASTCHANGED
DGEQRHSNULL1X-7C2K350N_DS2026/09/01 00:00:0011STAN_>=2G1STEP02026/09/01 14:56:19
DGEQRHSNULL1X-7C2K350N_DS2026/09/01 00:00:0017STAN+CALL_>=3G1STEP02026/09/01 14:56:19
DGEQRHSNULL1X-7C2K350N_DS2026/09/01 00:00:00117CALL+GLAD_>=2G1STEP02026/09/01 14:56:19
DGEQRHSNULL1X-7C2K350N_DS2026/09/01 00:00:00129STAN+CALL+GLAD_>=7G1STEP02026/09/01 14:56:19
DGEQRHSNULL1X-7C2K350N_DS2026/09/01 00:00:00145KAREEYA_>=2G1STEP02026/09/01 14:56:19
DGEQRHSNULL1X-7C2K350N_DS2026/09/01 00:00:00151NQ_LOAD>=350G1STEP02026/09/01 14:56:19
DGEQRHSNULL1X-7C2K350N_DS2026/09/01 00:00:00154NQ_LOAD_A>=370G1STEP02026/09/01 14:56:19
DGEQRHSNULL1X-7C2K350N_DS2026/09/01 00:00:00157ROSS+FN_LOAD>=150G1STEP02026/09/01 14:56:19
DGEQRHSNULL1X-7C2K350N_DS2026/09/01 00:00:00160ROSS+FN_LOAD_A>=170G1STEP02026/09/01 14:56:19
DGEQRHSNULL1X-7C2K350N_DS2026/09/01 00:00:00163SOLAR_OFFG1STEP02026/09/01 14:56:19
DGEQRHSNULL1X-7C2K350N_DS2026/09/01 00:00:00173CHECK_CONSTANTC-902026/09/01 14:56:19
...
CEND OF REPORT1003

EQUATIONID,EFFECTIVEDATE,VERSIONNO,TERMID,GROUPID,SPD_ID,SPD_TYPE,FACTOR,OPERATION,DEFAULTVALUE,PARAMETERTERM1,PARAMETERTERM2,PARAMETERTERM3,LASTCHANGED
X-7C2K350N_DS,"2026/09/01 00:00:00",1,1,,STAN_>=2,G,1,STEP,0,,,,"2026/09/01 14:56:19"
X-7C2K350N_DS,"2026/09/01 00:00:00",1,7,,STAN+CALL_>=3,G,1,STEP,0,,,,"2026/09/01 14:56:19"
X-7C2K350N_DS,"2026/09/01 00:00:00",1,17,,CALL+GLAD_>=2,G,1,STEP,0,,,,"2026/09/01 14:56:19"
X-7C2K350N_DS,"2026/09/01 00:00:00",1,29,,STAN+CALL+GLAD_>=7,G,1,STEP,0,,,,"2026/09/01 14:56:19"
X-7C2K350N_DS,"2026/09/01 00:00:00",1,45,,KAREEYA_>=2,G,1,STEP,0,,,,"2026/09/01 14:56:19"
X-7C2K350N_DS,"2026/09/01 00:00:00",1,51,,NQ_LOAD>=350,G,1,STEP,0,,,,"2026/09/01 14:56:19"
X-7C2K350N_DS,"2026/09/01 00:00:00",1,54,,NQ_LOAD_A>=370,G,1,STEP,0,,,,"2026/09/01 14:56:19"
X-7C2K350N_DS,"2026/09/01 00:00:00",1,57,,ROSS+FN_LOAD>=150,G,1,STEP,0,,,,"2026/09/01 14:56:19"
X-7C2K350N_DS,"2026/09/01 00:00:00",1,60,,ROSS+FN_LOAD_A>=170,G,1,STEP,0,,,,"2026/09/01 14:56:19"
X-7C2K350N_DS,"2026/09/01 00:00:00",1,63,,SOLAR_OFF,G,1,STEP,0,,,,"2026/09/01 14:56:19"
X-7C2K350N_DS,"2026/09/01 00:00:00",1,73,,CHECK_CONSTANT,C,-9,,0,,,,"2026/09/01 14:56:19"
...

C,SETP.WORLD,DVD_GENERICEQUATIONRHS,AEMO,PUBLIC,2026/10/09,15:36:58,001791524218557,MONTHLY_ARCHIVE,001791524218557
I,GEQRHS,NULL,1,EQUATIONID,EFFECTIVEDATE,VERSIONNO,TERMID,GROUPID,SPD_ID,SPD_TYPE,FACTOR,OPERATION,DEFAULTVALUE,PARAMETERTERM1,PARAMETERTERM2,PARAMETERTERM3,LASTCHANGED
D,GEQRHS,NULL,1,X-7C2K350N_DS,"2026/09/01 00:00:00",1,1,,STAN_>=2,G,1,STEP,0,,,,"2026/09/01 14:56:19"
D,GEQRHS,NULL,1,X-7C2K350N_DS,"2026/09/01 00:00:00",1,7,,STAN+CALL_>=3,G,1,STEP,0,,,,"2026/09/01 14:56:19"
D,GEQRHS,NULL,1,X-7C2K350N_DS,"2026/09/01 00:00:00",1,17,,CALL+GLAD_>=2,G,1,STEP,0,,,,"2026/09/01 14:56:19"
D,GEQRHS,NULL,1,X-7C2K350N_DS,"2026/09/01 00:00:00",1,29,,STAN+CALL+GLAD_>=7,G,1,STEP,0,,,,"2026/09/01 14:56:19"
D,GEQRHS,NULL,1,X-7C2K350N_DS,"2026/09/01 00:00:00",1,45,,KAREEYA_>=2,G,1,STEP,0,,,,"2026/09/01 14:56:19"
D,GEQRHS,NULL,1,X-7C2K350N_DS,"2026/09/01 00:00:00",1,51,,NQ_LOAD>=350,G,1,STEP,0,,,,"2026/09/01 14:56:19"
D,GEQRHS,NULL,1,X-7C2K350N_DS,"2026/09/01 00:00:00",1,54,,NQ_LOAD_A>=370,G,1,STEP,0,,,,"2026/09/01 14:56:19"
D,GEQRHS,NULL,1,X-7C2K350N_DS,"2026/09/01 00:00:00",1,57,,ROSS+FN_LOAD>=150,G,1,STEP,0,,,,"2026/09/01 14:56:19"
D,GEQRHS,NULL,1,X-7C2K350N_DS,"2026/09/01 00:00:00",1,60,,ROSS+FN_LOAD_A>=170,G,1,STEP,0,,,,"2026/09/01 14:56:19"
D,GEQRHS,NULL,1,X-7C2K350N_DS,"2026/09/01 00:00:00",1,63,,SOLAR_OFF,G,1,STEP,0,,,,"2026/09/01 14:56:19"
D,GEQRHS,NULL,1,X-7C2K350N_DS,"2026/09/01 00:00:00",1,73,,CHECK_CONSTANT,C,-9,,0,,,,"2026/09/01 14:56:19"
...
C,"END OF REPORT",1003

Availability

Visibility: Public

This table is in the public monthly MMSDM archive.

I have collated the list of all those files into one place, in this CSV metadata file. (Columns year, month, url, compressed_size in bytes).

The earliest available data is month 1 of 2015. The most recent available data is month 9 of 2026.

Warning

There are some months with no files.

Data Size

Each year of data is approximately 271 KB when zipped, 3 MB as unzipped CSV.

Deduplication and PDR Loader Configuration

The primary keys are:

The transaction type is "insert", which means that you will usually not see duplicate data. If you do, you can deduplicate based on the primary keys, without sorting first. Rows from different files with the same primary keys should have the same values.

PDR Loader configuration is:

Report Name Report Subtype Version
GEQRHS NULL 1

This means that the CSV files start with metadata columns:

I,GEQRHS,NULL,1,...
D,GEQRHS,NULL,1,...

Indexes

This page as JSON (schema documented here, but may change)

Download a JSON Schema specification for this table.

Official AEMO schema documentation

Other Information

Package: GENERIC_CONSTRAINT