-
Notifications
You must be signed in to change notification settings - Fork 8
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #134 from Energinet-AIG/matbkri-patch-1
Update README.md
- Loading branch information
Showing
1 changed file
with
29 additions
and
30 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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] |