Skip to main content
Jump to: navigation, search

Papyrus/UserGuide/Submodel

Creation of submodels and reintegration

In this page we will show the Papyrus capabilities to create and reintegrate submodels, also known as control mode.

What is it?

As a model grows large in number of elements, it is convenient to split them into different physical resources i.e. files. Papyrus provides a feature to perform this splitting in a seamless fashion, allowing to move parts of the model to another resource. We call this create a submodel. This is specially helpful working in collaborative environments, since the Team features can be applied individually to the different resources i.e. make changes and commit them in only one part of the model.

Create a submodel

To create a submodel:

  1. Right click on the element which you wish to move to a different resource (a Package in the common case)
  2. Select Create submodel
    Control Mode Menu
  3. The following dialog appears.
    Control Mode Dialog
  4. Select the desired location
  5. Click OK.

Important: The selected element has not been moved just yet. The model editor will be dirty i.e. there will be an asterisk next to its name in the tab. In order to complete the submodel creation, you need to save your model.

The new resource is created in the chosen location with the chosen file name, whilst a green decorator is shown in the model explorer view of the parent model to indicate this element is in a submodel.

Reintegrate a submodel into the main model

To reintegrate a submodel into the main model:

  1. Open the parent model
  2. Right click on the submodel element in the model explorer (recognizable with the green decorator)
  3. Select Reintegrate Submodel
    Uncontrol Mode Menu

The submodel is reintegrated into the main model resource.

Important: The submodel resources will be deleted only on save action.

Back to the top