Revision Control Support for Models and Libraries - MapleSim Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : MapleSim : Using MapleSim : Building a Model : Revision Control Support : Revision Control Support for Models and Libraries

Revision Control Support for Models and Libraries

MapleSim has features and tools that support the use of third-party revision control systems to track changes to your models and libraries.

 

Version Controlled File Formats for Models and Libraries

Compare Models Tool and Selective Save

Diff Tool

Version Controlled File Formats for Models and Libraries

The standard file formats for models (.msim) and libraries (.msimlib) are binary files that contain component definitions, simulation results, attachments, simulation settings, and model geometry in a single file. Having this information in a single file is convenient when you need to share your model or library with others. However, it has the following disadvantages when used with a revision control system:

• 

If you need to revert a single component, the entire file needs to be reverted. That is, you cannot revert a single component definition to its previous version and leave the rest of your model or library at its current state.

• 

Two people cannot work on the same file at the same time, even if they are working on completely separate components. This is because there is no way to reliably merge their changes.

The version controlled file formats for models and libraries, .base_msim and .base_msimlib, solve these issues by breaking up the binary files in a model or library into separate files and therefore give you more control over each component.

For more information, see Version Controlled MapleSim Model File Format, Creating a Version Controlled Model, Version Controlled Library File Format, and Creating a Version Controlled Library.

Compare Models Tool and Selective Save

The Compare Models tool lets you compare the working (that is, In Memory) version of your model to the last version that was saved to disk. This lets you see what components, parameters, and settings you have changed before you save your model. For more information, see Comparing Models and Compare Models Tools: Details.

The selective save feature lets you choose what changes to save in your model or library. This is useful when you are updating a shared subsystem and need to make temporary changes to the rest of your model in order to verify your updates. When you are ready to save the updates to your shared subsystem you can select only the those changes and reject the temporary changes that you made to the rest of your model. For more information, see The Selective Save Feature and Saving a File.

Diff Tool

The Diff Tool is a separate executable that compares model files (.msim and .base_msim), library files (.msimlib and .base_msimlib), and component files (.component). It can be configured with a third-party revision control systems to generate a report on the differences between two versions of a file. For more information, see The Diff Tool.

See Also

Version Controlled MapleSim Model File Format

Creating a Version Controlled Model

Version Controlled Library File Format

Creating a Version Controlled Library

Comparing Models

Compare Models Tool: Details

The Selective Save Feature

Saving a File

Converting a Version Controlled Model to a Standard Model

Converting a Version Controlled Library to a Standard Library

Opening a Version Controlled Model or Library

The Diff Tool

Trademark Attributions