improved UsersGuide

AHaumer · May 24, 2021 · 36a3ad1 · 36a3ad1
1 parent 2f31c4d
commit 36a3ad1
Show file tree

Hide file tree

Showing 2 changed files with 8 additions and 4 deletions.
diff --git a/Modelica/Electrical/Machines/Examples/ControlledDCDrives/UsersGuide/CascadedControl.mo b/Modelica/Electrical/Machines/Examples/ControlledDCDrives/UsersGuide/CascadedControl.mo
@@ -2,7 +2,7 @@ within Modelica.Electrical.Machines.Examples.ControlledDCDrives.UsersGuide;
 class CascadedControl "Concept of cascaded control"
   extends Modelica.Icons.Information;
   annotation (DocumentationClass=true, Documentation(info="<html>
-<p>The concept of cascaded control is shown in Fig. 1.</p>
+<p>The concept of cascaded control is explained in <a href=\"modelica://Modelica.Electrical.Machines.UsersGuide.References\">[Nuss2010], [Schroeder2015]</a> and shown in Fig. 1.</p>
 <table border=\"0\" cellspacing=\"0\" cellpadding=\"2\">
   <caption align=\"bottom\"><strong>Fig. 1:</strong> Structure of cascaded control</caption>
   <tr>
@@ -28,6 +28,7 @@ Both delays define the sum of small time constants T<sub>&sigma;</sub>.
 <p><br>
 The innermost control loop consists of the current controller, which is parameterized according to the absolute optimum (Fig. 3)
 which aims at optimal transfer function with respect to the reference current.
+For the absolute optimum refer to <a href=\"modelica://Modelica.Electrical.Machines.UsersGuide.References\">[Lutz2012], [Nuss2010], [Schroeder2015]</a>.
 </p>
 <ul>
 <li>PI - controller</li>
@@ -46,13 +47,15 @@ which aims at optimal transfer function with respect to the reference current.
 <p><br>
 The optional next loop comprises the speed controller, which is parameterized according to the symmetrical optimum (Fig. 4) 
 which aims at optimal transfer function with respect to disturbance (load torque).
+For the symmetrical optimum refer to <a href=\"modelica://Modelica.Electrical.Machines.UsersGuide.References\">[Lutz2012], [Nuss2010], [Schroeder2015]</a>.
 </p>
 <ul>
 <li>PI - controller</li>
 <li>Limitation of the output (reference torque) to the possible torque (current)</li>
 <li>Subsequently, an anti-windup method</li>
-<li>If reference speed is not prescribed by a correctly parameterized position controller which is commanded by a kinematicPTP (optimal path planning), 
-    reference has to be filtered or limited in slew rate</li>
+<li>If reference speed is not prescribed by a correctly parameterized position controller which is commanded by a 
+    <a href=\"modelica://Modelica.Blocks.Sources.KinematicPTP2\">kinematic point-to-point</a>
+    (optimal path planning), reference has to be filtered or limited in slew rate</li>
 </ul>
 <table border=\"0\" cellspacing=\"0\" cellpadding=\"2\">
   <caption align=\"bottom\"><strong>Fig. 4:</strong> Parameterization of the speed controller</caption>

diff --git a/Modelica/Electrical/Machines/Examples/ControlledDCDrives/UsersGuide/DiscreteControl.mo b/Modelica/Electrical/Machines/Examples/ControlledDCDrives/UsersGuide/DiscreteControl.mo
@@ -3,10 +3,11 @@ class DiscreteControl "Concept of quasi-continuous discrete control"
   extends Modelica.Icons.Information;
   annotation (DocumentationClass=true, Documentation(info="<html>
 <p>
+According to <a href=\"modelica://Modelica.Electrical.Machines.UsersGuide.References\">[Latzel1995]</a> we can state: 
 Provided the sampling frequency of the I/O between controller and drive is much higher than the eigenvalues of the drive, 
 and the sum of small time constants due to the delays in setting the desired voltage and mesuring the actual current into account,
 the controller can be designed as a time-continuous controller. 
-These delay have to be investigated acoording to the used implementation. 
+These delays have to be investigated acoording to the used implementation. 
 In these examples, timing is used according to Fig. 1. 
 Here a triangle is used as the reference signal of the intersective pwm. 
 Therefore sampling at the middle of the switching interval hits the average of the current with high accuracy.