Skip to content

Commit

Permalink
Merge pull request #134 from Energinet-AIG/matbkri-patch-1
Browse files Browse the repository at this point in the history
Update README.md
  • Loading branch information
matbkri authored Sep 5, 2024
2 parents 15da581 + a499607 commit c285139
Showing 1 changed file with 29 additions and 30 deletions.
59 changes: 29 additions & 30 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,44 +1,43 @@
# MTB
Connecting new electricity generation & demand facilities to the public transmission and distribution systems in Denmark requires grid compliance studies with both RMS/PDT and EMT plant level models. The danish TSO Energinet requires RMS/PDT models in [DIgSILENT Powerfactory](https://www.digsilent.de/en/powerfactory.html) and EMT models in [PSCAD](https://www.pscad.com/).

Energinets MTB (**M**odel **T**est **B**ench) is a tool for automation of studycase setup and simulation in both PowerFactory and PSCAD with external visualizing of results. The MTB is meant as a tool to help guide in checking simulation and plant performance of RMS/PDT- and EMT-models in regards to the danish grid code and the requirements for simulation models. A set of predefined cases are available with the option to add custom cases or remove exisiting ones.
The MTB, originally an internal Energinet tool, has been open-sourced as an strategic initiative to support the grid connecting parties.
# MTB (Model Test Bench)

Latest release notes can be found under [Releases](https://github.com/Energinet-AIG/MTB/releases).

Read more about the regulations for grid connection of new facilities here: [danish](https://energinet.dk/regler/el/nettilslutning) or [english](https://en.energinet.dk/electricity/rules-and-regulations/regulations-for-new-facilities).
Connecting new electricity generation and demand facilities to Denmark's public transmission and distribution systems requires thorough grid compliance studies using both RMS/PDT and EMT plant-level models. The Danish TSO, Energinet, mandates that RMS/PDT models be created in [DIgSILENT PowerFactory](https://www.digsilent.de/en/powerfactory.html) and EMT models in [PSCAD](https://www.pscad.com/). Before any facility can begin operation, all electrically significant plants must have their RMS and EMT models reviewed and approved by Energinet to ensure both grid compliance and model quality. Conducting the necessary studies to demonstrate compliance and validate model quality through comparisons of RMS and EMT models can be both time-consuming and prone to error.

The MTB (Model Test Bench) simplifies and automates this process by enabling seamless grid connection studies across PowerFactory and PSCAD environments. Energinet relies on the MTB for all grid connection studies and strongly recommends its use to all connecting parties. By using the MTB, developers can conduct studies under the exact same conditions as Energinet, ensuring they achieve the same results that Energinet will evaluate.

The workflow is simple:

1. **Define the Required Studies** in the provided Excel sheet. The MTB is preconfigured for the studies required in most grid connection cases in Denmark but is also adaptable to all regions following the EU RfG. Modifying or extending the study case set is straightforward.
2. **Integrate the PSCAD MTB Component** into the plant's PSCAD model.
3. **Integrate the PowerFactory MTB Component** into the plant's PowerFactory model.
4. **Execute Simulations** using the MTB Python scripts.
5. **Visualize the Results** with the included plotter tool. The example below shows a

For the latest release notes, please visit the [Releases page](https://github.com/Energinet-AIG/MTB/releases). Learn more about the regulations for grid connection of new facilities in Denmark: [Danish](https://energinet.dk/regler/el/nettilslutning) or [English](https://en.energinet.dk/electricity/rules-and-regulations/regulations-for-new-facilities).

![96](https://github.com/user-attachments/assets/6ce6746c-83b6-4d3f-a433-71c7ce5409de)
*Example comparative study between RMS (red) and EMT (blue) models.*
## Getting Started
To get started, follow the Quickstart Guides on the MTB wiki [Home](https://github.com/Energinet-IG/MTB/wiki) page of the [MTB GitHub](https://github.com/Energinet-AIG/MTB). Here you will find guides for the Casesheet, PowerFactory, PSCAD and the plotter.

To start using the MTB, refer to the Quickstart Guides available on the [MTB wiki Home page](https://github.com/Energinet-IG/MTB/wiki) on GitHub. These guides provide instructions on using the Casesheet, PowerFactory, PSCAD, and the plotter tool.

## Requirements
Dependencies are installed by running `pip install -r requirements.txt`.

### Tested environments
To install all necessary dependencies, run:

```bash
pip install -r requirements.txt
```

### Tested Environments

The Powerfactory tool has been tested in the following environments and dependency versions as listed in requirements.txt:
* 2024 SP4 with Python version >= 3.8.8
- **PowerFactory**: Tested on version 2024 SP4 with Python versions >= 3.8.8.
- **PSCAD**: Tested on version 5.0.1.0 with Python 3.7.2 (embedded Python). Compatibility is guaranteed only with Intel Fortran Compilers.

### Tested PSCAD environments
The PSCAD tool has been tested with in following environments and dependency versions as listed in requirements.txt:
* 5.0.2.0 with Python 3.7.2 (embedded python)
## Contributing

#### Tested Fortran Compilers
Intel(R) Visual Fortran Compiler XE:
* 12.1.7.371
* 15.0.1.148
* 15.0.1.148 (64-bit)
* 15.0.5.280
* 15.0.5.280 (64-bit)

## Contribution
If you are interested in contributing, please feel free to file an issue. This is done by using the MTB [Issues](https://github.com/Energinet-AIG/MTB/issues) tab. Here you can report bugs, feature requests or improvements, but please check for known issues beforehand.
We welcome contributions! To contribute, please file an issue via the MTB [Issues tab](https://github.com/Energinet-AIG/MTB/issues). You can report bugs, request features, or suggest improvements. Before submitting, please check for any known issues.

When you file an issue, please try making it as specific and independent of other issues as possible. Make use of the Labels to hightlight what problem or tool the issue revolves arround. We encourage you to contribute with any bug, improvement or idea you might come across to help make this tool as useful and user-friendly as possible.

## Contact
Inquiries can be directed at
* Senior engineer Mathias Kristensen at [email protected]
* Engineer Casper Lindgaard at [email protected]

For inquiries, please contact the Energinet simulation model team: [email protected]

0 comments on commit c285139

Please sign in to comment.