elexon-data / insights-issues

This repository serves as a centralised location for tracking and managing issues reported on the Insights Solution.
MIT License
4 stars 0 forks source link

Indicated Imbalance(IMBALNGC) definition change in API documentation #7

Closed trader-short closed 1 year ago

trader-short commented 1 year ago

Describe the issue

Indicated Imbalance for a settlement period is defined as the difference between Indicated Generation(INDGEN) and National Demand Forecast(NDF) in the Insights API documentation. But the values returned are not consistent with this definition. Say for settlement period 16 today(25-05-2023), the Indicated Imbalance value returned is 812MW. INDGEN and NDF values for SP16 are 27571MW and 25428MW respectively, thus difference and apparently Indicated Imbalance will be 2143MW. The 812MW value returned matches the difference between INDGEN(27571MW) and TSDF(26759MW), which also how Indicated Imbalance is defined in the Grid Code (BC1.A.2.2). I've attached the required screenshots.

Steps to Reproduce

Steps to reproduce the behavior:

  1. Go to https://data.elexon.co.uk/bmrs/api/v1/datasets/IMBALNGC/stream?boundary=N and check for the Indicated Imbalance for any recent SP(812MW for SP16 at that time)
  2. Get INDGEN, NDF, and TSDF values for the same settlement period using the Insights API, or just check the BMRS day-ahead demand page for all the values.
  3. Take the difference between INDGEN - NDF(27571 - 25428)
  4. It doesn't match the value returned for Indicated Imbalance(812MW)

Expected behaviour

If the definition in the Insights API documentation is corrected, Indicated Imbalance value returned should be 2143MW for SP16

Observed behaviour

Actual value returned for IMBALNGC (812MW) is difference between INDGEN and TSDF

Screenshots

GRID_CODE_DEFINITION

bmrs_demand_page

IMBALNGC_SP16

Checks

Please answer the following questions for yourself before submitting an issue.

zghanty commented 1 year ago

Thanks @trader-short - We have lifted the definition from our glossary https://www.bmreports.com/bmrs/?q=help/glossary

image

We will reproduce this and amend the definition as required.

Thanks for highlighting this to us

jackiewoodburn-sw commented 1 year ago

Hi @trader-short - thanks for flagging this! We've updated the documentation to reflect the amended definition.

trader-short commented 1 year ago

Thank you @jackiewoodburn-sw. The definition has been updated on the /datasets/IMBALNGC but on the /datasets/IMBALNGC/stream endpoint, the change is not revised yet. I've attached screenshots for both endpoints below

Capture2

Instead of National Demand Forecast, it should be Transmission System Demand Forecast

Capture1