SysML Plugin 18.4 Documentation

Skip to end of metadata
Go to start of metadata

You can display Constraint Properties with Constraint Parameters , Part Properties with ports (including deep nested ports), Value Properties, and other properties that have already been created in the model. This functionality is driven by stereotypes, which allow you to display properties on which stereotypes have been applied. If you have applied your own stereotypes for the elements (e.g., electrical, mechanical, optical), you can use those stereotypes when selecting the properties you want to display on the diagram pane.

Note

For more information about how to create custom stereotypes and apply them, see UML Profiling and DSL Guide.

 You can display parameters and properties on the SysML Parametric diagram pane in the following ways:

Using the Display Parameters/Properties dialog

You can use the Display Parameters/Properties dialog to control how much of a structure should be displayed. The Display Parameters/Properties dialog opens automatically when creating a new SysML Parametric Diagram for a  Block or Constraint Block elements that owns parameters and properties. It can also be accessed and opened in the structure diagrams that have already been created. The Display Parameters/Properties dialog allows you to:

  • Preview all Constraint Parameters, Constraint Properties, and other properties in one place.
  • Define layout options for properties.
  • Specify layout options for parameters.

The Display Parts/Ports dialog consists of the following areas:

  • Dialog toolbar allows you to show or hide additional information about listed elements.
  • Element tree displays all owned internal structure of context  Block or Constraint Block.
  • Panel is a context-sensitive area that depends on the selected property from the Element tree. It allows you to batch select parameters/properties  in the Element tree. You can select all, clear all, or choose only properties by type or stereotype.   
  • Options area allows you to choose the layout of the selected properties and parameters when they appear in the diagram.  
       


The following procedure will guide in working with the Display Parameters/Properties  dialog when you want to display required parameters and properties on the diagram pane.

 

To display parameters and properties using the Display Parameters/Properties dialog


  1. Open the Display Parameters/Properties  dialog:

    • When creating a new SysML Parametric Diagram, the dialog opens automatically. 
    • When editing an already created  SysML Parametric Diagram, the dialog can be opened in the following ways:
      - Select either a diagram frame or single/multiple element shapes, and, on the diagram toolbar, click Display Related Elements and choose Display Parameters/Properties .
      - Right-click either a diagram frame or single/multiple element shapes, and select Display > Display Parameters/Properties .

  2.  (Optional) Enable buttons from the Display Parameters/Properties dialog toolbar if you want to show or hide additional information about listed elements:  
    • Click Display the full path of the elements to show the full path of elements.
    • Click Display the qualified name of type in the typed elements text to show the full types of elements.
    • Click Show Inherited to show the inherited elements.  
    • Click Show Private Inherited to show the inherited properties.
       
  3. Choose the properties you want to display by using one or more of the following methods:

    Warning

    If some check boxes are inactive in the element list, those elements are already displayed in the diagram.

    • Use the element tree located on the left side of the dialog:
      - Manually select individual check boxes one by one.  
      - Select recursively nested elements by holding down the Shift key while selecting the corresponding check box for the element. 

       Example 1

      All Constraint Parameters C, gt, h of the Constraint Property typed by Grinding Constraint Block are selected recursively by holding down the Shift key while selecting the corresponding check box from the element tree in the Display Parameters/Properties dialog.

    • Use the context-sensitive panel located on the right side of the dialog:
      - Select Properties group - displays all property types (including your own stereotypes) that are owned by the selected element from the element tree  located on the left side of the dialog.
      - Select Parameters group - displays all parameters types (including your own stereotypes) that are owned by selected element from the element tree located on the left side of the dialog.
      - Select All - selects all check boxes that are expanded from the element tree located on the left side of the dialog.
      - Clear All - clears all check boxes, even those that are collapsed (deep nested), from the element tree located on the left side of the dialog.

       Example 2

      All Constraint Parameters C, gt, and h of the Constraint Property typed by Grinding Constraint Block are selected in the element tree by using the Select parameters group in the context-sensitive panel of the Display Parameters/Properties dialog.

       
  4.  Specify the layout options in the Options area:
    • Properties layout: make sure the Layout Parts check box is selected, otherwise the property shapes will not be arranged in the automatic layout.
    • Port/parameters layout on Part/Constraint property shape:
      Top/Bottom - displays ports/parameters on the Part/Constraint Property shape from top to bottom.
      The Constraint Parameters h, C, and gt are displayed on the Constraint Property shape typed by Grinding Constraint Block from top to bottom.
      - Left/Right  - displays ports/parameters on the Part/Constraint Property shape from left to right.
      The Constraint Parameters h, C, and gt are displayed on the Constraint Property shape typed by Grinding Constraint Block from left to right.
  5. Click OK.

