Merge pull request #1 from robbr48/update_tutorial_optimization

Update optimization tutorial

Author: robbr48

gfx/Hopsan-Wizard.png

@@ -18,12 +18,9 @@ \section*{Using the optimization dialog}
 \tutitem{Open the model}
 The \textit{Welcome} tab has a box with example models. Open the \textit{Position Servo} example model.
 
-\FloatBarrier
-\begin{figure}[h]
-\center
+\begin{centering}
 \includegraphics[width=0.5\textwidth]{gfx/optimization/openmodel.png}
-\end{figure}
-\FloatBarrier
+\end{centering}
 
 This model describes of a hydraulic position servo, where a PI-controller is used to control the position. This consists of a proportional gain ($K_{p}$) and an integrator gain ($K_{i}$).  The values of these gains will decide the speed and stability of the servo. It is thus desirable to find as good controller parameters as possible.
 
@@ -39,35 +36,39 @@ \section*{Using the optimization dialog}
 
 \icon{0}{gfx/Hopsan-Optimize.png}{Open optimization dialog (Ctrl-Shift-Z)}
 
-\pagebreak
 
-\tutitem{Optimization settings} 
-The first page should look like this:
+\begin{center}
+\includegraphics[width=0.7\textwidth]{gfx/optimization/screenshot-opt0.png}
+\end{center}
 
-\FloatBarrier
-\begin{figure}[h]
-\center
-\includegraphics[width=0.7\textwidth]{gfx/optimization/screenshot-opt1.png}
-\end{figure}
-\FloatBarrier
+The first page should look like above. You can either write an optimization script by hand, load a script file or start the script wizard. 
+Let us begin with the latter.
+Click on the wizard icon.
 
-From here you can choose the general settings for the optimization.
+\icon{0}{gfx/Hopsan-Wizard.png}{Script Wizard}
+
+\tutitem{Optimization settings} 
+%
+The first wizard page will open. From here you can choose the general optimization settings.
+%
+\begin{center}
+\includegraphics[width=0.7\textwidth]{gfx/optimization/screenshot-opt1.png}
+\end{center}
+%
 \begin{itemize}
-\item Set \textit{Algorithm} to \textit{Complex}
+\item Set \textit{Algorithm} to \textit{Complex-RF}
 \item Set \textit{Number of iterations} to 1000
 \item Set \textit{Number of points} to 4
 \end{itemize}
 Leave all other settings unchanged for now.
 
+\pagebreak
 \tutitem{Choose optimization parameters} 
 Next page controls the parameters in the model that shall be optimized. 
 
-\FloatBarrier
-\begin{figure}[h]
-\center
+\begin{center}
 \includegraphics[width=0.7\textwidth]{gfx/optimization/screenshot-opt2.png}
-\end{figure}
-\FloatBarrier
+\end{center}
 
 Check the following parameters in the list:
 
@@ -96,12 +97,9 @@ \section*{Using the optimization dialog}
 
 Then choose \enquote{Minimize} and \enquote{Absolute Average Difference} in the boxes. Click \enquote{Add Function}.
 
-\FloatBarrier
-\begin{figure}[htb]
-\center
+\begin{center}
 \includegraphics[width=0.7\textwidth]{gfx/optimization/screenshot-opt3a.png}
-\end{figure}
-\FloatBarrier
+\end{center}
 
 Apart from minimizing the average difference, we also want to minimize the overshoot of the step response. 
 \begin{itemize}
@@ -110,55 +108,42 @@ \section*{Using the optimization dialog}
 
 Now choose \enquote{Minimize} and \enquote{Overshoot}, and then click \enquote{Add Function}. In the box called \enquote{arg1}, change the value to 0.7. 
 
-\newpage
 Now we have added a second objective function. The total objective function will the sum of these. As they may not be equally important or equally scaled, it is possible to weight the individual functions.  Change \enquote{Weight} for the first function to 10. Now the page should look like this:
 
-\FloatBarrier
-\begin{figure}[htb]
-\center
+\begin{center}
 \includegraphics[width=0.7\textwidth]{gfx/optimization/screenshot-opt3b.png}
-\end{figure}
-\FloatBarrier
+\end{center}
 
+\pagebreak
 \tutitem{Start the optimization} 
 Next page shows the generated script code. Modifications can be made if necessary, but leave it as it is for now.
 
-\FloatBarrier
-\begin{figure}[htb]
-\center
+\begin{center}
 \includegraphics[width=0.7\textwidth]{gfx/optimization/screenshot-opt4.png}
-\end{figure}
-\FloatBarrier
+\end{center}
 
-\newpage
-Go to the next page. From here the optimization can be executed:
+Now change to the "run" tab. From here the execution of the optimization can be monitored:
 
-\FloatBarrier
-\begin{figure}[htb]
-\center
+\begin{center}
 \includegraphics[width=0.7\textwidth]{gfx/optimization/screenshot-opt5a.png}
-\end{figure}
-\FloatBarrier
+\end{center}
+
+Click on \enquote{Start Optimization}. 
+
+\icon{0}{gfx/Hopsan-Optimize.png}{Start Optimization}
 
-Click on \enquote{Start Optimization}. During the optimization the objective function values and the values of the optimization parameters are shown for the different points. The best point is shown in green, and the worst in red.
+During the optimization the objective function values and the values of the optimization parameters are shown for the different points. The rows are sorted from best to worst. 
 
-\FloatBarrier
-\begin{figure}[htb]
-\center
+\begin{center}
 \includegraphics[width=0.7\textwidth]{gfx/optimization/screenshot-opt5b.png}
-\end{figure}
-\FloatBarrier
+\end{center}
 
-\newpage
 \tutitem{Evaluate the results} 
 Once the optimization has finished, we can evaluate the results. Parameters from a point can be written back to the original model by using the \enquote{Apply} buttons. 
 
-\FloatBarrier
-\begin{figure}[htb]
-\center
+\begin{center}
 \includegraphics[width=0.7\textwidth]{gfx/optimization/screenshot-opt5c.png}
-\end{figure}
-\FloatBarrier
+\end{center}
 
 Click the \enquote{Apply} button for the point with green text (the best point). Then go back to the original model and click the Simulate button again.
 
@@ -178,7 +163,7 @@ \section*{Optimizing from script files}
 Click on Save script file in the dialog.
 
 \tutitem{Loading a script file} 
-To load a previously saved script file, click on Load script file in the dialog. You will be taken directly to the code tab. Go to the last tab and start the optimization as before. Note that the settings on the first three pages are not updated by the script. Going back to these might re-generate the script and overwrite the loaded code.
+To load a previously saved script file, click on Load script file in the dialog. You will be taken directly to the code tab. Go to the "run" tab and start the optimization as before. Note that the settings on the first three pages are not updated by the script. Running the wizard again will re-generate the script and overwrite the loaded code.
 
 \tutitem{Loading a script file from command terminal} 
 It is also possible to load a script file from the command terminal. Just write \enquote{exec} followed by the path to the file. Hopsan will automatically understand that this is an optimization script and start the dialog. You can use \enquote{pwd} to show current directory and \enquote{cd} to change directory if necessary. Example: \texttt{>{}> exec ..\textbackslash folder\textbackslash myscript.hcom}