Pneumatics Library - Release Information

Release Notes for Pneumatics Library 2.3

Pneumatics Library 2.3 is part of Modelon’s 2017.2 release. 

New versions of Modelon libraries are sold and distributed directly from Modelon, as well as approved resellers.

New features

  • Added more gases to choose from in the RealGas model. Both RealGas and IdealGas model now offers Nitrogen, Oxygen, Argon, Carbon dioxide, dry air and moist air.

Improvements

  • Updated heat exchanger with respect to new parameterization in Modelon Base Library.

Fixed issues

  • In Modelon Base Library a bug fix was made to the RealGas model, which caused slight deviations at low temperatures and high pressures.

Conversion of user libraries

Automatic conversion of user libraries from version 2.2 is supported using the included conversion script ConvertPneumatics_from_2.2_to_2.3 located under Pneumatics 2.3\Scripts.

Requirements

Pneumatics 2.2 is based on Modelon Base Library 3.0 and Modelica Standard Library 3.2.2.

Version 2.2 was release 2017-06-02.

Examples of improvements and new features:

  • Example package involving air suspension systems is added. The air suspension components as well as system models involving developed components are made available to the user.
  • New fitting components based on the 3-K (Darby) method. This includes loss coefficients for 33 different bends (for different angles), valves and tees. In addition to this, a simpler 1-K tee is also available.
  • Reservoir will no longer have volume-volume connection inside
  • MultiPositionCylinder example no longer have volume-volume connections
  • The gases documentation is made to clarify the assumptions about inflowing enthalpy to volumes. The stop_h_outflow parameter in Constant gas model was also removed from GUI to avoid confusion, it is now always true.
  • Enhanced parameterization option for Bellows model. Effective area and volume can be specified by table. Added bellows material damping as well.


Conversion of user libraries:
Automatic conversion of user libraries from version 2.1 is supported using the included conversion script.

Version 2.1 contains the changes described below.

New features

  • Five new Heat Exchangers, two new Turbines and three new Compressors that can be used in ThermoPneumatic applications. The new sub-package ThermoFluid includes off-the-shelf wrapped components from ThermoFluid in Modelon Base Library in order to get Pneumatic ports. This package also includes a tutorial and utilities to wrap any other component from Modelon.ThermoFluid.

Improvements

  • The ideal gas assumption built into equations of some of the models has been made more generic so that they are compliant with ideal as well as real gases. Models have been made to use variable specific heat capacities.
  • Mass flow rate in the ports has changed name from mdot to m_flow.
  • Added noEvent() to all actualStream operator in the volume models.
  • Improved robustness of the example models in Elements.Examples.
  • Parameters changed in Pneumatics.Elements.Examples.PilotCheckValveCircuit so that results of the model are proper

Library structure changes

New classes

  • Pneumatics.ThermoFluid

Obsolete classes

Obsolete classes are placed in the package Utilities.Deprecated and will be removed after a year from the release when they were put in the deprecated package.

Conversion of user libraries

The flow variable in the connector changed name from m_dot to m_flow. The conversion script handle the conversion when modifiers is applied on m_dot, but not when it is present in equations. This has to be changed manually.

Automatic conversion of user libraries from version 2.0 is supported using the included conversion script ConvertPneumatics_from_2.0_to_2.1 located under Pneumatics 2.1\Scripts.

Requirements

Pneumatics 2.1 is based on Modelon Base Library 2.5 and Modelica Standard Library 3.2.2.

Version 2.0 contains the changes described below.

New features

  • ThermoPneumatics Conditionally enables energy balance equation and enthalpy flow between components.
  • Pneumatics Library is now shipped with Modelon Base Library. Pneumatics uses media interfaces from MBL.
  • Real gas model is available. Instant switching between ideal and real gas model and comparison of the compressibility factor.
  • Several new predefined ideal-gas fluids: Argon, Oxygen, Nitrogen, dry air, moist air and CO2.
  • Pneumatic brake booster and hydraulic brake system example model demonstrating FMI capabilities and multi-library capabilities.
  • Mass-components to Elements which are more flexible and an additional mass inside mass component.

