Summary
Introduction
This Technical Brochure summarizes work done in a Joint Working Group between CIGRE B4.82 (Guidelines For Use Of Real-Code In EMT Models For HVDC, FACTS and Inverter Based Generators In Power Systems Analysis) and IEEE (Use of Real-Code in EMT Models for Power System Analysis, a working group under the Transient Analysis and Simulation task force). This group has over 100 members from IEEE and CIGRE, including users, simulation tool developers, manufacturers and others.
The objective is to create a standard methodology for interfacing of control and protection models to power system simulation tools, including “realcode” (ie the actual source code used in field hardware) and other generic or user-written models.
Scope and Methodology
This method resolves many common problems with models used in power system simulation tools, such as compatibility (due to compiler versions or with different simulation tools), confidentiality concerns, accuracy and reliability issues.
To resolve these issues, the working group developed a standard format of interfacing controller code to power system simulation programs – this is called the IEEE/CIGRE DLL Modeling Method.
The method is used to develop simulation models, released in MS Windows DLL format (but also in other formats such as .so shared object files for Linux). The model is self-documenting, and contains functions that can be called (by model import tools from simulation program developers) to document the inputs, outputs, parameters, sample time, state variable requirements (and other important aspects of the model).
The CIGRE B4.82 Technical Brochure
The CIGRE B4.82 Technical Brochure is organized into the following chapters:
- Introduction
- General Principle and Benefits – overview and advantages of the method.
- Specification of the IEEE/Cigre DLL Method V1.1 – documents the method routines, data structures and usage cases.
- State Variables – a description of state variables and how they should be handled in models and in this method
- Guidelines for Model Writers – application specific information intended for model writers (which can be manufacturers who have control and protection code already written, or generic model writers etc.).
- Guidelines for End Users –guidelines for the end users of the models, including steps to use the models in their simulation tools.
- Simulation Tool Developer Manual – important factors for power system simulation tool developers to import and create interface tools for use by end users.
- Next Steps and Future Work – a tracked list of ideas/suggestions for consideration in future revisions of the method.
- Conclusion
Conclusions
The deliverables of this working group include:
- The method definition .h header files (defining the format of signals used in the interface and subroutines called, example cases).
- Example source code and wrappers for simple controller models.
- A manual (with chapters targeted at model writers, simulation tool developers, and end users of the model).
The IEEE/CIGRE DLL Modeling Method has been successfully applied to numerous power system simulation tools and has been used by many manufacturers of power system controllers. It is also supported by other HVDC Working Groups (such as InterOpera) and simulation tools (both EMT and RMS/transient stability tools).
The manual is released by IEEE, as well as in a CIGRE Technical Brochure.
Table of content
1. Introduction
2. General Principle and Benefits
3. Specification of the IEEE/CIGRE DLL Method V1.1
3.1. Overview of IEEE/CIGRE interface, .h headers files and .c wrapper code
3.2. IEEE_Cigre_DLLInterface_Model_Info Structure:
3.3. IEEE_Cigre_DLLInterface_Instance Structure:
4. State Variables
4.1. Multiple Instances of a Model
4.2. Snapshot Feature
5. Guidelines for Model Writers
6. Guidelines for End Users
7. Simulation Tool Developer Manual
7.1. Timing/Order of Function Calls
8. Next Steps and Future Work
9. Conclusion
APPENDIX A. Definitions, Abbreviations and Symbols
APPENDIX B. Links and References
APPENDIX C. IEEE/CIGRE DLL Format – Version History
APPENDIX D. IEEE_Cigre_DLLInterface.h Header Files
APPENDIX E. Example Model Source Code (Synchronous Machine Exciter SCRX)
Additional informations
| Publication type | Technical Brochures |
|---|---|
| Reference | 958 |
| Publication year | |
| Publisher | CIGRE |
| ISBN | 978-2-85873-663-8 |
| Study committees | |
| Working groups | JWG B4.82/IEEE |
| File size | 2 MB |
| Pages number | 44 |
| Price for non member | 90 € |
| Price for member | Free |
Authors
Garth IRWIN, Convenor (CA), Deepak RAMASUBRAMANIAN, Secretary (US)
Emmanuel AMANKWAH (GB), Geoff LOVE (IE), Erik BJORKLUND (SE), Ignacio PÉREZ SANTOS (ES), Sébastien DENNETIÈRE (FR), Dejan POTKRAJAC (DE), Goran DROBNJAK (DE), Nitish SHARMA (US), Mohamed EL-CHEHALY (CA), Adam SPARACINO (US), Ricard FERRER-SAN-JOSÉ (ES), Hiranya SURIYAARACHCHI (CA), Durga Naga GADDAM (US), Luigi VANFRETTI (US), Robin GUPTA (GB), Xiaoyu WANG (US), Laurent CHEDOT (FR), Zhang XING (CN), Pang LEI (CN), Yi ZHANG (CA), Wei LI (CA), Shreyas ZINGRE (US)
Corresponding Members
Ram ADAPA (US), Staffan NORRGA (SE), Borja BARRASA GORDO (ES), Pouyan POURBEIK (US), Jose Alfredo CAMPOS GARCIA (DE), Roosa-Maria SALLINEN (FI), Nathan CROOK (AU), Mohammad SUWAN (DE), Cesar MARTIN (FR)
Keywords
IEEE_CIGRE_DLLInterface, IEEE/CIGRE DLL Interface, EMT models for HVDC, FACTS and IBR, Wrapper Code, Interface Code, Model Writer, Simulation Tool Developers, End Users, DLL import, Electro-Magnetic Transients (EMP), Transient Stability (TS)