Do you have an example of a dynamic model based on the Functional Mock-up Interface (FMI) ?

Category:
Dynamic Simulation
Answer

Please refer to the attached files, containing an EMT-Simulation example of a three-phase three-level neutral point clamped (3L-NPC) converter. The converter controller is available in Matlab Simulink ( refer to https://de.mathworks.com/help/physmod/sps/ug/ac-dc-three-level-pwm-converter.html ), and has been exported into a Functional Mock-up Unit (FMU) using the Matlab built-in export functionality as a standalone FMU ( refer to https://mathworks.com/help/slcompiler/ug/simulinkfmuexample.html ). The FMU has been imported afterwards into PowerFactory and used as the converter controller.

A short introduction how to import an FMU model into PowerFactory can also be found on our YouTube channel: Import of FMU simulation model into PowerFactory.

 

Further information on the FMI import functionality is provided in the PowerFactory User Manual, Section Functional Mock-Up Interface of chapter Models for Dynamic Simulations.

 

Instructions to operate with the example project:

- Unzip the attached archive in a folder of your choice 'NNNNN'.

- Explore the contents of the unzipped folder and import the PowerFactory project "Three phase 3L-NPC-VSC-R06-V06.pfd"

- Activate the project and study case "SC01 Converter blocked".

- Edit and update the ElmFile objects "SC01_MATLAB.ElmFile" and "SC02_MATLAB.ElmFile" with the correct file path pointing to the corresponding text files within folder 'NNNNN'. The objects should be located within the project folder \Network Model\Network Data\Grid.

- Edit and update the TypMdl object "FMU.TypMdl" with the correct file path pointing to the corresponding FMU file within folder 'NNNNN'. The object should be located within the project folder \Library\User Defined Models\FMU Controls.

- Run an EMT simulation and observe the results. This case reproduces the behaviour of the converter unit upon energisation while the IGBTs are permanently blocked (no controls, DC link charging behaviour).

- To compare with the reference results obtained in the external tool: open the Calculation of Initial Conditions command dialog and change the Results object (down pointing arrow next to Result variables) from "Results_FMU" to "Results_Matlab". Execute the command and then run again the simulation. The reference results should be shown overlayed in the plots.

- Activate the project and study case "SC02 Converter start-up FMI".

- Run an EMT simulation and observe the results. This case reproduces the behaviour of the converter unit upon energisation while the converter controls are active and based on the imported FMI model (with FMI controls, converter energisation and operation).

- To compare with the reference results obtained in the external tool: open the Calculation of Initial Conditions command dialog and change the Results object (down pointing arrow next to Result variables) from "Results_FMU" to "Results_Matlab". Execute the command and then run again the simulation. The reference results should be shown overlayed in the plots.

- Activate the project and study case "SC02 Converter start-up FMI".

- Run an EMT simulation and observe the results. This case reproduces the behaviour of the converter unit upon energisation while the converter controls are active and based on the imported FMI model (with FMI controls, converter energisation and operation).

- To compare with the reference results obtained in the external tool: open the Calculation of Initial Conditions command dialog and change the Results object (down pointing arrow next to Result variables) from "Results_FMU" to "Results_Matlab". Execute the command and then run again the simulation. The reference results should be shown overlayed in the plots.

- Activate the project and study case "SC03 Converter start-up DSL".

- Run an EMT simulation and observe the results. This case reproduces the behaviour of the converter unit upon energisation while the converter controls are active and based on a non-identical replica of the reference Simulink control model (with DSL controls, converter energisation and operation).

 

Back