Opening a Dymola Behavior Library

You can open a selection of libraries from the action bar, or use the Search bar to load a library stored in the database.

Notes:
  • You can select what libraries to open by default when opening Dymola Behavior Modeling. See Selecting Favorite Libraries.
  • You can specify locations where to look for the file corresponding to a library if it is not found by default when applying a library opening command from the action bar. You specify the locations from Me > Preferences > App Preferences > 3D Modeling > Systems Modeling and Execution > Dymola Behavior Modeling , the Libraries tab, the preference Additional 3DXML´s location. For more information, see Libraries.
  • In most case, administrators install libraries. See Administration Tasks: Installing 3D XML Modelica Libraries.

This task shows you how to:

Access from the Action Bar

You can access a selection of libraries. You have one flyout for free libraries and for commercial libraries providing both models and tools, and one flyout for commercial libraries providing only models.

Note: Only the libraries you have licenses for are displayed in the flyouts.
Important: Only a selection of libraries are accessible from the action bar. If an available library is not accessible from the action bar, use search to open it. See next task.

  1. Depending if you want to open a free or a commercial library:
    • To open a free library, from the Behavior Tools section of the action bar, display the free library flyout by clicking Modelica Free Libraries .

      A selection of free libraries appears.

      • Modelica Standard Library
      • Design
      • Dassault Systemes
      • Dymola Commands
      • Dymola Models
      • FTire
      • Modelica Device Drivers
      • Modelica LinearSystems2
      • Model Management
      • Modelica StateGraph2
      • Optimization
      • SDF
      • Testing
      • User Interaction
      • Vehicle Interfaces

    • To open a commercial library, from the Behavior Tools section of the action bar, display the commercial library flyout by clicking Commercial Modelica Libraries .

      A selection of commercial libraries appears. Below they appear in alphabetical order. This is not the case in the flyout.

      • Aviation Systems
      • Battery
      • Brushless DC Drives
      • ClaRa Plus
      • Cooling
      • Electric Power Systems
      • Electrified Powertrains
      • Flexible Bodies
      • Flight Dynamics
      • Fluid Dissipation
      • Fluid Dynamics
      • Fluid Power
      • Human Comfort
      • HVAC (Heating, Ventilation, and Air Conditioning)
      • Hydrogen
      • Pneumatic Systems
      • Power Train
      • Thermal Systems
      • VeSyMA (Vehicle Systems Modeling and Analysis)
      • VeSyMA - Engines
      • VeSyMA - Powertrain
      • VeSyMA - Suspensions
      • Wind Power
      • Visa2Base
      • Visa2Paper
      • Visa2Steam

  2. Select the convenient library.
    Depending on what versions of the library that are available in the database and as 3D XML files in the installation directories, there are a number of alternatives:
    • If the preferred version of the library, that is, the version delivered with the software, is available in the database, that version is loaded in session and appears in the Package Browser.
    • If no version is available in the database, but the preferred version is available as a 3D XML file in the installation directories, you are proposed to import and open that one.
    • If the database contains versions that are not the preferred version, but the preferred version is available as a 3D XML file, you can select to select from two alternatives:
      • To import the 3D XML file and open it, to get the preferred version, click Yes in the dialog box that appears.
      • To select another version than the preferred version, click No. The most resent version is opened from the database, but it is not the preferred version.
    • If the preferred version cannot be found, but there are other versions in the database, the most recent version is opened.
    • If you have already a version loaded in session, the library is seen as loaded, and the command has no effect.

Open with Search

You can open any Dymola behavior library using the Search field of the top bar, provided that the library is installed into the database and you have the convenient license.

Notes:

The result is displayed in a separate window.

For general information about search, see About 3DSearch Queries.

Before you begin: In this task, you want to search all Modelica libraries containing "m" in the name.
  1. In the Search field of the top bar, enter dbl:*m*, and click Search .

    Notes:
    • dbl stands for dynamic behavior library.
    • You must supply at least one character of the name, you cannot use only * (or dbl:*).

    The Search Results panel is displayed.
    Note: If you do several searches, they are kept in the session.
    Tips: If the library is not found, make sure that:
  2. In the Search Results panel, right-click the library and select Open .

    If you have a valid license, if needed, the selected Dymola behavior library is loaded in session and appears in the Package Browser.

    Tip: If you are recently recruited, and fail when you try to open a library with external licensing, it might be that you do not yet have the valid license. For handling such a case, see next task.
  3. To close the search, click Close.

If you need to move an open library, administrators can perform this. See Administration Tasks: Installing 3D XML Modelica Libraries.

Prepare Opening a Modelica Library with External Licensing for the First Time

Before opening a library with external licensing the first time, you must configure the licensing.

Before you begin:
  • The library is imported by another person, and available in the database. For importing, see Import a Modelica Library with External Licensing.
    Note: That person can open the library with the computer the person imported it with without the configuring below, but it is recommended to always do the below configuration.
  • You have access to an authorization file valid for you, with the file extension .mo_lic.
In this task, you prepare for opening the library MyXLib version 2.0 with a corresponding authorization file MyXLibAuthorization.mo_lic
  1. Create a folder location for the authorization files on your computer, for example, E:\MyExperiments\MyExternalLibraryLicenses.
  2. Given the name and version of the library, add a folder MyXLib 2.0 in E:\MyExperiments\MyExternalLibraryLicenses.

    Note: The folder must have the same name as the library including the library version.

  3. Insert the authorization file MyXLibAuthorization.mo_lic into this folder.
    The full file path for the authorization file is now E:\MyExperiments\MyExternalLibraryLicenses\MyXLib 2.0\MyXLibAuthorization.mo_lic.
  4. In the External licenses´location field from Me > Preferences > App Preferences > 3D Modeling > Systems Modeling and Execution > Dymola Behavior Modeling , the Libraries tab, enter E:\MyExperiments\MyExternalLibraryLicenses, or browse for this location.

    Note: Quotation marks " " are not used for the path in this preference.

    The configuration is complete. When you open the library, the path above is checked for an alternative authorization file in the following cases:
    • If it is the first time you open a library you did not import yourself with this computer.
    • If the resources contain no authorization file for the library.
    • If the authorization file for the library in the resources is invalid.

    If the file in this configured path is valid, the library is opened.

    You can open the library with search according to the task above.

  5. To add authorization files for other externally licensed libraries, add them in the present structure E:\MyExperiments\MyExternalLibraryLicenses.

    For example, the structure for the authorization file MyYLibAuthorization.mo_lic for the library MyYLib version 1.2 is E:\MyExperiments\MyExternalLibraryLicenses\MyYLib 1.2\MyYLibAuthorization.mo_lic.