Skip to content

Commit d3a3b25

Browse files
lvanfrettilvanfretti
committed
Package documentation and reference update
1 parent a6c7b7c commit d3a3b25

4 files changed

Lines changed: 36 additions & 20 deletions

File tree

‎Example1/References/package.mo‎

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,18 @@ package References "Reference papers."
33
extends Modelica.Icons.References;
44
annotation(preferredView="info", Documentation(info="<html>
55
<p>The models within this Modelica package were developed for the paper:</p>
6-
<p>[1] L. Vanfretti and C.R. Laughman, &ldquo;Power System Modeling for Identification and Control Applications using Modelica and OpenIPSL,&rdquo; Invited Paper, submitted to the 2024 8th IEEE Conference on Control Technology and Applications (CCTA), Newcastle upon Tyne, UK, August 21-23, 2024, pre-print available at: <a href=\"http://dx.doi.org/10.13140/RG.2.2.17471.11680\">http://dx.doi.org/10.13140/RG.2.2.17471.11680</a></p>
7-
<p>The models are an updated and improved version of those presented in the following paper:</p>
8-
<p>[2] Xavier Bombois, Luigi Vanfretti, &ldquo;Performance monitoring and redesign of power system stabilizers based on system identification techniques,&rdquo; Sustainable Energy, Grids and Networks, Volume 38, 2024, 101278, ISSN 2352-4677, <a href=\"https://doi.org/10.1016/j.segan.2024.101278\">https://doi.org/10.1016/j.segan.2024.101278</a> . Author&rsquo;s Copy: <a href=\"https://hal.science/hal-04338856\">https://hal.science/hal-04338856</a></p>
9-
<p>The models were originally developed using similar component models and parameters as the single-machine infinite bus model used in the Example 13.2 in [3], pp. 864-869, implemented using the OpenIPSL library.</p>
10-
<p>[3] P. Kundur, Power System Stability and Control, McGraw-Hill Education, 1994.</p>
11-
<p>Please refer to these publications for more information.</p>
12-
<p><i>If you use these models, please cite papers [1-2] listed above.</i></p>
6+
7+
<p>[1] L. Vanfretti and C.R. Laughman, &ldquo;Power System Modeling for Identification and Control Applications using Modelica and OpenIPSL,&rdquo; 2024 IEEE Conference on Control Technology and Applications (CCTA), Newcastle upon Tyne, United Kingdom, 2024, pp. 525-532, doi: 10.1109/CCTA60707.2024.10666594. Publisher's website: <a href=\"https://ieeexplore.ieee.org/document/10666594\">https://ieeexplore.ieee.org/document/10666594</a></p>
8+
9+
<p><br>The models are an updated and improved version of those presented in the paper:</p>
10+
<p>[2] L. Vanfretti and X. Bombois, &quot;Power System Oscillation Monitoring and Damping Control Re-Design under Ambient Conditions and Multiple Operating Points,&quot; manuscript submitted to 20th IFAC Symposium on System Identification. Nov. 10, 2023, pre-print of submitted article available at: <a href=\"http://dx.doi.org/10.13140/RG.2.2.22504.28166\">http://dx.doi.org/10.13140/RG.2.2.22504.28166</a></p>
11+
<p>The models in this package have been substantially modified and documented so that they can be reused by third parties. There may exist some differences in the original and the current version due to enhancements and modification that were required to make them more user-friendly.</p>
12+
<p>Finally, observed that the models used in [2] were updated to apply control redesign techniques presented in the following publication [3]. Note that the models and scenarios presented in [2] are more complex model than that used in [3].</p>
13+
<p>[3] Xavier Bombois, Luigi Vanfretti, &ldquo;Performance monitoring and redesign of power system stabilizers based on system identification techniques,&rdquo; Sustainable Energy, Grids and Networks, Volume 38, 2024, 101278, ISSN 2352-4677, <a href=\"https://doi.org/10.1016/j.segan.2024.101278\">https://doi.org/10.1016/j.segan.2024.101278</a> . Author&rsquo;s Copy: <a href=\"https://hal.science/hal-04338856 \">https://hal.science/hal-04338856 &nbsp;</a></p>
14+
<p>The models were first presented in [4] and [5], as compared to these references, they have been substantially modified to meet the needs of the work in [1]-[3].</p>
15+
<p>[4] M. Klein, G. J. Rogers and P. Kundur, &quot;A fundamental study of inter-area oscillations in power systems,&quot; in IEEE Transactions on Power Systems, vol. 6, no. 3, pp. 914-921, Aug. 1991, doi: 10.1109/59.119229</p>
16+
<p>[5] P. Kundur, Power System Stability and Control, McGraw-Hill Education, 1994.</p>
17+
<p>Please refer to the publications above for more information.</p>
18+
<p><i>If you use these models, please cite the papers [1-3] listed above.</i></p>
1319
</html>"));
1420
end References;

‎Example1/package.mo‎

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,18 +10,22 @@ annotation(preferredView = "info",
1010
OpenIPSL(version="3.0.1")),
1111
version="4",
1212
Documentation(info="<html>
13-
<p>This package contains the power system models used in the paper &quot;Power System Modeling for Identification and Control Applications using Modelica and OpenIPSL&quot; by Luigi Vanfretti and Chrisopher R. Laughman, submitted for review to the IEEE CCTA 2024.</p>
14-
<p>The models have the following dependencies:</p>
13+
<p>This package contains the power system models used in the paper &quot;Power System Modeling for Identification and Control Applications using Modelica and OpenIPSL&quot; published in the proceedings of the 2024 IEEE Conference on Control Technology and Applications (CCTA). The paper can be found online in the following websites:</p>
14+
<ul>
15+
<li>Publisher&apos;s Website: <a href=\"https://ieeexplore.ieee.org/document/10666594\">https://ieeexplore.ieee.org/document/10666594</a></li>
16+
<li>Pre-print on ResearchGate: <a href=\"http://dx.doi.org/10.13140/RG.2.2.17471.11680\">http://dx.doi.org/10.13140/RG.2.2.17471.11680</a> </li>
17+
</ul>
18+
<p><br>The models have the following dependencies:</p>
1519
<ul>
1620
<li>Modelica Standard Library v.4.0.0, </li>
17-
<li>Modelica_LinearSystems2 v2.4.0, </li>
21+
<li>Modelica_LinearSystems2 v3.0.0, </li>
1822
<li>DataFiles v1.1.0, </li>
1923
<li>DymolaCommands v1.16, </li>
2024
<li>LinearAnalysis v1.0.1, </li>
2125
<li>OpenIPSL v.3.0.1</li>
2226
</ul>
23-
<p><br>The models were developed and tested with Dymola 2024X under MS Windows 11.</p>
24-
<p><br>(c) 2024, Luigi Vanfretti, Rensselaer Polytechnic Institute, Troy, NY, USA and Chrisopher R. Laughman, Mitsubishi Electric Research Labs., Cambridge, MA, USA.</p>
27+
<p><br>The models were developed using Dymola and tested with version 2025X Refresh 1 under MS Windows 11.</p>
28+
<p><br>(c) 2024-2025, Luigi Vanfretti, Rensselaer Polytechnic Institute, Troy, NY, USA and Chrisopher R. Laughman, Mitsubishi Electric Research Labs., Cambridge, MA, USA.</p>
2529
</html>"),
2630
Icon(graphics={
2731
Rectangle(

‎Example2/References/package.mo‎

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,14 @@ package References "Reference papers."
33
extends Modelica.Icons.References;
44
annotation(preferredView="info", Documentation(info="<html>
55
<p>The models within this Modelica package were developed for the paper:</p>
6-
<p>[1] L. Vanfretti and C.R. Laughman, &ldquo;Power System Modeling for Identification and Control Applications using Modelica and OpenIPSL,&rdquo; Invited Paper, submitted to the 2024 8th IEEE Conference on Control Technology and Applications (CCTA), Newcastle upon Tyne, UK, August 21-23, 2024, pre-print available at: <a href=\"http://dx.doi.org/10.13140/RG.2.2.17471.11680\">http://dx.doi.org/10.13140/RG.2.2.17471.11680</a></p>
7-
<p>The models are an updated and improved version of those presented in the paper:</p>
6+
7+
<p>[1] L. Vanfretti and C.R. Laughman, &ldquo;Power System Modeling for Identification and Control Applications using Modelica and OpenIPSL,&rdquo; 2024 IEEE Conference on Control Technology and Applications (CCTA), Newcastle upon Tyne, United Kingdom, 2024, pp. 525-532, doi: 10.1109/CCTA60707.2024.10666594. Publisher's website: <a href=\"https://ieeexplore.ieee.org/document/10666594\">https://ieeexplore.ieee.org/document/10666594</a></p>
8+
9+
<p><br>The models are an updated and improved version of those presented in the paper:</p>
810
<p>[2] L. Vanfretti and X. Bombois, &quot;Power System Oscillation Monitoring and Damping Control Re-Design under Ambient Conditions and Multiple Operating Points,&quot; manuscript submitted to 20th IFAC Symposium on System Identification. Nov. 10, 2023, pre-print of submitted article available at: <a href=\"http://dx.doi.org/10.13140/RG.2.2.22504.28166\">http://dx.doi.org/10.13140/RG.2.2.22504.28166</a></p>
911
<p>The models in this package have been substantially modified and documented so that they can be reused by third parties. There may exist some differences in the original and the current version due to enhancements and modification that were required to make them more user-friendly.</p>
1012
<p>Finally, observed that the models used in [2] were updated to apply control redesign techniques presented in the following publication [3]. Note that the models and scenarios presented in [2] are more complex model than that used in [3].</p>
11-
<p>[3] Xavier Bombois, Luigi Vanfretti, &ldquo;Performance monitoring and redesign of power system stabilizers based on system identification techniques,&rdquo; Sustainable Energy, Grids and Networks, Volume 38, 2024, 101278, ISSN 2352-4677, <a href=\"https://doi.org/10.1016/j.segan.2024.101278\">https://doi.org/10.1016/j.segan.2024.101278</a> . Author&rsquo;s Copy: <a href=\"https://hal.science/hal-04338856  \">https://hal.science/hal-04338856 &nbsp;</a></p>
13+
<p>[3] Xavier Bombois, Luigi Vanfretti, &ldquo;Performance monitoring and redesign of power system stabilizers based on system identification techniques,&rdquo; Sustainable Energy, Grids and Networks, Volume 38, 2024, 101278, ISSN 2352-4677, <a href=\"https://doi.org/10.1016/j.segan.2024.101278\">https://doi.org/10.1016/j.segan.2024.101278</a> . Author&rsquo;s Copy: <a href=\"https://hal.science/hal-04338856 \">https://hal.science/hal-04338856 &nbsp;</a></p>
1214
<p>The models were first presented in [4] and [5], as compared to these references, they have been substantially modified to meet the needs of the work in [1]-[3].</p>
1315
<p>[4] M. Klein, G. J. Rogers and P. Kundur, &quot;A fundamental study of inter-area oscillations in power systems,&quot; in IEEE Transactions on Power Systems, vol. 6, no. 3, pp. 914-921, Aug. 1991, doi: 10.1109/59.119229</p>
1416
<p>[5] P. Kundur, Power System Stability and Control, McGraw-Hill Education, 1994.</p>

‎Example2/package.mo‎

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -83,17 +83,21 @@ annotation (uses(
8383
origin={-8,17.9},
8484
rotation=90)}),
8585
Documentation(info="<html>
86-
<p>This package contains the power system models used in the paper &quot;Power System Modeling for Identification and Control Applications using Modelica and OpenIPSL&quot; by Luigi Vanfretti and Chrisopher R. Laughman, submitted for review to the IEEE CCTA 2024.</p>
87-
<p>The models have the following dependencies:</p>
86+
<p>This package contains the power system models used in the paper &quot;Power System Modeling for Identification and Control Applications using Modelica and OpenIPSL&quot; published in the proceedings of the 2024 IEEE Conference on Control Technology and Applications (CCTA). The paper can be found online in the following websites:</p>
87+
<ul>
88+
<li>Publisher&apos;s Website: <a href=\"https://ieeexplore.ieee.org/document/10666594\">https://ieeexplore.ieee.org/document/10666594</a></li>
89+
<li>Pre-print on ResearchGate: <a href=\"http://dx.doi.org/10.13140/RG.2.2.17471.11680\">http://dx.doi.org/10.13140/RG.2.2.17471.11680</a> </li>
90+
</ul>
91+
<p><br>The models have the following dependencies:</p>
8892
<ul>
8993
<li>Modelica Standard Library v.4.0.0, </li>
90-
<li>Modelica_LinearSystems2 v2.4.0, </li>
94+
<li>Modelica_LinearSystems2 v3.0.0, </li>
9195
<li>DataFiles v1.1.0, </li>
9296
<li>DymolaCommands v1.16, </li>
9397
<li>LinearAnalysis v1.0.1, </li>
9498
<li>OpenIPSL v.3.0.1</li>
9599
</ul>
96-
<p><br>The models were developed and tested with Dymola 2024X under MS Windows 11.</p>
97-
<p><br>(c) 2024, Luigi Vanfretti, Rensselaer Polytechnic Institute, Troy, NY, USA and Chrisopher R. Laughman, Mitsubishi Electric Research Labs., Cambridge, MA, USA.</p>
100+
<p><br>The models were developed using Dymola and tested with version 2025X Refresh 1 under MS Windows 11.</p>
101+
<p><br>(c) 2024-2025, Luigi Vanfretti, Rensselaer Polytechnic Institute, Troy, NY, USA and Chrisopher R. Laughman, Mitsubishi Electric Research Labs., Cambridge, MA, USA.</p>
98102
</html>"),preferredView="info");
99103
end Example2;

0 commit comments

Comments
 (0)