Dymola Dynamic Modeling Laboratory Dymola Release Notes Dymola 2014 FD01
The information in this document is subject to change without notice. Document version: 1 © Copyright 1992-2013 by Dassault Systèmes AB. All rights reserved. Dymola® is a registered trademark of Dassault Systèmes AB. Modelica® is a registered trademark of the Modelica Association. Other product or brand names are trademarks or registered trademarks of their respective holders. Dassault Systèmes AB Ideon Science Park SE-223 70 Lund Sweden Support: URL: Phone: http://www.3ds.com/support http://www.Dymola.
Contents 1 2 3 Important notes on Dymola .................................................................................................... 5 About this booklet ................................................................................................................... 5 Dymola 2014 FD01 .................................................................................................................. 6 3.1 Introduction ...............................................................................
3.7 New libraries .................................................................................................................................................. 34 3.7.1 Fuel Cell Library .................................................................................................................................. 34 3.7.2 Heat Exchanger Library........................................................................................................................ 35 3.7.3 Modelica_DeviceDrivers .....
1 Installation on Windows Important notes on Dymola To translate models you must also install a supported Microsoft Visual Studio C++ compiler. The compiler is not distributed with Dymola. Note that free Microsoft compiler versions earlier than Microsoft Visual Studio Express 2008 are not supported (concerning full versions, some earlier versions are supported). Refer to section “Hardware requirements” on page 26 for more information. Administrator privileges are required for installation.
3 3.1 Dymola 2014 FD01 Introduction 3.1.1 Additions and improvements in Dymola A number of improvements and additions have been implemented in Dymola 2014 FD01. In particular, Dymola 2014 FD01 provides • Support for the new version 3.2.1 of the Modelica Standard Library (MSL). The new version is included in the distribution as the default MSL version (page 8). • Full Modelica compliance (page 8). • Extended FMI support (page 29). o FMU import on Linux. o Support of FMI 2.
3.1.2 New and updated libraries New libraries The following libraries are new: • Fuel Cell Library, version 1.2. • Heat Exchanger Library, version 1.0.1. • Modelica_DeviceDrivers, version 1.2. • Vapor Cycle Library, version 1.0. For more information about the new libraries, please see section “New libraries” starting on page 34. Updated libraries The following libraries have been updated: • Modelica Standard Library, version 3.2.1. • Air Conditioning Library, version 1.8.6.
However, we provide them to you as early as possible in order for you learn about these features, plan for later use, and be able to give us your feedback. You typically need to set some switch to enable them. These features are planned to become Generally Available (GA) in the Dymola 2015 release. The LA features are briefly described below and are marked (LA). 3.2 Developing a model 3.2.
3.2.3 Improved presentation of check messages The messages displayed in the Translation tab of the messages window are improved. See “Filtering of messages” on page 15. 3.2.4 Hiding graphical connections In Dymola 2014 FD01 the user can easily use the context menu to hide graphical connections, improving the display of the diagram layer. To use this feature, the user must set the flag Advanced.InvisibleConnections=true.
Hidden graphical connections can easily be displayed by setting Show hidden graphical objects reached by the command Edit > Options…, in the Appearance tab. By default such objects are hidden. Accidental hiding is corrected using Edit > Undo (Ctrl+Z).
3.2.5 Selected commands (built-in functions) available from the package browser In Dymola 2014 FD01 selected commands (built-in functions) can be made available from the package browser or be reached by the context command Insert Function Call…. This enables convenient use in the Modelica Text editor by drag-and-drop. To load the commands in the package browser, import the package DymolaCommands by typing import DymolaCommands in the command input line of the Commands window.
3.2.7 Minor improvements Semi-transparent icons in dragging operations from package browser When dragging classes from the package browser, the icons are now semi-transparent, to avoid hiding, e.g., text when dragging to the Modelica Text editor.
3.3 Simulating a model 3.3.1 Improved presentation of translation messages The display and content of messages generated during translation has been improved. This information is displayed in the Translation tab of the messages window. Number of errors, warnings and messages displayed In Dymola 2014 FD01 the number of errors, warnings and messages are always displayed at the top of the messages window.
Filtering of messages In Dymola 2014 FD01, messages can be filtered using three buttons. The above image shows all messages being presented. By clicking on the buttons the user can select what type of messages to filter. The picture below shows only warnings (compare with previous figure): Note that the parent icons are also included since they contain warnings.
Presentation of selected default conditions and selected continuous-time states Selected default conditions and selected continuous-time states are presented by default. The default setting of this window will display the following after translation of the demo Motor Drive (File > Demos > Motor Drive).
Clear log The Translation tab can be erased by clicking the Clear button to the right in the header. 3.3.2 Opening of result files by drag-and-drop or double-clicking supported You can open a .mat file (result file or Matlab file) either by dragging it into the Dymola main window, or by double-clicking it. To use double-clicking, .mat files must be associated to Dymola. Dymola will enter Simulation mode when performing any of these actions.
3.3.3 Plot window Signal operators: additions and improvements Second and higher-order harmonics available as signal operator Second and higher-order harmonics are available using the built-in function plotSignalOperatorHarmonic, by giving the input parameter harmonicNo values larger than 1 (1 correspond to first harmonic). Multiple select on plot curves In Dymola 2014 FD01 it is possible to select more than one curve in a plot window.
3.3.4 Animation window Improved rendering of surfaces in animation In Dymola 2014 FD01, the support for color fields of surfaces in animation has been improved. Furthermore, the smoothness of surfaces is also better rendered. This will improve e. g. presentation and animation of temperature and pressure in the Power Train library.
3.3.5 Scripting A new Modelica script editor A new Modelica script editor is available in Dymola 2014 FD01.
The commands Simulation > Commands > New Script or Simulation > Commands > Open Script… will open the script editor. The commands are also available as selections from the Run Script button: Handling several scripts in the script editor Several scripts can be open simultaneously. They will be displayed as tabs in the script editor. Below four scripts are present in the script editor.
The commands for editing correspond to the commands in the Modelica Text editor. Tracing Function calls, variables in functions and global variables can be traced when executing the script. Tracing of global variables is always accessible by right-clicking the script editor and selecting Trace > Trace Global Variables.
The trace output is displayed in the command log. Executing a script from the script editor The active script can be executed by clicking the Run Script button in the header of the script editor. Executing a selected part of a script Right-clicking a selected part of a script, enables the command Run Selection. This command will execute the selected part of the script as would it be a separate script.
Simulation events available for plotting In Dymola 2014 FD01 simulation events are available in the simulation results by ticking the setting Include a variable for elapsed CPU time during simulation. The setting is available by the command Simulation > Setup…, the Translation tab.
3.4.2 New command line argument available for license handling A new command line argument is available in Windows and Linux for controlling • When Dymola should start to warn that the license will be expiring. • If Dymola should start in Demo mode if the license is not found or invalid.
The default is that Dymola start to warn 30 days before the license is expiring, and starts in demo mode if the license is not found or invalid. Consider a user wanting to have the first warning 5 days before the license is expiring, and wanting to terminate Dymola if the license is not found or invalid.
Compilers Please note that for the Windows platform, a Microsoft C/C++ compiler must be installed separately. The following compilers are supported for Dymola 2014 FD01 on Windows: Free editions: • Visual Studio 2008 Express Edition (9.0) • Visual C++ 2010 Express (10.0) • Visual Studio 2012 Express Edition (11.0) Professional editions: • Visual Studio 2005 (8.0) • Visual Studio 2008 (9.0) • Visual Studio 2010 (10.0) • Visual Studio 2012 (11.
3.5 Other Simulation Environments 3.5.1 Dymola – Matlab interface Compatibility The Dymola – Simulink interface now supports Matlab releases from R2008a (ver. 7.6) up to R2013a (ver. 8.1). Only Visual Studio C++ compilers are supported to generate the DymolaBlock S-function. The LCC compiler is not supported. 3.5.
Compatibility – xPC Target Compatibility with Matlab xPC Target has been verified for all Matlab releases that are supported by the Dymola – Simulink interface, which means R2008a (xPC Target ver. 3.4) to R2013a (xPC Target ver. 5.4). Only Microsoft Visual C compilers have been tested. 3.5.3 FMI Support in Dymola FMU import on Linux supported for FMI FMU import on Linux is now supported for FMI, both Model Exchange and Co-Simulation.
The option is by default not applied. Structured declaration of variables To be able to use this option, the attribute variableNamingConvention in the model description file of the FMU to be imported must be set to variableNamingConvention="structured". By ticking this option the variables of the imported FMU will be presented in a hierarchical structure (using record declarations). This is useful when e.g. wanting to change parameter values or access variables in the variable browser after a simulation.
Note that even if the option 64-bit binaries is selected, no such binaries are created unless 64-bit compilation is enabled. In a 32-bit version of Dymola, this can be enabled by setting the flag Advanced.CompileWith64=2; The selection of binaries is disabled on Linux, where only 32-bit binaries are supported.
Fixed-step embedded solvers supported for FMU Co-Simulation export The Dymola inline integration solvers are now supported also for FMU Co-Simulation export. Note that the fixed step-size used for the inline integration should also be used as step-size when calling the fmiDoStep routine of the generated FMU. For source code export it is also required to set the flag #define ONLY_INCLUDE_INLINE_INTEGRATION in the header file conf.h. Support for FMI 2.
By ticking this option, the solver that is selected in Dymola will also be used by the exported FMU. Minor improvements for FMI version 1.0 • Exported FMUs from Dymola support intermediate results for event update (fmiEventUpdate) in FMI 1.0 Model Exchange. • ASCII characters of values larger than 32 are now supported by the FMU import.
3.6 Advanced Modelica Support 3.6.1 New Java interface for Dymola (LA) A new Java interface for Dymola is available in Dymola 2014 FD01, containing a number of functions to perform operations such as simulating, setting variables, plotting, and exporting data. For more information about this feature, please see the document “Introduction to the Java interface for Dymola.pdf” available in the distribution, in Program Files (x86)\Dymola 2014 FD01\Documentation.
• • • • • Solid oxide fuel cells (SOFC) and Proton exchange membrane fuel cells (PEMFC) in the same tool. Predefined reactors for fuel pre-processing and internal stack reforming. Reactions calculated by various approaches. Handles reformate and other ideal gas mixtures. Support for condensation. The library demands a license. 3.7.2 Heat Exchanger Library The new Heat Exchanger Library is targeted to heat exchanger design, dimensioning and stacking.
3.7.4 Vapor Cycle Library The Vapor Cycle Library is targeted at thermodynamic systems that include a phase change of the working fluid, such as vapor compression cycles and organic rankine cycles. It is suitable for a wide range of applications in among others automotive, industrial equipment, and process industry. Applications include mobile and residential air conditioning, industrial refrigeration as well as heat pump systems.
• • • • A wide range of working fluids. Two- and one-phase fluid flow with a choice of different heat transfer and pressure loss correlations that also covers phase change. Ready-to use component models with example parameterization as well as interfaces and templates for user-specific modifications. System examples that demonstrate the use of the library.
Note! If the new version MSL 3.2.1 should be used as default version when opening models that are presently using MSL 3.2 or older, do the following: • Apply the command Edit > Options…, select the Versions tab, select Modelica version 3.2.1 and tick Force upgrade of models to this version. • Save the above setting by selecting the tab Save Settings, tick Default Modelica version, and click OK to save the default version. Note! New initialization rules are applied.
3.8.5 Flexible Bodies Library In the new version 2.1 a new subpackage ./MovingLoad has been introduced in which extended versions of the Beam and ModalBody class are presented. They provide the capability of representing flexible bodies to which moving non-inertial or inertial loads are attached, i. e. the load attachment point of the load forces is not constant but may change during simulation. 3.8.6 Hydraulics Library A minor version 3.3.3 has been released. Some features compared with the version 3.3.
• • • • • Volume components with any number of connectors, utilizing vectorized connectors and automatic sizing, have been introduced. Improved numerical robustness and simulation performance when using aqueous solutions. Static head can be accounted for by the generic pipe models and geometric models of straight pipes. Added an experiment template model that defines a replaceable medium model, an aggregate volume component and experiment icon.
3.8.15 Smart Electric Drives Library A minor version 1.4.4 has been released. Some features compared with the version 1.4.2 in previous Dymola release: • Changed initialization of some blocks (version 1.4.3). • Applied fixed parameter values to some drive models and examples for Modelica compatibility. 3.8.16 Thermal Power Library Version 1.7 is a major update of the library. Some examples of improvements: • • • Restructuring of DynamicPipe_lumpedP twophase model.
3.9 Documentation In the software distribution of Dymola 2014 FD01 Dymola User Manuals of version “September 2013” will be present; these manuals include all relevant features/improvements of Dymola 2014 FD01 presented in the Release notes. Limited Availability (LA) features are not included, except some limited documentation of FMI 2.0 RC1.
