class Cases "Cases"
extends Modelica.Icons.Information;
annotation (Documentation(info = "<html>\n\n<p>In the Modelica documentation sometimes different cases have to be distinguished. If the case distinction refers to Modelica parameters or variables (Boolean expressions) the comparisons should be written in the style of Modelica code within <code><code></code> and <code></code></code>\n</p>\n\n<h5>Example 1</h5>\n\n<code><p>If <code>useCage == true</code>, a damper cage is considered in the model...</p></code>\n\n<p>appears as</p>\n\n<p>If <code>useCage == true</code>, a damper cage is considered in the model...</p>\n\n<p>\nFor more complex case scenarios a unordered list should be used. In this case only Modelica specific code segments and Boolean expressions.\n</p>\n\n<h5>Example 2</h5>\n\n<pre>\n<ul>\n <li> If <code>useCage == true</code>, a damper cage is considered in the model.\n Cage parameters must be specified in this case.</li>\n <li> If <code>useCage == false</code>, the damper cage is omitted.</li>\n</ul></pre>\n\n<p>appears as</p>\n\n<ul>\n <li> If <code>useCage == true</code>, a damper cage is considered in the model.\n Cage parameters must be specified in this case.</li>\n <li> If <code>useCage == false</code>, the damper cage is omitted.</li>\n</ul>\n\n<p>\nIn a more equation oriented case additional equations or code segments can be added.\n</p>\n\n<h5>Example 3</h5>\n\n<pre>\n<ul>\n <li>if <code>usePolar == true</code>, assign magnitude and angle to output <br>\n <!-- insert graphical representation of equations -->\n y[i,1] = sqrt( a[i]^2 + b[i]^2 ) <br>\n y[i,2] = atan2( b[i], a[i] )\n </li>\n <li>if <code>usePolar == false</code>, assign cosine and sine to output <br>\n <!-- insert graphical representation of equations -->\n y[i,1] = a[i] <br>\n y[i,2] = b[i]\n </li>\n</ul></pre>\n\n<p>appears as</p>\n\n<ul>\n <li>if <code>usePolar == true</code>, assign magnitude and angle to output<br>\n\n <img src=\"modelica://Modelica/Resources/Images/UsersGuide/Conventions/Documentation/Format/Cases/y_i1_polar.png\"\n alt=\"y[i,1] = sqrt( a[i]^2 + b[i]^2 )\"><br>\n <img src=\"modelica://Modelica/Resources/Images/UsersGuide/Conventions/Documentation/Format/Cases/y_i2_polar.png\"\n alt=\"y[i,2] = atan2( b[i], a[i] )\">\n </li>\n <li>if <code>usePolar == false</code>, assign cosine and sine to output<br>\n <img src=\"modelica://Modelica/Resources/Images/UsersGuide/Conventions/Documentation/Format/Cases/y_i1_rect.png\"\n alt=\"y[i,1] = a[i]\"><br>\n <img src=\"modelica://Modelica/Resources/Images/UsersGuide/Conventions/Documentation/Format/Cases/y_i2_rect.png\"\n alt=\" y[i,2] = b[i]\">\n </li>\n</ul>\n\n</html>"));
end Cases;