class Version_3_1 "Version 3.1 (August 14, 2009)"
extends Modelica.Icons.ReleaseNotes;
annotation (Documentation(info = "<html>\n\n<p>\nVersion 3.1 is backward compatible to version 3.0 and 3.0.1,\ni.e., models developed with version 3.0 or 3.0.1 will work without any\nchanges also with version 3.1.\n</p>\n\n<p>\nVersion 3.1 is slightly based on the Modelica Specification 3.1. It uses\nthe following new language elements (compared to Modelica Specification 3.0):\n</p>\n\n<ul>\n<li> Prefix <u>stream</u> and built-in operators <u>inStream(..)</u>\n and <u>actualStream(..)</u> in Modelica.Fluid.</li>\n<li> Annotation <u>connectorSizing</u> in Modelica.Fluid.</li>\n<li> Annotation <u>inverse</u> in Modelica.Media.</li>\n<li> Annotations <u>versionBuild</u>, <u>dateModified</u>,\n <u>revisionId</u> at the root level annotation of package Modelica,\n to improve the version handling.</li>\n<li> Modifiers can be used in connectors instances (so balanced models\n are less restrictive). This allowed to make the implementation\n of conditional connectors (support and heatPort) in the Rotational,\n Translational and Electrical libraries simpler.</li>\n</ul>\n\n<p>\nThe following <font color=\"blue\"><strong>new libraries</strong></font> have been added:\n</p>\n<table border=\"1\" cellspacing=0 cellpadding=2>\n<tr><td><a href=\"modelica://Modelica.Fluid\">Modelica.Fluid</a></td>\n <td>\n Components to model 1-dim. thermo-fluid flow in networks of vessels, pipes,\n fluid machines, valves and fittings. All media from the\n Modelica.Media library can be used (so incompressible or compressible,\n single or multiple substance, one or two phase medium).\n The library is using the stream-concept from Modelica Specification 3.1.\n </td></tr>\n\n<tr><td><a href=\"modelica://Modelica.Magnetic.FluxTubes\">Modelica.Magnetic.FluxTubes</a></td>\n <td>\n Components to model magnetic devices based on the magnetic flux tubes concepts.\n Especially to model\n electro-magnetic actuators. Nonlinear shape, force, leakage, and\n Material models. Material data for steel, electric sheet, pure iron,\n Cobalt iron, Nickel iron, NdFeB, Sm2Co17, and more.\n </td></tr>\n\n<tr><td><a href=\"modelica://ModelicaServices\">ModelicaServices</a></td>\n <td>\n New top level package that shall contain functions and models to be used in the\n Modelica Standard Library that requires a tool specific implementation.\n ModelicaServices is then used in the Modelica package.\n In this first version, the 3-dim. animation with model Modelica.Mechanics.MultiBody.Visualizers.Advanced.Shape\n was moved to ModelicaServices. Tool vendors can now provide their own implementation\n of the animation.\n </td></tr>\n</table>\n\n<p><br>\nThe following <font color=\"blue\"><strong>new components</strong></font> have been added\nto <font color=\"blue\"><strong>existing</strong></font> libraries:\n</p>\n\n<table border=\"1\" cellspacing=0 cellpadding=2 style=\"border-collapse:collapse;\">\n<tr><td colspan=\"2\"><strong>Modelica.</strong></td></tr>\n<tr><td> versionBuild<br>versionDate<br>dateModified<br>revisionId </td>\n <td> New annotations from Modelica 3.1 for version handling added.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.UsersGuide.ReleaseNotes.</strong></td></tr>\n<tr><td> VersionManagement </td>\n <td> Copied from info layer of previous ReleaseNotes (to make it more\n visible) and adapted it to the new possibilities in\n Modelica Specification 3.1.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Blocks.Math.</strong></td></tr>\n<tr><td> RectangularToPolar<br>\n PolarToRectangular </td>\n <td> New blocks to convert between rectangular and polar form\n of space phasors.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Blocks.Routing.</strong></td></tr>\n<tr><td> Replicator </td>\n <td> New block to replicate an input signal to many output signals.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Electrical.Analog.Examples.</strong></td></tr>\n<tr><td> AmplifierWithOpAmpDetailed<br>\n HeatingResistor<br>\n CompareTransformers<br>\n OvervoltageProtection<br>\n ControlledSwitchWithArc<br>\n SwitchWithArc<br>\n ThyristorBehaviourTest</td>\n <td> New examples to demonstrate the usage of new components.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Electrical.Analog.Basic.</strong></td></tr>\n<tr><td> OpAmpDetailed<br>\n TranslationalEMF<br>\n M_Transformer</td>\n <td> New detailed model of an operational amplifier.<br>\n New electromotoric force from electrical energy into mechanical translational energy.<br>\n Generic transformer with choosable number of inductors</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Electrical.Analog.Ideal.</strong></td></tr>\n<tr><td> OpenerWithArc<br>\n CloserWithArc<br>\n ControlledOpenerWithArc<br>\n ControlledCloserWithArc</td>\n <td> New switches with simple arc model.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Electrical.Analog.Interfaces.</strong></td></tr>\n<tr><td> ConditionalHeatPort</td>\n <td> New partial model to add a conditional HeatPort to\n an electrical component.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Electrical.Analog.Lines.</strong></td></tr>\n<tr><td> M_Oline</td>\n <td> New multiple line model, both the number of lines and the number of segments choosable.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Electrical.Analog.Semiconductors.</strong></td></tr>\n<tr><td> ZDiode<br>Thyristor</td>\n <td> Zener Diode with 3 working areas and simple thyristor model.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Electrical.MultiPhase.Ideal.</strong></td></tr>\n<tr><td> OpenerWithArc<br>CloserWithArc</td>\n <td> New switches with simple arc model (as in Modelica.Electrical.Analog.Ideal.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Mechanics.MultiBody.Examples.Elementary.</strong></td></tr>\n<tr><td> RollingWheel<br>\n RollingWheelSetDriving<br>\n RollingWheelSetPulling</td>\n <td> New examples to demonstrate the usage of new components.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Mechanics.MultiBody.Joints.</strong></td></tr>\n<tr><td> RollingWheel<br>\n RollingWheelSet</td>\n <td> New joints (no mass, no inertia) that describe an\n ideal rolling wheel and a ideal rolling wheel set consisting\n of two wheels rolling on the plane z=0.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Mechanics.MultiBody.Parts.</strong></td></tr>\n<tr><td> RollingWheel<br>\n RollingWheelSet</td>\n <td> New ideal rolling wheel and ideal rolling wheel set consisting\n of two wheels rolling on the plane z=0.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Mechanics.MultiBody.Visualizers.</strong></td></tr>\n<tr><td> Ground</td>\n <td> New model to visualize the ground (box at z=0).</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Mechanics.Rotational.Interfaces.</strong></td></tr>\n<tr><td> PartialElementaryOneFlangeAndSupport2<br>\n PartialElementaryTwoFlangesAndSupport2</td>\n <td> New partial model with one and two flanges and the support flange\n with a much simpler implementation as previously.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Mechanics.Translational.Interfaces.</strong></td></tr>\n<tr><td> PartialElementaryOneFlangeAndSupport2<br>\n PartialElementaryTwoFlangesAndSupport2</td>\n <td> New partial model with one and two flanges and the support flange\n with a much simpler implementation as previously.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Media.IdealGases.Common.MixtureGasNasa.</strong></td></tr>\n<tr><td> setSmoothState</td>\n <td> Return thermodynamic state so that it smoothly approximates:\n if x > 0 then state_a else state_b.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Utilities.Internal.</strong></td></tr>\n<tr><td> PartialModelicaServices</td>\n <td> New package containing the interface description of\n models and functions that require a tool dependent\n implementation (currently only \"Shape\" for 3-dim. animation,\n but will be extended in the future)</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Thermal.HeatTransfer.Components.</strong></td></tr>\n<tr><td> ThermalCollector</td>\n <td> New auxiliary model to collect the heat flows\n from m heatports to a single heatport;\n useful for multiphase resistors (with heatports)\n as a junction of the m heatports.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Icons.</strong></td></tr>\n<tr><td> VariantLibrary<br>\n BaseClassLibrary<br>\n ObsoleteModel</td>\n <td> New icons (VariantLibrary and BaseClassLibrary have been moved\n from Modelica_Fluid.Icons to this place).</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.SIunits.</strong></td></tr>\n<tr><td> ElectricalForceConstant </td>\n <td> New type added (#190).</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.SIunits.Conversions.</strong></td></tr>\n<tr><td> from_Hz<br>\n to_Hz</td>\n <td> New functions to convert between frequency [Hz] and\n angular velocity [1/s]. (#156) </td></tr>\n\n</table>\n\n<p><br>\nThe following <font color=\"blue\"><strong>existing components</strong></font>\nhave been <font color=\"blue\"><strong>improved</strong></font> in a\n<font color=\"blue\"><strong>backward compatible</strong></font> way:\n</p>\n\n<table border=\"1\" cellspacing=0 cellpadding=2 style=\"border-collapse:collapse;\">\n<tr><td colspan=\"2\"><strong>Modelica.</strong></td></tr>\n<tr><td> Blocks<br>Mechanics<br>StateGraph </td>\n <td> Provided missing parameter values for examples\n (these parameters had only start values)</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Electrical.Analog.Basic</strong></td></tr>\n<tr><td> Resistor, Conductor, VariableResistor, VariableConductor</td>\n <td> Conditional heatport added for coupling to thermal network.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Electrical.Analog.Ideal</strong></td></tr>\n<tr><td> Thyristors, Switches, IdealDiode</td>\n <td> Conditional heatport added for coupling to thermal network.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Electrical.Analog.Semiconductors</strong></td></tr>\n<tr><td> Diode, ZDiode, PMOS, NMOS, NPN, PNP</td>\n <td> Conditional heatport added for coupling to thermal network.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Electrical.MultiPhase.Basic</strong></td></tr>\n<tr><td> Resistor, Conductor, VariableResistor, VariableConductor</td>\n <td> Conditional heatport added for coupling to thermal network (as in Modelica.Electrical.Analog).</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Electrical.MultiPhase.Ideal</strong></td></tr>\n<tr><td> Thyristors, Switches, IdealDiode</td>\n <td> Conditional heatport added for coupling to thermal network (as in Modelica.Electrical.Analog).</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Mechanics.MultiBody.Visualizers.Advanced.</strong></td></tr>\n<tr><td> Shape </td>\n <td> New implementation by inheriting from ModelicaServices. This allows a\n tool vendor to provide its own implementation of Shape.</td></tr>\n<tr><td colspan=\"2\"><strong>Modelica.StateGraph.</strong></td></tr>\n<tr><td> Examples </td>\n <td> Introduced \"StateGraphRoot\" on the top level of all example models.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.StateGraph.Interfaces.</strong></td></tr>\n<tr><td> StateGraphRoot<br>PartialCompositeStep<br>CompositeStepState </td>\n <td> Replaced the wrong Modelica code \"flow output Real xxx\"\n by \"Real dummy; flow Real xxx;\".\n As a side effect, several \"blocks\" had to be changed to \"models\".</td></tr>\n<tr><td> PartialStep </td>\n <td> Changed model by packing the protected outer connector in to a model.\n Otherwise, there might be differences in the sign of the flow variable\n in Modelica 3.0 and 3.1.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Utilities.Examples.</strong></td></tr>\n<tr><td> expression </td>\n <td> Changed local variable \"operator\" to \"opString\" since \"operator\"\n is a reserved keyword in Modelica 3.1 </td></tr>\n</table>\n\n<p><br>\nThe following <font color=\"red\"><strong>uncritical errors</strong></font> have been fixed (i.e., errors\nthat do <font color=\"red\"><strong>not</strong></font> lead to wrong simulation results, but, e.g.,\nunits are wrong or errors in documentation):\n</p>\n<table border=\"1\" cellspacing=0 cellpadding=2 style=\"border-collapse:collapse;\">\n<tr><td colspan=\"2\"><strong>Modelica.</strong></td></tr>\n<tr><td> Many models</td>\n <td> Removed wrong usages of annotations fillColor and fillPattern\n in text annotations (#155, #185).</td></tr>\n<tr><td colspan=\"2\"><strong>Modelica.Electrical.Machines</strong></td></tr>\n<tr><td> All machine models</td>\n <td> The conditional heatports of the instantiated resistors\n (which are new in Modelica.Electrical.Analog and Modelica.Electrical.MultiPhase)\n are finally switched off until a thermal connector design for machines is implemented.</td></tr>\n\n<tr><td colspan=\"2\"><strong>Modelica.Media.Air.MoistAir</strong></td></tr>\n<tr><td> saturationPressureLiquid<br>\n sublimationPressureIce<br>\n saturationPressure</td>\n <td> For these three functions, an error in the <code>derivative</code> annotation was corrected. However, the effect of\n this bug was minor, as a Modelica tool was allowed to compute derivatives automatically via\n the <code>smoothOrder</code> annotation.</td>\n</tr>\n<tr><td colspan=\"2\"><strong>Modelica.Math.Matrices.</strong></td></tr>\n<tr><td> eigenValues</td>\n <td> Wrong documentation corrected (#162)</td></tr>\n</table>\n\n</html>"));
end Version_3_1;