Improvements

  • Significantly improved documentation with respect to Modelon's documentation guidelines. This includes a completely new Guide is written and example models are now well documented. All components visible in the first level of the sub-packages has documentation and each sub-package has an information class.
  • Pressure is now the state variable in Pneumatics, instead of mass.
  • The cylinder model DoubleActingCylinder has dead volumes included in the chamber model, reducing the number of state variables.
  • Compatible with both Modelica Standard Library 3.2.1 and 3.2.2.

Fixed issues

  • New protection level (nonPackageDuplicate) on the library to allow duplication of components and example.

Library structure changes

New classes

  • Pneumatics.Gases
  • Pneumatics.Examples.BrakeSystem
  • Pneumatics.Elements.MassInMass
  • Pneumatics.Sensors.TemperatureSensor
  • Pneumatics.Volumes.MultiPortVolume
  • Pneumatics.Volumes.MultiPortChamber
  • Pneumatics.Volumes.MultiPortIdealBellows

Renamed classes

Pneumatics contained duplicate classes from Modelon Base Library inside Pneumatics.Utilities. These classes are removed and the conversion scripts updates to the equivalent path inside Modelon Base Library.

Obsolete classes

Obsolete classes are placed in the package Utilities.Deprecated and will be removed after a year from the release when they were put in the deprecated package.

  • Pneumatics.Utilities.Deprecated.PartialFriction
  • Pneumatics.Utilities.Deprecated.Environment
  • Pneumatics.Elements.Deprecated.MassWithStopAndFriction
  • Pneumatics.Cylinders.Deprecated.DoubleActingCylinder

Conversion of user libraries

The introduction of ThermoPneumatics with the new pressure state may require manual changes if the mass variable have modifiers. Convertion script will only handle class name changes.

Automatic conversion of user libraries from version 1.8 is supported using the included conversion script ConvertPneumatics_from_1.8_to_2.0 located under Pneumatics 2.0\Scripts.

Requirements

Pneumatics 2.0 is based on Modelon Base Library 2.4 and Modelica Standard Library 3.2.2.

It has been tested with:

  • Dymola 2017
  • Dymola 2016 FD01

Version 1.8 contains the changes described below.

New features

  • The Pneumatics.Elements package provides necessary components required to build any pneumatic valve from scratch. The valves built using this package will be slightly of more detailed in nature than the existing functional valve models in Pneumatics library.
  • New component DCV_4_3: Directional control valve with four ports and three stable positions.

Improvements

  • Appropriate tabs and groups now exist for all top level components. Parameters that are typically affecting on system level can be found in the General tab. While detailed parameters for component design are found in the Advanced tab. There are separate tabs for Volumes, Initialization and Visualization parameters.

Fixed issues

  • Fixed a bug with the propagation of friction parameters in the Cylinder model.
  • Flags to enable aggregated properties and warnings are now correctly propagated.
  • LongLine aggregated properties are now calculated.

Library structure changes

New classes

  • Pneumatics.Elements (package)
  • Pneumatics.DirectionalControl.DCV_4_3
  • Pneumatics.DirectionalControl.Basic.Four_3_WayValveNoStates
  • Pneumatics.Utilities.Math (package)
  • Pneumatics.Interfaces.Port

Renamed classes

Obsolete classes

Obsolete classes are placed in the package Utilities.Deprecated and will be removed after a year from the release when they were put in the deprecated package.

Conversion of user libraries

Automatic conversion of user libraries from version 1.7 is supported using the included conversion script ConvertPneumatics_from_1.7_to_1.8 located under Pneumatics 1.8\Scripts.

Requirements

Pneumatics 1.8 is based on Modelica Standard Library 3.2.1.  

It has been tested with:

  • Dymola 2016 FD01
  • Dymola 2016

Version 1.7 contains the changes described below.

