build based on d5a8630

NREL-Sienna · Apr 9, 2024 · 4c965b3 · 4c965b3
1 parent f1be646
commit 4c965b3
Show file tree

Hide file tree

Showing 14 changed files with 121 additions and 132 deletions.
diff --git a/dev/api/internal/index.html b/dev/api/internal/index.html
diff --git a/dev/api/public/index.html b/dev/api/public/index.html
diff --git a/dev/component_models/loads/index.html b/dev/component_models/loads/index.html
@@ -61,15 +61,4 @@
 \end{align*}\]</p><p>Finally, the withdrawed current from the bus is:</p><p class="math-container">\[\begin{align*}
 I_r = \left(\frac{S_\text{motor}}{S_\text{base}}\right) (i_{ds} - v_{qs} B_{sh}) \\
 I_i = \left(\frac{S_\text{motor}}{S_\text{base}}\right) (i_{qs} + v_{ds} B_{sh}) 
-\end{align*}\]</p><h3 id="Active-Constant-Power-Load-Model"><a class="docs-heading-anchor" href="#Active-Constant-Power-Load-Model">Active Constant Power Load Model</a><a id="Active-Constant-Power-Load-Model-1"></a><a class="docs-heading-anchor-permalink" href="#Active-Constant-Power-Load-Model" title="Permalink"></a></h3><p>The following 12-state model Active Load model  that measures the AC side using a Phase-Lock-Loop (PLL) and regulates a DC voltage to supply a resistor <span>$r_L$</span>. This model induces a constant power load-like behavior as it tries to maintain a fixed DC voltage to supply <span>$P = v_\text{DC}^2 / r_L$</span>. The model is based on <a href="https://www.sciencedirect.com/science/article/pii/S0142061516000740">the following reference</a>. </p><p>The complete model is given by:</p><p class="math-container">\[\begin{align}
-    \dot{\theta} &amp;= \Omega_b (\omega_\text{pll} - \omega_s) \tag{4a} \\
-    \dot{\epsilon} &amp;= v_\text{o}^q \tag{4b}\\
-    \omega_\text{pll} &amp;= \omega^\star + k^p_\text{pll} v_\text{o}^q + k_\text{pll}^i \epsilon \tag{4c}\\
-    \dot{\zeta} &amp;= v_\text{DC}^\star - v_\text{DC} \tag{4d} \\
-    i_\text{cv}^{d,\star} &amp;= k_\text{DC}^p ( v_\text{DC}^\star - v_\text{DC}) + k_\text{DC}^i \zeta \tag{4e}  \\
-    \frac{c_\text{DC}}{\Omega_b} \dot{v}_\text{DC} &amp;= \frac{p_\text{cv}}{v_\text{DC}} - \frac{v_\text{DC}}{r_L} \tag{4f} \\
-    \dot{\gamma}_d &amp;= i_\text{cv}^d - i_\text{cv}^{d,\star} \tag{4g}\\
-    \dot{\gamma}_q &amp;= i_\text{cv}^q - i_\text{cv}^{q,\star} \tag{4h} \\
-    v_\text{cv}^{d,\star} &amp;= k_\text{pc}( i_\text{cv}^d - i_\text{cv}^{d,\star}) + k_\text{ic} \gamma_d + \omega_\text{pll} l_f i_\text{cv}^q \tag{4i}\\
-    v_\text{cv}^{q,\star} &amp;= k_\text{pc}( i_\text{cv}^q - i_\text{cv}^{q,\star}) + k_\text{ic} \gamma_q - \omega_\text{pll} l_f i_\text{cv}^d \tag{4j}
-\end{align}\]</p><p>Equations (4a)–(4c)  describes the PLL dynamics to lock the active load to the grid. Equations (4d)-(4e)  describes the DC Voltage Controller to steer the DC voltage to <span>$v_\text{DC}^\star$</span>, while equation (4f) describes the DC voltage dynamics at the capacitor assuming an ideal converter. Finally, equations (4g)–(4j) describes the dynamics of the AC Current Controller. Additionally six states are defined for the LCL filter in a similar fashion of GFM inverters.</p></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../network/">« Network</a><a class="docs-footer-nextpage" href="../../code_base_developer_guide/developer/">Developer Guide »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 0.27.25 on <span class="colophon-date" title="Tuesday 9 April 2024 17:18">Tuesday 9 April 2024</span>. Using Julia version 1.10.2.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>
+\end{align*}\]</p></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../network/">« Network</a><a class="docs-footer-nextpage" href="../../code_base_developer_guide/developer/">Developer Guide »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 0.27.25 on <span class="colophon-date" title="Tuesday 9 April 2024 17:18">Tuesday 9 April 2024</span>. Using Julia version 1.10.2.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>
diff --git a/dev/component_models/machines/index.html b/dev/component_models/machines/index.html
@@ -88,16 +88,16 @@
 \end{align}\]</p><p>The parameters <span>$A$</span> and <span>$B$</span> for each function are computed using the two points given <span>$(1.0, \text{Se}(1.0))$</span> and <span>$(1.2, \text{Se}(1.2))$</span>.</p><h2 id="SauerPai-Machine-(6th-Order)-[SauerPaiMachine]"><a class="docs-heading-anchor" href="#SauerPai-Machine-(6th-Order)-[SauerPaiMachine]">SauerPai Machine (6th Order) <code>[SauerPaiMachine]</code></a><a id="SauerPai-Machine-(6th-Order)-[SauerPaiMachine]-1"></a><a class="docs-heading-anchor-permalink" href="#SauerPai-Machine-(6th-Order)-[SauerPaiMachine]" title="Permalink"></a></h2><p>The Sauer Pai model defines 6 differential equations as follows:</p><p class="math-container">\[\begin{align}
 \dot{\psi}_d &amp;= \Omega_b(r_ai_d + \omega \psi_q + v_d) \tag{9a} \\
 \dot{\psi}_q &amp;= \Omega_b(r_ai_q - \omega \psi_d + v_q) \tag{9b} \\
-\dot{e}_q&#39; &amp;= \frac{1}{T_{d0}&#39;} \left[(-e_q&#39; - (x_d - x_d&#39;)(i_d + \gamma_{d2} \cdot  \dot{\psi}_d&#39;&#39;) + v_f)\right] \tag{9c}\\
-\dot{e}_q&#39; &amp;= \frac{1}{T_{q0}&#39;} \left[(-e_d&#39; + (x_q - x_q&#39;)(i_q + \gamma_{q2} \cdot \dot{\psi}_q&#39;&#39;))\right] \tag{9d}\\
-\dot{\psi}_d&#39;&#39; &amp;= \frac{1}{T_{d0}&#39;&#39;} \left[(-\psi_d&#39;&#39; + e_q&#39; - (x_d&#39; - x_l)\cdot i_d)\right] \tag{9e} \\
-\dot{\psi}_q&#39;&#39; &amp;= \frac{1}{T_{q0}&#39;&#39;} \left[(-\psi_q&#39;&#39; - e_d&#39; - (x_q&#39; - x_l)\cdot i_q)\right]  \tag{9f} \\
-i_d &amp;= \frac{1}{x_d&#39;&#39;} (\gamma_{d1} \cdot  e_q&#39; - \psi_d + (1 - \gamma_{d1}) * \psi_d&#39;&#39;) \tag{9g} \\
-i_q &amp;= \frac{1}{x_q&#39;&#39;} ((-\gamma_{q1} \cdot  e_d&#39; - \psi_q + (1 - \gamma_{q1}) \cdot  \psi_q&#39;&#39;) \tag{9h} \\
+\dot{e}_q&#39; &amp;= \frac{1}{T_{d0}&#39;} \left[(-e_q&#39; - (x_d - x_d&#39;)(i_d + \gamma_d2 * \dot{\psi}_d&#39;&#39;) + v_f)] \tag{9c}\\
+\dot{e}_q&#39; &amp;= \frac{1}{T_{q0}&#39;} \left[(-e_d&#39; + (x_q - x_q&#39;)(i_q + \gamma_q2 * \dot{\psi}_q&#39;&#39;))] \tag{9d}\\
+\dot{\psi}_d&#39;&#39; &amp;= \frac{1}{T_{d0}&#39;&#39;} \left[(-\psi_d&#39;&#39; + e_q&#39; - (x_d&#39; - x_l)*i_d)] \tag{9e} \\
+\dot{\psi}_q&#39;&#39; &amp;= \frac{1}{T_{q0}&#39;&#39;} \left[(-\psi_q&#39;&#39; - e_d&#39; - (x_q&#39; - x_l)*i_q)]  \tag{9f} \\
+i_d &amp;= \frac{1}{x_d&#39;&#39;} (\gamma_d1 * e_q&#39; - \psi_d + (1 - \gamma_d1) * \psi_d&#39;&#39;) \tag{9g} \\
+i_q &amp;= \frac{1}{x_q&#39;&#39;} ((-\gamma_q1 * e_d&#39; - \psi_q + (1 - \gamma_q1) * \psi_q&#39;&#39;) \tag{9h} \\
 \tau_e &amp;= \psi_d i_q - \psi_q i_d \tag{9i}
 \end{align}\]</p><p>with</p><p class="math-container">\[\begin{align*}
-  \gamma_{d1} &amp;= \frac{x_d&#39;&#39; - x_l}{x_d&#39; - x_l} \\
-  \gamma_{q1} &amp;= \frac{x_q&#39;&#39; - x_l}{x_q&#39; - x_l} \\
-  \gamma_{d2} &amp;= \frac{1 - \gamma_d1}{x_d&#39; - x_l} \\
-  \gamma_{q2} &amp;= \frac{1 - \gamma_q1}{x_q&#39; - x_l}
+  \gamma_d1 &amp;= \frac{x_d&#39;&#39; - x_l}{x_d&#39; - x_l} \\
+  \gamma_q1 &amp;= \frac{x_q&#39;&#39; - x_l}{x_q&#39; - x_l} \\
+  \gamma_d2 &amp;= \frac{1 - \gamma_d1}{x_d&#39; - x_l} \\
+  \gamma_q2 &amp;= \frac{1 - \gamma_q1}{x_q&#39; - x_l}
 \end{align*}\]</p></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../../generic/">« Industrial Renewable Models</a><a class="docs-footer-nextpage" href="../shafts/">Shaft »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 0.27.25 on <span class="colophon-date" title="Tuesday 9 April 2024 17:18">Tuesday 9 April 2024</span>. Using Julia version 1.10.2.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>
diff --git a/dev/models/index.html b/dev/models/index.html
diff --git a/dev/power-simulations-dynamics.log b/dev/power-simulations-dynamics.log
@@ -1,44 +1,44 @@
-┌ Info: 2024-04-09T17:14:42.520 [5468:1]: The reference Bus has a Source connected to it. The frequency reference model will change to ConstantFrequency
+┌ Info: 2024-04-09T17:14:33.412 [5375:1]: The reference Bus has a Source connected to it. The frequency reference model will change to ConstantFrequency
 └ @ PowerSimulationsDynamics /home/runner/work/PowerSimulationsDynamics.jl/PowerSimulationsDynamics.jl/src/base/frequency_reference.jl:70
-┌ Info: 2024-04-09T17:14:42.547 [5468:1]: Pre-Initializing Simulation States
+┌ Info: 2024-04-09T17:14:33.444 [5375:1]: Pre-Initializing Simulation States
 └ @ PowerSimulationsDynamics /home/runner/work/PowerSimulationsDynamics.jl/PowerSimulationsDynamics.jl/src/base/simulation.jl:265
-┌ Info: 2024-04-09T17:14:42.547 [5468:1]: Unit System changed to UnitSystem.SYSTEM_BASE = 0
+┌ Info: 2024-04-09T17:14:33.444 [5375:1]: Unit System changed to UnitSystem.SYSTEM_BASE = 0
 └ @ PowerSystems /home/runner/.julia/packages/PowerSystems/xh3fM/src/base.jl:395
-┌ Info: 2024-04-09T17:14:44.207 [5468:1]: PowerFlow solve converged, the results have been stored in the system
+┌ Info: 2024-04-09T17:14:35.324 [5375:1]: PowerFlow solve converged, the results have been stored in the system
 └ @ PowerFlows /home/runner/.julia/packages/PowerFlows/6nw6s/src/nlsolve_ac_powerflow.jl:47
-┌ Info: 2024-04-09T17:14:44.207 [5468:1]: Unit System changed to UnitSystem.DEVICE_BASE = 1
+┌ Info: 2024-04-09T17:14:35.324 [5375:1]: Unit System changed to UnitSystem.DEVICE_BASE = 1
 └ @ PowerSystems /home/runner/.julia/packages/PowerSystems/xh3fM/src/base.jl:395
-┌ Info: 2024-04-09T17:14:56.829 [5468:1]: Residual from initial guess: max = 4.212807880321634e-11 at 4, total = 5.4841923110646186e-11
+┌ Info: 2024-04-09T17:14:49.404 [5375:1]: Residual from initial guess: max = 4.212807880321634e-11 at 4, total = 5.4841923110646186e-11
 └ @ PowerSimulationsDynamics /home/runner/work/PowerSimulationsDynamics.jl/PowerSimulationsDynamics.jl/src/base/nlsolve_wrapper.jl:115
-┌ Info: 2024-04-09T17:14:56.866 [5468:1]: Initialization non-linear solve succeeded with a tolerance of 1.0e-9 using solver trust_region. Saving solution.
+┌ Info: 2024-04-09T17:14:49.448 [5375:1]: Initialization non-linear solve succeeded with a tolerance of 1.0e-9 using solver trust_region. Saving solution.
 └ @ PowerSimulationsDynamics /home/runner/work/PowerSimulationsDynamics.jl/PowerSimulationsDynamics.jl/src/base/nlsolve_wrapper.jl:82
-┌ Info: 2024-04-09T17:14:56.866 [5468:1]: Attaching Perturbations
+┌ Info: 2024-04-09T17:14:49.448 [5375:1]: Attaching Perturbations
 └ @ PowerSimulationsDynamics /home/runner/work/PowerSimulationsDynamics.jl/PowerSimulationsDynamics.jl/src/base/simulation.jl:299
-┌ Info: 2024-04-09T17:14:57.357 [5468:1]: Simulations status = BUILT
+┌ Info: 2024-04-09T17:14:49.995 [5375:1]: Simulations status = BUILT
 └ @ PowerSimulationsDynamics /home/runner/work/PowerSimulationsDynamics.jl/PowerSimulationsDynamics.jl/src/base/simulation.jl:462
-┌ Info: 2024-04-09T17:14:57.357 [5468:1]: 
+┌ Info: 2024-04-09T17:14:49.995 [5375:1]: 
 │  ───────────────────────────────────────────────────────────────────────────────
 │                                                      Time          Allocations  
 │                                                ───────────────   ───────────────
-│                 Total measured:                     16.7s             839MiB    
+│                 Total measured:                     18.9s             839MiB    
 │ 
 │  Section                               ncalls     time    %tot     alloc    %tot
 │  ───────────────────────────────────────────────────────────────────────────────
-│  Build Simulation                           1    16.7s  100.0%    839MiB  100.0%
-│    Build Simulation Inputs                  1    1.93s   11.5%    125MiB   14.9%
-│      Wrap Branches                          1   11.0μs    0.0%      208B    0.0%
-│      Wrap Dynamic Injectors                 1    1.04s    6.2%   77.9MiB    9.3%
-│      Calculate MM, DAE_vector, Tota...      1   68.7ms    0.4%   6.28MiB    0.7%
-│      Wrap Static Injectors                  1   56.7ms    0.3%   1.63MiB    0.2%
-│    Pre-initialization                       1    4.86s   29.0%    259MiB   30.9%
-│      Power Flow solution                    1    1.70s   10.2%   41.5MiB    4.9%
-│      Initialize Static Injectors            1    2.18s   13.0%   27.5MiB    3.3%
-│      Initialize Dynamic Injectors           1    978ms    5.8%    190MiB   22.7%
-│    Calculate Jacobian                       1    4.50s   26.9%    398MiB   47.4%
-│    Make Model Function                      1   6.13ms    0.0%    122KiB    0.0%
-│    Initial Condition NLsolve refine...      1    4.96s   29.6%   29.9MiB    3.6%
-│    Build Perturbations                      1    209ms    1.3%   13.4MiB    1.6%
-│    Make DiffEq Problem                      1    276ms    1.7%   14.0MiB    1.7%
+│  Build Simulation                           1    18.9s  100.0%    839MiB  100.0%
+│    Build Simulation Inputs                  1    2.38s   12.6%    125MiB   14.9%
+│      Wrap Branches                          1   11.1μs    0.0%      208B    0.0%
+│      Wrap Dynamic Injectors                 1    1.18s    6.2%   78.0MiB    9.3%
+│      Calculate MM, DAE_vector, Tota...      1   81.4ms    0.4%   6.30MiB    0.8%
+│      Wrap Static Injectors                  1   68.0ms    0.4%   1.63MiB    0.2%
+│    Pre-initialization                       1    5.39s   28.5%    259MiB   30.9%
+│      Power Flow solution                    1    1.93s   10.2%   41.4MiB    4.9%
+│      Initialize Static Injectors            1    2.39s   12.7%   27.4MiB    3.3%
+│      Initialize Dynamic Injectors           1    1.07s    5.7%    190MiB   22.7%
+│    Calculate Jacobian                       1    5.11s   27.0%    398MiB   47.4%
+│    Make Model Function                      1   7.61ms    0.0%    122KiB    0.0%
+│    Initial Condition NLsolve refine...      1    5.49s   29.0%   29.9MiB    3.6%
+│    Build Perturbations                      1    234ms    1.2%   13.4MiB    1.6%
+│    Make DiffEq Problem                      1    307ms    1.6%   14.0MiB    1.7%
 │  ───────────────────────────────────────────────────────────────────────────────
 │ 
 └ @ PowerSimulationsDynamics /home/runner/work/PowerSimulationsDynamics.jl/PowerSimulationsDynamics.jl/src/base/simulation.jl:487
diff --git a/dev/quick_start_guide/index.html b/dev/quick_start_guide/index.html
@@ -99,5 +99,5 @@
 │ Time Span                  │ (0.0, 30.0) │
 │ Total Time Steps           │ 1502        │
 │ Number of States           │ 6           │
-│ Total solve time           │ 2.040856145 │
+│ Total solve time           │ 2.282734709 │
 └────────────────────────────┴─────────────┘</code><br/><code class="language-julia-repl hljs" style="display:block;">julia&gt; angle = get_state_series(results, (&quot;generator-102-1&quot;, :δ));</code><code class="nohighlight hljs ansi" style="display:block;"></code><br/><code class="language-julia-repl hljs" style="display:block;">julia&gt; plot(angle, xlabel = &quot;time&quot;, ylabel = &quot;rotor angle [rad]&quot;, label = &quot;gen-102-1&quot;)</code><code class="nohighlight hljs ansi" style="display:block;">Plot{Plots.GRBackend() n=1}</code></pre><p><img src="../assets/f-plot.svg" alt="plot"/></p><p>If you miss PSS/e&#39;s plotting aesthetics and want something that resembles that, you can use <a href="https://github.com/Evizero/UnicodePlots.jl"><code>UnicodePlots</code></a>.</p><pre><code class="language-julia-repl hljs" style="display:block;">julia&gt; using UnicodePlots</code><code class="nohighlight hljs ansi" style="display:block;"></code><br/><code class="language-julia-repl hljs" style="display:block;">julia&gt; unicodeplots()</code><code class="nohighlight hljs ansi" style="display:block;">Plots.UnicodePlotsBackend()</code><br/><code class="language-julia-repl hljs" style="display:block;">julia&gt; plot(angle, xlabel = &quot;time&quot;, ylabel = &quot;rotor angle [rad]&quot;, label = &quot;gen-102-1&quot;);</code><code class="nohighlight hljs ansi" style="display:block;"></code></pre><p><img src="../assets/unicode.png" alt="plot"/></p></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../">« Welcome Page</a><a class="docs-footer-nextpage" href="../execute/">Simulation Execution »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 0.27.25 on <span class="colophon-date" title="Tuesday 9 April 2024 17:18">Tuesday 9 April 2024</span>. Using Julia version 1.10.2.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>
diff --git a/dev/search_index.js b/dev/search_index.js
diff --git a/dev/tutorials/modified_sys.json b/dev/tutorials/modified_sys.json
diff --git a/dev/tutorials/threebus_sys.json b/dev/tutorials/threebus_sys.json