After those steps all  parameters and properties that were selected in the Display Parameters/Properties dialog are displayed on the diagram pane.

Using the diagram toolbar and the shortcut menu

You can also use the Display Related Elements button and Display command group from the shortcut menu as their functions are identical. All those commands are interactive and depend upon the selection on the diagram pane. For example, if the Constraint Property shape is selected on the diagram pane, the both menu contains only the commands that can be applied to the selected Constraint Property shape. If you select nothing in the diagram pane, the both menu shows commands that can be applied to the whole diagram.

These commands under the Display Related Elements button and shortcut menu are comprised of elements that are still not displayed on the diagram according to their:

  • Metatypes.
  • Stereotypes.
  • Types stereotypes.

The following procedures will show you how to:

 

To display Constraint Parameters, Constraint Properties using the Display Related Elements button


  1. Select either a diagram frame or single/multiple element shapes.
  2. On the diagram toolbar, click Display Related Elements.
  3. From the opened command menu, select required properties or parameters to display:
            - All Parameters that are available to display are listed under the Display Parameters command group.

    Important

    If nothing is selected on the diagram pane, the Display Parameters command group will contain commands that allow you to display two levels of structure: Constraint Parameters are displayed on the diagram frame and on the first level Constraint Properties.

            - All properties that are available to display are listed under the Display Properties command group.

    After selecting the required command from the Display Related Elements button, the appropriate properties and parameters are displayed on the diagram pane.

 

To display parameters, properties using the shortcut menu


  1. Right-click either the diagram pane or single/multiple element shapes.
  2. From the shortcut menu, select the Display command group.

    The Display command group menu allows to display Constraint Parameters of the selected Constraint Property shape.
  3. From the opened command menu, select required parameters to display:
            - All parameters that are available to display are listed under the Display Parameters command group.

    Important

    If nothing is selected on the diagram pane, the Display Parameters command group allows you to display two levels of structure: ports are displayed on the diagram frame and on the first level parts.

            - All properties that are available to display are listed under the Display Properties command group.
    After selecting the required command from the Display command menu, the appropriate properties, parameters are displayed onto the diagram pane.

To hide Constraint Parameters 


  • Select either a diagram pane or any number of Constraint Property shapes, and, on the diagram toolbar, click Display Related Elements  and choose Hide All Parameters.
  • Right-click either a diagram pane or any number of Constraint Property shapes, and select Display > Hide All Parameters.
    After selecting the command, the parameters of the selected shape will be hidden from the diagram pane, but not removed from the model.

    Warning

    If the Hide All Parameters command doesn't appear, the selection or diagram doesn't contain any parameters that can be hidden.

    Hiding all Constraint Parameters of the Constraint Property typed by Boiler Water Mass Constraint Block.

Using the smart manipulator toolbar

When the Constraint Properties are already displayed on the SysML Parametric Diagram, you can display their Constraint Parameters using the Display All Parameters button from the smart manipulator toolbar. Follow the steps below to learn how to display Constraint Parameters of a selected Constraint Property shape.

To display Constraint Parameters on Constraint Property shape


  1. Select the Constraint Property shape or a diagram frame.
  2. From the smart manipulator toolbar, click Display All Parameters.
    All first level Constraint Parameters are displayed on the selected Constraint Property shape. 

    Warning

     If the Display All Parameters button is not available, the selected element or diagram doesn't own any Constraint Parameters.

     The Display All Parameters button on the smart manipulator toolbar of the Constraint Property shape typed by Boiler Water Mass Constraint Block.

After completing the steps outlined above, the Constraint Property with all its Constraint Parameters, and/or Part Properties with ports (including deep nested ports), Value Properties can be displayed on the SysML Parametric diagram.

Sample model

The model used in the figures of this page is the Coffee Machine sample model that comes with Cameo Simulation Toolkit plugin. To open this sample do one of the following:

  • Download CoffeeMachine.mdzip.
  • Find in modeling tool <modeling tool installation directory>\samples\simulation\CoffeeMachine.mdzip.