Skip to main content

A package for downloading and handling forecasts for the National Electricity Market (NEM) from the Australian Energy Market Operator (AEMO).

Project description

nemseer

PyPI version Continuous Integration and Deployment Documentation Status codecov pre-commit.ci status Code style: black DOI

A package for downloading and handling historical National Electricity Market (NEM) forecast data produced by the Australian Energy Market Operator (AEMO).

Installation

pip install nemseer

Many nemseer use-cases require NEMOSIS, which can also be installed using pip:

pip install nemosis

Overview

nemseer allows you to access historical AEMO pre-dispatch and Projected Assessment of System Adequacy (PASA) forecast[^1] data available through the MMSDM Historical Data SQLLoader. nemseer can then compile this data into pandas DataFrames or xarray Datasets.

forecast_overview

Source: Reserve services in the National Electricity Market, AEMC, 2021

Whereas PASA processes are primarily used to assess resource adequacy based on technical inputs and assumptions for resources in the market (i.e. used to answer questions such as "can operational demand be met in the forecast horizon with a sufficient safety (reserve) margin?"), pre-dispatch processes incorporate the latest set of market participant offers and thus produce regional prices forecasts for energy and frequency control ancillary services (FCAS). Overviews of the various pre-dispatch and PASA processes can be found in the glossary.

[^1]: We use the term "forecast" loosely, especially given that these "forecasts" change once participants update offer information (e.g. through rebidding) or submit revised resource availabilities and energy constraints. Both of these are intended outcomes of these "ahead processes", which are run to provide system and market information to participants to inform their decision-making. However, to avoid confusion and to ensure consistency with the language used by AEMO, we use the terms "forecast" (or outputs) and "forecast types" (or ahead processes) in nemseer.

nemseer enables you to download and work with data for the following forecast types. Where available, AEMO process and table descriptions are linked:

  1. 5-minute pre-dispatch (P5MIN: Table descriptions)
  2. Pre-dispatch (PREDISPATCH: Table descriptions)
  3. Pre-dispatch Projected Assessment of System Adequacy (PDPASA: Tables and Descriptions)
  4. Short Term Projected Assessment of System Adequacy (STPASA: Table descriptions)
  5. Medium Term Projected Assessment of System Adequacy (MTPASA: Table descriptions)

Another helpful reference for PASA information is AEMO's Reliability Standard Implementation Guidelines.

ST PASA Replacement Project

Note that the methodologies for PD PASA and ST PASA are being reviewed by AEMO. In particular, the ST PASA Replacement project will combine PD PASA and ST PASA into ST PASA. For more detail, refer to the final determination of the rule change and the AEMO ST PASA Replacement Project home page.

Usage

Glossary

The glossary contains overviews of the PASA and pre-dispatch processes, and descriptions of terminology used in nemseer.

Quick start

Check out the Quick start for guide on to use nemseer.

Examples

Some use case examples have been included in the Examples section of the documentation.

Support

If you are having an issue with this software that has not already been raised in the issues register, please raise a new issue.

Contributing

Interested in contributing? Check out the contributing guidelines, which also includes steps to install nemseer for development.

Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.

Citation

If you use nemseer, please cite the package via the Zenodo DOI.

If you use code or analysis from any of the demand error and/or price convergence examples in the documentation, please also cite NEMOSIS via this conference paper

Licenses

nemseer was created by Abhijith Prakash. It is licensed under the terms of GNU GPL-3.0-or-later licences.

The content within the documentation for this project is licensed under a Creative Commons Attribution 4.0 International License.

Credits

nemseer was created with cookiecutter and the py-pkgs-cookiecutter template.

Development of nemseer was funded by the UNSW Digital Grid Futures Institute.

Contributor Acknowledgements

Thanks to:

  • Nicholas Gorman for reviewing nemseer code
  • Dylan McConnell for assistance in interpreting PASA run types
  • Declan Heim for suggesting improvements to nemseer examples

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nemseer-1.0.7.tar.gz (42.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nemseer-1.0.7-py3-none-any.whl (43.6 kB view details)

Uploaded Python 3

File details

Details for the file nemseer-1.0.7.tar.gz.

File metadata

  • Download URL: nemseer-1.0.7.tar.gz
  • Upload date:
  • Size: 42.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.4.0 CPython/3.9.18 Linux/6.2.0-1016-azure

File hashes

Hashes for nemseer-1.0.7.tar.gz
Algorithm Hash digest
SHA256 4a2fcf5188e34c14609f7a3007fc461e7747d5bf09a8f33823b2d9b5955af095
MD5 8038fea0a1b3b88cc2accd38b8609e58
BLAKE2b-256 2e34392ac3a38f0e6d8152cb710f2b38bdea6159907f6da1ff7340a41eb30b10

See more details on using hashes here.

File details

Details for the file nemseer-1.0.7-py3-none-any.whl.

File metadata

  • Download URL: nemseer-1.0.7-py3-none-any.whl
  • Upload date:
  • Size: 43.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.4.0 CPython/3.9.18 Linux/6.2.0-1016-azure

File hashes

Hashes for nemseer-1.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 6a5780afc728c89fff08dda0ee9fed21776d6d73c385062c21ace7b933c02aa2
MD5 a2b805035b1bd9d2d89c548cb78785af
BLAKE2b-256 6f3214e4da56bcc5a1ddc8b899fc144d162a92e621c73720ab1f0b879034fafa

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page