@@ -212,36 +212,66 @@ equation
212212 mdot= i.mdot;
213213
214214 connect (p_out, P_out) annotation (Line(points={{40,90},{40,110}}, color={0,0,127}));
215- annotation (
215+ annotation (preferredView= "info" ,
216216 Documentation(info="<html>
217- <p>
218- This is the Francis turbine model that gives possibilities for proper modelling of the Francis turbine.
219- </p>
220- <p>The mechanistic model is based on Euler equations for the Francis turbine.
221- Besides hydraulic input and output, there are input as the control signal for the valve opening
222- and also output as the turbine shaft power and input as angular velocity.
223- </p>
217+ <h4>Francis Turbine Model</h4>
218+
219+ <p>This is the Francis turbine model that gives possibilities for proper modelling of the Francis turbine.
220+ The mechanistic model is based on Euler equations for the Francis turbine.</p>
221+
222+ <p>Besides hydraulic input and output, there are input as the control signal for the valve opening
223+ and also output as the turbine shaft power and input as angular velocity.</p>
224+
224225<p align=\" center\">
225226<img src=\" modelica://OpenHPL/Resources/Images/turbinefrancis.svg\">
226227</p>
228+ <p><em>Figure: Key quantities in the Francis turbine model showing inlet (1) and outlet (2) sections.</em></p>
229+
230+ <h5>Euler Turbine Equations</h5>
231+
232+ <p>The shaft power produced by the turbine is given by:</p>
233+ <p>$$ \\dot{W}_s = \\dot{m}\\omega \\left(R_1\\frac{\\dot{V}}{A_1}\\cot{\\alpha_1} - R_2\\left(\\omega R_2 + \\frac{\\dot{V}}{A_2}\\cot{\\beta_2}\\right)\\right) $$</p>
234+
235+ <p>where ṁ and V̇ are mass and volumetric flow rates, ω is angular velocity, R<sub>1</sub> and R<sub>2</sub>
236+ are inlet and outlet radii, A<sub>1</sub> and A<sub>2</sub> are cross-sectional areas, α<sub>1</sub> is
237+ inlet guide vane angle, and β<sub>2</sub> is outlet blade angle.</p>
238+
239+ <h5>Total Work and Efficiency</h5>
240+
241+ <p>The total work rate is:</p>
242+ <p>$$ \\dot{W}_t = \\dot{W}_s + \\dot{W}_{ft} + \\Delta p_v \\dot{V} $$</p>
243+ <p>where Ẇ<sub>ft</sub> represents various friction losses (shock, whirl, wall friction),
244+ and Δp<sub>v</sub>V̇ accounts for guide vane pressure drop. Turbine efficiency \\(\\eta = \\dot{W}_s / \\dot{W}_t\\).</p>
245+
246+ <h5>Turbine Design Algorithm</h5>
247+
227248<p>There is also available the runner design algorithm that can define all geometrical
228- parameters based on the nominal parameters.</p><p>The turbine losses coefficients
229- (<code>k_ft1</code>, <code>k_ft2</code>, <code>k_ft3</code>) can be also defined automatically.
230- However, if some dynamic data from real turbine is available it is better to tune
231- these parameters a bit more and use the defined values as a starting point.
232- </p>
233- <p>A model for servo that that runs the guide vane opening is also available.
234- Furthermore it is possible to automatically generate all need parameters for the servo,
235- or simply specify them.
236- </p>
237- <p>
238- This mechanistic turbine model does not work really well for low loads (<10% guide vane opening).
249+ parameters based on the nominal parameters (net head, flow rate, power, speed).
250+ The algorithm determines: outlet blade angle β<sub>2</sub>, runner radii R<sub>1</sub> and R<sub>2</sub>,
251+ runner width w<sub>1</sub>, and inlet blade angle β<sub>1</sub>.</p>
252+
253+ <p>The turbine losses coefficients (<code>k_ft1</code>, <code>k_ft2</code>, <code>k_ft3</code>) can be also
254+ defined automatically. However, if some dynamic data from real turbine is available it is better to tune
255+ these parameters a bit more and use the defined values as a starting point.</p>
256+
257+ <h5>Guide Vane Actuation</h5>
258+
259+ <p>A model for servo that runs the guide vane opening is also available. A guide vane opening model relates
260+ actuator position Y to guide vane angle α<sub>1</sub> through geometric relationships. Furthermore it is
261+ possible to automatically generate all needed parameters for the servo, or simply specify them.</p>
262+
263+ <h5>Low Load Performance</h5>
264+
265+ <p>This mechanistic turbine model does not work really well for low loads (<10% guide vane opening).
239266However there is parameters that could be tuned for low load regimes.
240267These are <code>u_min</code> and <code>k_ft4</code>.</p>
241268
269+ <h5>More Information</h5>
270+
242271<p>More info about the mechanistic turbine model can be found in:
243- <a href=\" modelica://OpenHPL.UsersGuide.References\">[Vytvytskyi2018]</a> and about
244- the servo (also turbine model) in:
272+ <a href=\" modelica://OpenHPL.UsersGuide.References\">[Vytvytskyi2018]</a> and
273+ <a href=\" modelica://OpenHPL.UsersGuide.References\">[Vytvytskyi2019]</a>.
274+ Additional details about the servo (and turbine model) are in:
245275<a href=\" modelica://OpenHPL/Resources/Documents/Turbines_model.pdf\">Resources/Documents/Turbines_model.pdf</a>.</p>
246276</html>" ));
247277end Francis;
0 commit comments