It makes more sense to display the info layer

dietmarw · dietmarw · commit b3a9f76886ba · 2026-02-16T08:19:14.000+01:00
diff --git a/OpenHPL/Controllers/Governor.mo b/OpenHPL/Controllers/Governor.mo
@@ -126,7 +126,7 @@ equation
   //else
   //  der(Y_gv) = u / T_g;
   //end if;
-   annotation (Documentation(info="<html>
+   annotation (preferredView="info", Documentation(info="<html>
 <h4>Governor</h4>
 <p>
 Here, a simple model of the governor that controls the guide vane opening in the turbine based on the reference power
diff --git a/OpenHPL/Controllers/package.mo b/OpenHPL/Controllers/package.mo
@@ -1,7 +1,6 @@
 within OpenHPL;
 package Controllers "Collection of different controllers"
   extends Modelica.Icons.Package;
-
   extends Icons.Governor;
 
 end Controllers;
diff --git a/OpenHPL/ElectroMech/BaseClasses/BaseValve.mo b/OpenHPL/ElectroMech/BaseClasses/BaseValve.mo
@@ -34,12 +34,12 @@ equation
   Vdot = mdot/data.rho;
   dp*(C_v_*max(epsilon, u^alpha))^2 = Vdot*abs(Vdot) "Valve equation for pressure drop";
   dp = i.p - o.p "Link the pressure drop to the ports";
-  annotation ( Documentation(info="<html>
+  annotation (preferredView="info", Documentation(info="<html>
 <p>
 This is a partial, simple model of hydraulic valve. &nbsp;</p><p>This model is based on the energy balance of a valve.
 </p>
 <ul>
-<li>Mass flow is equal at innflow and outflow</li>
+<li>Mass flow is equal at inflow and outflow</li>
 <li>The head loss and pressure difference is proportional to square of velocity</li>
 </ul>
 <p>
@@ -49,7 +49,7 @@ Specifically:
 <p>
 The function f(opening) is expressed as:
 </p>
-<p>$$ f(\\mathrm{opening}) = \\left( C_\\mathrm{v} \\cdot \\mathrm{max}(\\epsilon, u^\\alpha\\right)^2 $$</p>
+<p>$$ f(\\mathrm{opening}) = \\left( C_\\mathrm{v} \\cdot \\mathrm{max}(\\epsilon, u^\\alpha)\\right)^2 $$</p>
 <p>
 When \\(\\alpha\\) is 1, this implies a linear relation between closing and head loss.
 </p>
diff --git a/OpenHPL/ElectroMech/Generators/SimpleGen.mo b/OpenHPL/ElectroMech/Generators/SimpleGen.mo
@@ -13,7 +13,7 @@ model SimpleGen "Model of a simple generator with mechanical connectors"
         rotation=270,
         origin={0,120})));
 
-  annotation (
+  annotation (preferredView="info",
     Documentation(info= "<html>
 <h4>Simple Generator Model</h4>
 <p>Simple model of an ideal generator with friction based on angular momentum balance.</p>
diff --git a/OpenHPL/ElectroMech/Generators/SynchGen.mo b/OpenHPL/ElectroMech/Generators/SynchGen.mo
@@ -108,7 +108,7 @@ equation
   der(w) = (Wdot_ts - Pe) / (J * w);
   // - W_fa;
   //
-  annotation (
+  annotation (preferredView="info",
     Documentation(info= "<html>
 <h4>Synchronous Generator Model</h4>
 <p>Detailed synchronous generator model connected to the grid, based on d-q decomposition.</p>
diff --git a/OpenHPL/ElectroMech/PowerSystem/Grid.mo b/OpenHPL/ElectroMech/PowerSystem/Grid.mo
@@ -49,7 +49,7 @@ equation
   connect(product.y, dP2.u1) annotation (Line(points={{-13.5,67},{-8,67},{-8,33.6},{-12.8,33.6}}, color={0,0,127}));
   connect(toHz.u, w_m2pu.y) annotation (Line(points={{5.2,-50},{84,-50},{84,-40},{78.6,-40}}, color={0,0,127}));
   connect(toHz.y, dF.u1) annotation (Line(points={{-8.6,-50},{-22,-50}}, color={0,0,127}));
-  annotation (
+  annotation (preferredView="info",
     Documentation(info="<html>
 <h4>Primary control</h4>
 <h5>Network Power-Frequency Characteristic</h5>
diff --git a/OpenHPL/ElectroMech/Turbines/Francis.mo b/OpenHPL/ElectroMech/Turbines/Francis.mo
@@ -212,7 +212,7 @@ equation
     mdot=i.mdot;
 
   connect(p_out, P_out) annotation (Line(points={{40,90},{40,110}}, color={0,0,127}));
-    annotation (
+    annotation (preferredView="info",
         Documentation(info="<html>
 <h4>Francis Turbine Model</h4>
 
diff --git a/OpenHPL/ElectroMech/Turbines/Pelton.mo b/OpenHPL/ElectroMech/Turbines/Pelton.mo
@@ -56,7 +56,7 @@ equation
     mdot=i.mdot;
 
   connect(p_out, P_out) annotation (Line(points={{40,90},{40,110}}, color={0,0,127}));
-    annotation (
+    annotation (preferredView="info",
         Documentation(info="<html>
 <h4>Pelton Turbine Model</h4>
 <p>Mechanistic Pelton turbine model based on the Euler turbine equation and impulse turbine principles.</p>
diff --git a/OpenHPL/ElectroMech/Turbines/Turbine.mo b/OpenHPL/ElectroMech/Turbines/Turbine.mo
@@ -43,7 +43,7 @@ equation
   connect(lossCorrection.u1, power.y) annotation (Line(points={{-48,80},{-88,80},{-88,30},{-81,30}},color={0,0,127}));
   connect(frictionLoss.power, lossCorrection.u2) annotation (Line(points={{-1,12},{-40,12},{-40,72}},color={0,0,127}));
   connect(u_t, u) annotation (Line(points={{-80,120},{-80,90},{0,90},{0,70}},color={0,0,127}));
-  annotation (
+  annotation (preferredView="info",
     Documentation(info="<html>
 <h4>Simple Turbine Model</h4>
 
diff --git a/OpenHPL/Functions/Fitting/FittingPhi.mo b/OpenHPL/Functions/Fitting/FittingPhi.mo
@@ -48,7 +48,7 @@ algorithm
       D_o,
       L);
   end if;
-  annotation (
+  annotation (preferredView="info",
     Documentation(info = "<html>
 <p>Define dimension factor &phi; for different types of fittings.</p>
 </html>"));
diff --git a/OpenHPL/Functions/Fitting/FittingVariants/Rounded.mo b/OpenHPL/Functions/Fitting/FittingVariants/Rounded.mo
@@ -13,7 +13,7 @@ algorithm
     /* Rounded Expansion (same as Square Expansion) */
     phi := Square(N_Re,p_eps,D_i,D_o);
   end if;
-  annotation (Documentation(info="<html>
+  annotation (preferredView="info", Documentation(info="<html>
 <p>Define dimension factor &phi; for Rounded Reduction. Rounded Expansion is the same as Squared Expansion.</p>
 <table cellspacing=\"0\" cellpadding=\"2\" border=\"0\" width=\"50%\">
 <tr>
diff --git a/OpenHPL/Functions/Fitting/FittingVariants/SharpOrifice.mo b/OpenHPL/Functions/Fitting/FittingVariants/SharpOrifice.mo
@@ -14,7 +14,7 @@ algorithm
   else
     phi := (2.72 + (D_o / D_i) ^ 2 * 4000 / (N_Re + Modelica.Constants.eps)) * phi_0;
   end if;
-  annotation (
+  annotation (preferredView="info",
     Documentation(info="<html>
     <p>Calculates the dimension factor &phi; for Sharp Orifice.</p>
 <table cellspacing=\"0\" cellpadding=\"2\" border=\"0\" width=\"50%\">
diff --git a/OpenHPL/Functions/Fitting/FittingVariants/Square.mo b/OpenHPL/Functions/Fitting/FittingVariants/Square.mo
@@ -24,7 +24,7 @@ algorithm
       phi := (1 + 0.8*f_D)*(1 - (D_i/D_o)^2)^2;
     end if;
   end if;
-  annotation (Documentation(info="<html>
+  annotation (preferredView="info", Documentation(info="<html>
 <p>Calculates the dimension factor <strong>&phi;</strong> for square reduction/expansion.</p>
 <table cellspacing=\"0\" cellpadding=\"2\" border=\"0\" width=\"50%\"><tr>
 <td><p><em>Squared Reduction:</em></p></td>
diff --git a/OpenHPL/Functions/Fitting/FittingVariants/Tapered.mo b/OpenHPL/Functions/Fitting/FittingVariants/Tapered.mo
@@ -36,7 +36,7 @@ algorithm
       phi := Square(N_Re,p_eps,D_i,D_o);
     end if;
   end if;
-  annotation (
+  annotation (preferredView="info",
     Documentation(info="<html>
 <p>Calculates the dimension factor &phi; for Tapered reduction/expansion.
  The tapered angle &theta; should be specified.</p>
diff --git a/OpenHPL/Functions/Fitting/FittingVariants/ThickOrifice.mo b/OpenHPL/Functions/Fitting/FittingVariants/ThickOrifice.mo
@@ -13,7 +13,7 @@ algorithm
   if L / D_o <= 5 then
     phi := (0.584 + 0.0936 / ((L / D_o) ^ 1.5 + 0.225)) * phi_0;
   end if;
-  annotation (
+  annotation (preferredView="info",
     Documentation(info="<html>
     <p>Define dimension factor &phi; for Thick Orifice.
     Orifice length should be provided and this length should not be greater than 5D<sub>o</sub>.</p>
diff --git a/OpenHPL/Functions/Fitting/package.mo b/OpenHPL/Functions/Fitting/package.mo
@@ -2,7 +2,7 @@ within OpenHPL.Functions;
 package Fitting "Functions for pipe fitting"
   extends Modelica.Icons.UtilitiesPackage;
 
- annotation (Documentation(info="<html>
+ annotation (preferredView="info", Documentation(info="<html>
 <h4>Fitting</h4>
 <p>
 The functions for defining the pressure drop in various pipe fittings are described here. Due to different
diff --git a/OpenHPL/Functions/KP07/KPfunctions/GhostCells.mo b/OpenHPL/Functions/KP07/KPfunctions/GhostCells.mo
@@ -27,7 +27,7 @@ equation
   p_[3:N + 2] = p;
   mdot_[3:N + 2] = mdot;
   U_ = vector([p_; mdot_]);
-  annotation (
+  annotation (preferredView="info",
     Documentation(info="<html>
 <p>The model for defining the ghost cells. It can be observed that for a given <code>j<sup>th</sup></code> cell, information from the neighbouring cells <em>j-1</em> and <em>j-2</em> (to the left) and <em>j+1</em> and<em> j+2</em> (to the right) are required for calculating the flux integrals.</p>
 <p><img src=\"modelica://OpenHPL/Resources/Images/ghosts.svg\"/></p>
diff --git a/OpenHPL/Functions/KP07/KPfunctions/PieceWiseU.mo b/OpenHPL/Functions/KP07/KPfunctions/PieceWiseU.mo
@@ -32,7 +32,7 @@ equation
   U_pp[2, N] = if bounCon[2, 2] then boun[2, 2] else mdot_ghosts[N + 3] - dx * s[2, N + 2] / 2;
   // output vector U_
   U_ = [U_mp; U_pp; U_mm; U_pm];
-  annotation (
+  annotation (preferredView="info",
     Documentation(info="<html>
 <p>The piecewise linear reconstruction model, where the values of the left and the right interfaces of the cell (j-1/2 and j+1/2) at the right(+)/left(-) point values are defined.</p>
 <p><img src=\"modelica://OpenHPL/Resources/Images/equations/KP_piecewise.svg\"/></p>
diff --git a/OpenHPL/Functions/KP07/KPfunctions/SlopeVectorS.mo b/OpenHPL/Functions/KP07/KPfunctions/SlopeVectorS.mo
@@ -33,7 +33,7 @@ equation
     //        s[2,i] = 0;
     //      end if;
   end for;
-  annotation (
+  annotation (preferredView="info",
     Documentation(info="<html>
 <p>The model for defining the slope <em>s<sub>j</sub></em> of the reconstructed function in each cell, which is computed using a limiter function to obtain a non-oscillatory nature of the reconstruction. The KP07 scheme utilizes the generalized minmod limiter:</p>
 <p><img src=\"modelica://OpenHPL/Resources/Images/equations/KP_slope.svg\"/></p>
diff --git a/OpenHPL/Functions/KP07/KPfunctions/SpeedPropagationApipe.mo b/OpenHPL/Functions/KP07/KPfunctions/SpeedPropagationApipe.mo
@@ -14,9 +14,9 @@ equation
     a_pm[i] = max(max(lamda1[i, 4], lamda1[i, 3]), 0);
   end for;
   A = [a_mp, a_pp, a_mm, a_pm];
-  annotation (
+  annotation (preferredView="info",
     Documentation(info="<html>
-<p>The mode lfor defining the the one-sided local speed of propagations. Estimated as the largest and the smallest eigen values of the Jacobian of the system.</p>
+<p>The model for defining the the one-sided local speed of propagations. Estimated as the largest and the smallest eigen values of the Jacobian of the system.</p>
 <p><img src=\"modelica://OpenHPL/Resources/Images/equations/KP_speed.svg\"/></p>
 </html>"));
 end SpeedPropagationApipe;
diff --git a/OpenHPL/Functions/KP07/KPfunctions/SpeedPropagationApipeF.mo b/OpenHPL/Functions/KP07/KPfunctions/SpeedPropagationApipeF.mo
@@ -15,8 +15,8 @@ algorithm
     a_pm[i] := max(max(lamda1[i, 4], lamda1[i, 3]), 0);
   end for;
   A := [a_mp, a_pp, a_mm, a_pm];
-  annotation (
+  annotation (preferredView="info",
     Documentation(info = "<html>
-<p>The mode lfor defining the the one-sided local speed of propagations. Estimated as the largest and the smallest eigen values of the Jacobian of the system.</p>
+<p>The model for defining the the one-sided local speed of propagations. Estimated as the largest and the smallest eigen values of the Jacobian of the system.</p>
 </html>"));
 end SpeedPropagationApipeF;
diff --git a/OpenHPL/Functions/KP07/package.mo b/OpenHPL/Functions/KP07/package.mo
@@ -2,7 +2,7 @@ within OpenHPL.Functions;
 package KP07 "Methods for KP07 scheme"
   extends Modelica.Icons.UtilitiesPackage;
 
-  annotation (Documentation(info="<html>
+  annotation (preferredView="info", Documentation(info="<html>
 <h4>KP Scheme</h4>
 <p>
 Functions for solving PDEs in Modelica are described here. The Kurganov-Petrova (KP) scheme is a
diff --git a/OpenHPL/Functions/package.mo b/OpenHPL/Functions/package.mo
@@ -2,7 +2,7 @@ within OpenHPL;
 package Functions "Functions and methods"
   extends Modelica.Icons.FunctionsPackage;
 
-  annotation (
+  annotation (preferredView="info",
     Documentation(info = "<html>
 <p>Functions and methods for modelling different components of the hydropower system. </p>
 </html>"));
diff --git a/OpenHPL/Interfaces/package.mo b/OpenHPL/Interfaces/package.mo
@@ -1,7 +1,7 @@
 within OpenHPL;
 package Interfaces "Basic interface components"
   extends Modelica.Icons.InterfacesPackage;
-annotation (Documentation(info="<html>
+annotation (preferredView="info", Documentation(info="<html>
 <h4>Interfaces</h4>
 <p>
  In the <strong>OpenHPL</strong>,
diff --git a/OpenHPL/Waterway/BendPipe.mo b/OpenHPL/Waterway/BendPipe.mo
@@ -23,7 +23,7 @@ equation
   o.p = i.p - dp "Pressure of the output connector";
   i.mdot + o.mdot = 0 "Mass balance";
   mdot = i.mdot "Flow direction";
-  annotation (
+  annotation (preferredView="info",
     Documentation(info="<html>
 <p>Usually minor head losses in pipes are considered to be due to fittings, diffusers, nozzles, bend in pipes, etc. We are more interested in head loss due to bend pipes for this model.</p>
 <p>A typical loss coefficient value for flanged and threaded elbows, tees, gates, valves, etc., can be taken as,</p>
diff --git a/OpenHPL/Waterway/DraftTube.mo b/OpenHPL/Waterway/DraftTube.mo
@@ -153,7 +153,7 @@ equation
   p_o = o.p;
   i.mdot+o.mdot=0;
   mdot = i.mdot;
-  annotation (Documentation(info="<html>
+  annotation (preferredView="info", Documentation(info="<html>
     <p>Two of the draft tubes are modeled using <em>Momentum balance</em>.
     They are:</p>
 <ul>
diff --git a/OpenHPL/Waterway/Fitting.mo b/OpenHPL/Waterway/Fitting.mo
@@ -53,7 +53,7 @@ equation
   o.p = i.p - dp "Pressure of the output connector";
   i.mdot+o.mdot = 0 "Mass balance";
   mdot = i.mdot "Flow direction";
-  annotation (
+  annotation (preferredView="info",
     Documentation(info="<html>
     <p>Various possibilities of the fittings for the pipes with different diameters
     and also the orifices in the pipe.
diff --git a/OpenHPL/Waterway/OpenChannel.mo b/OpenHPL/Waterway/OpenChannel.mo
@@ -39,7 +39,7 @@ equation
 // presurre boundaries
   i.p = h[1] * data.g * data.rho + data.p_a;
   o.p = h[N] * data.g * data.rho + data.p_a;
-  annotation (
+  annotation (preferredView="info",
     Documentation(info="<html>
 <p style=\"color: #ff0000;\"><em>Note: Currently under investigation for plausibility.</em></p>
 
diff --git a/OpenHPL/Waterway/Penstock.mo b/OpenHPL/Waterway/Penstock.mo
@@ -83,7 +83,7 @@ equation
   // volumetric flow rates for all cells
   V_p_out = mdot ./ rho_m;
   V_p_out_end = mdot_V / (data.rho * (1 + data.beta * (p_o - data.p_a)));
-  annotation (
+  annotation (preferredView="info",
     Documentation(info="<html><head></head><body><p>This is a more detaied model of the pipe that can be use for proper modeling of penstock. (This model does not work well. Instead PenstockKP model can be used.)</p><p>The model for the penstock with the elastic walls and compressible water with simple discretization method (Staggered grid). The geometry of the penstock is described due to figure:</p>
 <p><img src=\"modelica://OpenHPL/Resources/Images/pipe.svg\"></p>
 <p>Conservation laws are usually solved by Finite-volume methods. With the Finite volume method, we divide the grid into small control volumes or control cells and then apply the conservation laws. The discretization method is based on Staggered grid scheme, where the penstock is divided in <em>N</em> segments, with input and output pressure as a boundary conditions. Can be describe as the follow figure:</p>
diff --git a/OpenHPL/Waterway/PenstockKP.mo b/OpenHPL/Waterway/PenstockKP.mo
@@ -115,7 +115,7 @@ equation
   S_[N + 1:2 * N] = F_ap * data.g * H / L - F_f / dx;
   // diff. equation
   der(U) = KP.diff_eq;
-  annotation (
+  annotation (preferredView="info",
     Documentation(info="<html>
 <h4>Elastic Penstock with KP Method</h4>
 
diff --git a/OpenHPL/Waterway/Pipe.mo b/OpenHPL/Waterway/Pipe.mo
@@ -72,7 +72,7 @@ equation
   i.mdot+o.mdot = 0 "Mass balance";
   mdot = i.mdot "Inlet direction for mdot";
 
-  annotation (
+  annotation (preferredView="info",
     Documentation(info="<html>
 <h4>Simple Pipe Model</h4>
 
diff --git a/OpenHPL/Waterway/Reservoir.mo b/OpenHPL/Waterway/Reservoir.mo
@@ -78,7 +78,7 @@ equation
 
    o.mdot = -data.rho * Vdot_o "Output flow connector";
   //o.T = T_0 "TBD: Output temperature connector";
-  annotation (Documentation(info="<html>
+  annotation (preferredView="info", Documentation(info="<html>
 <h4>Reservoir Model</h4>
 
 <p>Simple model of the reservoir with different options for modeling the water source of a hydropower system.</p>
diff --git a/OpenHPL/Waterway/ReservoirChannel.mo b/OpenHPL/Waterway/ReservoirChannel.mo
@@ -31,7 +31,7 @@ equation
   o.mdot =-q*W*data.rho;
   o.p = data.p_a + data.rho * data.g * openChannel.h[N];
   annotation (
-    Documentation(info="<html>
+    Documentation(preferredView="info", info="<html>
 <h4>Reservoir Channel Model</h4>
 <p>A more detailed reservoir model based on the open channel model, where the channel bed is assumed to be flat (no slope).</p>
 
diff --git a/OpenHPL/Waterway/RunOff_zones.mo b/OpenHPL/Waterway/RunOff_zones.mo
@@ -107,7 +107,7 @@ equation
   F_e = (flow_var.y[1] - Vdot_tot) ^ 2;
   R2 = 1 - F_e / F_o;
   Vdot_runoff = Vdot_tot;
-  annotation (
+  annotation (preferredView="info",
     Documentation(info="<html>
 <p>
 Similar to many other hydrological models, the HBV model is based on the land phase of the hydrological (water) cycle.
diff --git a/OpenHPL/Waterway/RunOff_zones_input.mo b/OpenHPL/Waterway/RunOff_zones_input.mo
@@ -80,7 +80,7 @@ equation
   F_e = (flow_var - Vdot_tot) ^ 2;
   R2 = 1 - F_e / F_o;
   Vdot_runoff = Vdot_tot;
-  annotation (
+  annotation (preferredView="info",
     Documentation(info="<html>
 <p>This is the same hydrology model that is based on the HBV hydrological model.</p>
 <p>This model can be used to define the inflow (runoff) to the reservoir.
diff --git a/OpenHPL/Waterway/SurgeTank.mo b/OpenHPL/Waterway/SurgeTank.mo
@@ -137,7 +137,7 @@ equation
   i.p = o.p "Inlet and outlet pressure equality";
   mdot = i.mdot+o.mdot "Mass balance";
   F_g = m * data.g * cos_theta;
- annotation (
+ annotation (preferredView="info",
     Documentation(info="<html>
 <h4>Surge Tank Model</h4>
 
diff --git a/OpenHPL/Waterway/Valve.mo b/OpenHPL/Waterway/Valve.mo
@@ -14,7 +14,7 @@ model Valve "Simple hydraulic valve"
         origin={0,80})));
 equation
   connect(opening, u) annotation (Line(points={{0,120},{0,70}}, color={0,0,127}));
-  annotation (
+  annotation (preferredView="info",
     Documentation(info="<html>
 <h4>Hydraulic Valve Model</h4>
 
diff --git a/OpenHPL/Waterway/VolumeFlowSource.mo b/OpenHPL/Waterway/VolumeFlowSource.mo
@@ -53,7 +53,7 @@ equation
       points={{-39,-20},{10,-20}},
       color={0,0,127},
       pattern=LinePattern.Dot));
-  annotation (Documentation(info="<html>
+  annotation (preferredView="info", Documentation(info="<html>
 Can be used as an ideal volume flow source. Either with a fixed volume flow defined by <code>Vdot_0</code>
 or via the input connector <code>inFlow</code>.
 In addition the input can be passed through a first order filter which is sometimes necessary
diff --git a/OpenHPL/Waterway/package.mo b/OpenHPL/Waterway/package.mo
@@ -2,7 +2,7 @@ within OpenHPL;
 package Waterway "Different components of the hydropower system"
   extends OpenHPL.Icons.Water;
 
- annotation (Documentation(info="<html>
+ annotation (preferredView="info", Documentation(info="<html>
 <h4>Waterway Models</h4>
 <p>
 A typical structure of the waterway of the hydropower system includes reservoirs, conduits (intake race,
