Add Full-Order Synchronous Machine with PSS and Excitation Model

[gdg1999]

[Feature] Add Full-Order Synchronous Machine with PSS and Excitation Model

Background

This Pull Request introduces a new full-order synchronous machine model, which includes both Power System Stabilizer (PSS) and excitation systems. The modification also lays the foundation for integrating doubly-fed induction generator (DFIG) and High Voltage Direct Current (HVDC) models. These changes are part of an ongoing effort to enhance the simulation capabilities for power system dynamics analysis.

Changes

The following changes have been made in the corresponding directories and files:

1. Class Folder:

   • Added SynchronousMachineFullOrder class file for the new full-order synchronous machine model.
   • Added DoublyFedInductionGenerator class file (incomplete).
   • Added HighVoltageDirectCurrent class file (incomplete).
   • Modified ModelAdvance to reduce simulation step size for improved numerical accuracy.

2. Simulink Folder:

   • Updated SimAddApparatus to include a new test case (case003), which accommodates the newly added synchronous machine model.

3. Toolbox Folder:

   • Modified ApparatusModelCreate to include parameter definitions for the synchronous machine model.
   • Updated BusTypeVIF to incorporate changes for functional analysis related to the new synchronous machine model.
   • Modified RearrangeListApparatus to:
     • Increase the parameter capacity to 25.
     • Add default parameters for the synchronous machine model.

4. Library Folder:

   • Updated corresponding library files to reflect changes in the synchronous machine model and other apparatus.

Testing

The newly added synchronous machine model has been tested in a single-machine infinite-bus system. During the initial testing, the system exhibited oscillations when inductance was introduced to the transmission line. The preliminary analysis suggests that the oscillations may be caused by the series inductance. Further investigation is needed to determine the exact cause and resolve the issue. Additional testing will be conducted in a larger power grid setup.

Next Steps

• Complete the development and integration of the DoublyFedInductionGenerator and HighVoltageDirectCurrent models.
• Further refine the synchronous machine model to ensure stable performance under various network conditions.
• Test the synchronous machine and DFIG models in a comprehensive power grid scenario.

Impact

The changes mainly impact the apparatus modeling and parameter management functions. The integration of a full-order synchronous machine enhances the modeling accuracy for generator dynamics, which is crucial for transient stability and small-signal stability analysis.

These updates will not affect the existing functionalities for other apparatus models.

[CuttySark1869]

Hi Duange, would you remove the rubbish files and folders first and then add them to git ignore? All .slxc and .autosave files, and all slprj folders.

[yt-li]

Hi Duange,

1. Could you please make the 4-bus case as the default case in "UserMain.m" everytime before merge? The new users would be very confused if the default case has been changed.

2. As mentioned by Yunjie, the slprj folders, .slxc, and .autosave files are still there. You can check "File Changed" by using GitHub. These things must be deleted before merge.

3. I suggested you to run "UserMain.m" every time before merge. Try to test the tool as a fully-new user. Double check if any of old functions have been "polluted".

[yt-li]

BTW, please make sure that all files appear in the right file folder. For example, "IEEE_14Bus.json".

[yt-li]

Somthing wrong with the simulink files in Library folder, please double check.