Export a top-level library to Shared Libraries

You can move a library to Shared Libraries by using the Export Library and Import Library functions. This ensures that all models used or referenced by models in this library are also transfered to Shared Libraries.

Export Libraries

The export mechanism is provided by the Tree View. Right-click on the library you wish to export and choose Export Library... to start the export process.

Only top-level libraries can be exported.

The export process in detail

  1. A check is performed to find library dependencies.
  2. A subsequent check is performed on the library and its dependencies to find inconsistencies with the model database. These inconsistencies originate from physically altering models, that is, renaming them or moving them to different locations.
  3. When inconsistencies with the model database were detected you will be prompted to resolve them.

    Be aware that resolving these inconsistencies is important to ensure that the exported libraries are working on other MLDesigner installations.

  4. In case the models you try to export contain construction errors the resolve process is canceled. Construction errors have to be solved manually in order to guarantee a successful export.
  5. When all required models are consistent or the resolve process was canceled the Export Library dialog appears.
  6. The Export Library dialog presents you with the libraries which will be exported. You may choose whether or not to export any dependent libraries by using the check mark in front of a library.
  7. You can define a different directory in which the created archive (.mar.gz) will be placed. Make sure you have read/write access to this directory.

Protecting Intellectual Property

Intellectual property can be protected if needed. You can do this by clearing the check mark for Include *.pl Files and adding a check mark to Include *.o Files, in the Export Library dialog. This ensures that only compiled object files are exported to the archive. Note that precompiled systems are platform dependent. It is not possible to export precompiled objects and execute the simulation on another platform. To do this the entire library must be recompiled after being exported and imported again.

With extremely large systems the size of the archive could be an inhibiting factor. To reduce the size of the archive exclude the .htm online documentation and the .o files.

Import Libraries

The Import Library option is only available on the model bases My Libraries and Shared Libraries in the Tree view.

Ensure that all models used by systems in the top level library are stored in that library. If this is not the case the library that contains the model or the model itself must also be exported to the shared library. If the model is exported to the library the reference to it must be changed by re-instantiating the model in the relevant system.

To import .mar.gz archives right-click on My Libraries or Shared Libraries and choose Import Library. The Import Library dialog allows selection of mar and tar archives in the formats .mar, .tar, .mar.gz, .tar.gz and .tgz. The extracted contents of the archive will appear as a top level library in the Tree View.