New features

  • Reduced number of cylinder models to one, DoubleActingCylinder. Replacing all the old cylinder models. The new cylinder models uses more numerically stable end stop and friction models, developed by Modelon as a complement to the models in Modelica Standard Library.
  • Added circle on the ports if the component has a volume or defined state.
  • Added new pressure drop components for many different geometries in Restrictions.FlowResistances.
  • Fixed a Interface/Template-basic structure throughout the library

Improvements

  • Tightened tolerances in many examples for cross platform compatibility.
  • Changed nominal value on mass flow rate in long line to 1e-6 and conductance 1e-7.
  • Added a SpringDamper to booster component for numerical stability reasons.
  • The environment component now uses the Pneumatic top level icon.
  •  Pneumatics is completely independent from the UserInteraction-library.

Fixed issues

Library structure changes

New classes

  • Pneumatics.Cylinders.DoubleActingCylinder
  • Pneumatics.Restrictions.FlowResistances
  • Pneumatics.Utilities.Mechanics
  • Pneumatics.Templates
  • Pneumatics.DirectionalControl.Basic.Templates
  • Pneumatics.Utilities.Visualizers.Functions.rgb

Renamed classes

  • Pneumatics.Cylinders.DoubleActingCylinder2Rods -> Pneumatics.Cylinders.DoubleActingCylinder
  • Pneumatics.Cylinders.DoubleActingCylinder2RodsCushion -> Pneumatics.Cylinders.DoubleActingCylinder
  • Pneumatics.Cylinders.DoubleActingCylinderRodA -> Pneumatics.Cylinders.DoubleActingCylinder
  • Pneumatics.Cylinders.DoubleActingCylinderRodACushion -> Pneumatics.Cylinders.DoubleActingCylinder
  • Pneumatics.Cylinders.DoubleActingCylinderRodB -> Pneumatics.Cylinders.DoubleActingCylinder
  • Pneumatics.Cylinders.DoubleActingCylinderRodBCushion -> Pneumatics.Cylinders.DoubleActingCylinder
  • Pneumatics.Valves.LinearResistance -> Pneumatics.Restrictions.LinearResistance
  • Pneumatics.Valves.Nozzle -> Pneumatics.Restrictions.Nozzle
  • Pneumatics.Valves.Orifice -> Pneumatics.Restrictions.Orifice
  • Pneumatics.Valves.Basic.LinearResistanceNoStates -> Pneumatics.Restrictions.Basic.LinearResistanceNoStates
  • Pneumatics.Valves.Basic.NozzleNoStates -> Pneumatics.Restrictions.Basic.NozzleNoStates
  • Pneumatics.Valves.Basic.OrificeNoStates -> Pneumatics.Restrictions.Basic.OrificeNoStates
  • Pneumatics.Cylinders.Basic.IdealBellows > Pneumatics.Volumes.IdealBellows
  • Pneumatics.Cylinders.Basic.IdealChamber -> Pneumatics.Volumes.Templates.Chamber
  • Pneumatics.Cylinders.Basic.IdealChamberIsotherm -> Pneumatics.Volumes.Templates.Chamber
  • Pneumatics.Cylinders.Basic.ChamberA -> Pneumatics.Volumes.Chamber
  • Pneumatics.Cylinders.Basic.ChamberB -> Pneumatics.Volumes.Chamber
  • Pneumatics.Cylinders.Basic.ChamberAIsotherm -> Pneumatics.Volumes.ChamberIsotherm
  • Pneumatics.Cylinders.Basic.ChamberBIsotherm -> Pneumatics.Volumes.ChamberIsotherm
  • Pneumatics.Cylinders.Basic.Cylinder2Massless -> Pneumatics.Utilities.Deprecated.Cylinder2Massless
  • Pneumatics.Examples.CylinderDrive -> Pneumatics.Utilities.Deprecated.CylinderDrive
  • Pneumatics.Examples.Tutorial -> Pneumatics.Utilities.Deprecated.Tutorial
  • Pneumatics.Cylinders.Basic.Stop_with_ini -> Pneumatics.Utilities.Deprecated.Stop_with_ini
  • Pneumatics.Interfaces.OnePortCompInput -> Pneumatics.Interfaces.OnePortInput
  • Pneumatics.Interfaces.OnePortCompOutput -> Pneumatics.Interfaces.OnePortOutput
  • Pneumatics.Interfaces.TwoPortComp -> Pneumatics.Templates.TwoPortComponent
  • Pneumatics.Interfaces.TwoPortSys -> Pneumatics.Interfaces.TwoPort
  • Pneumatics.DirectionalControl.Basic.FlowArea -> Pneumatics.DirectionalControl.Basic.Components.FlowArea
  • Pneumatics.Lines.Basic.LineEntrance -> Pneumatics.Utilities.Deprecated.LineEntrance
  • Pneumatics.Lines.Basic.LineExit -> Pneumatics.Lines.Basic.LineElement
  • Pneumatics.Lines.Basic.LineMiddle -> Pneumatics.Lines.Basic.LineElement
  • Pneumatics.Sources.Basic.IdealReservoirExtCom -> Pneumatics.Sources.Basic.IdealReservoir


Obsolete classes

Obsolete classes are placed in the package Utilities.Deprecated and will be removed after a year from the release when they were put in the deprecated package.

  • Pneumatics.Utilities.Deprecated.Cylinder2Massless
  • Pneumatics.Utilities.Deprecated.CylinderDrive
  • Pneumatics.Utilities.Deprecated.Tutorial
  • Pneumatics.Utilities.Deprecated.Stop_with_ini
  • Pneumatics.Utilities.Deprecated.LineEntrance

Conversion of user libraries

Automatic conversion of user libraries from version 1.6.3 is supported using the included conversion script ConvertPneumatics_from_1.6.3_to_1.7 located under Pneumatics 1.7\Scripts.

The conversion script does not handle some modifiers to the Cylinder-component. This has to be fixed manually. If you have any questions, please contact the support.

Requirements

Pneumatics 1.7 is based on Modelica Standard Library 3.2.1.  

It has been tested with:

  • Dymola 2016
  • Dymola 2015 FD01

Pneumatics 1.6.3 is a minor release with the following enhancements compared to 1.6.2.

Enhancements

  • The packages throughout the library are rearranged and restructured. Some packages are located inside Utilities and some top level packages are separated into two.
  • The library has a new top level icon.
  • Environment now have a new icon, displaying both pressure and temperature.
  • Aggregated mass and volume are now calculated within the environment component. Using the parameter "include_in_aggregate", the user can simply include or exclude a volume or chamber from the aggregated mass/volume.
  • The blue color in the library is now changed to "Modelon-blue"
  • Some components were old and deprecated. They are now placed in the package Utilities.Deprecated and will be removed after a year from the release when they were put in the deprecated package. These components are marked with a red cross and if they are used, a warning message will appear in the message log. If the user wants to keep using the component, it has to be copied to the local library. But they will no longer be supported by Modelon.

Fixes

  • All pedantic check errors are fixed throughout the library.
  • The white background in some components icon layer is removed.

Note

Conversion scripts will only support conversion from the previous release to the current release.

Some components were old and deprecated. They are now placed in the package Utilities.Deprecated and will be removed after a year from the release when they were put in the deprecated package.

The library runs under Modelica Standard Library 3.2.1

Conversion from release 1.6.2 to 1.6.3 is embedded.

2014-04-30

Available for: Dymola 2015

Dependencies: Modelica Standard Library Version: 3.2.1 and Modelon Base Library 2.0

Package browser menu updated graphically for consistency

The model Pneumatics.Cylinder.Basic.Stop is now obsolete. Use the MSL equivalent instead. 

 

Available for: Dymola 2014 FD01

Dependencies: Modelica Standard Library Version: 3.2.1 

 

  • Documentation inserted into the library as html from Modeling of Pneumatic Systems with corrections/modifications in some existing component information.
  • Minor bug fixes and some library additions, like mass flow rate source.