Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Content layer
id155254439
Content column
id155254443
Content block
id155254436

On this page

Table of Contents
maxLevel4
minLevel3


Content block
id155254441

Excerpt Include
Unit
Unit
nopaneltrue
This section explains how to specify units for a Value Property, how to display or hide units and unit symbols in various places.

Specifying Unit for a Value Property

When the Block has the Value Property defined, it requires a numeric value and must be typed by the Value Type, either with or without (unitless) a specified Unit.

To specify the Unit for a Value Property


  1. Select the Value Property in the Block compartments.
  2. If the ISO-80000 library is not uploaded in your project, click the ISO button on the smart manipulator toolbar.

    Warning
    • If you work with projects older than version 18.0, which use the QUDV library and SysML 1.3 library, the ISO-80000 library will not be compatible.
    • If you work with Teamwork projects, the ISO-80000 library is uploaded by default.

    Image Modified

  3. Open the Select Type menu in one of the following way:
    • Click Specify Type.
    • Press Ctrl+T.
    • From the shortcut menu, select Type.
  4. Select the Value Type by typing the quantity name and unit name in the following syntax: quantity name[unit name].

    Warning
    titleUnit libraries
     - If you cannot find a suitable Unit in the standard libraries, you can create custom Units. Learn how to create custom units >>
     - You can manage the scope of provided units with the Package Import feature.

    The unit is specified for a Value Property. As example, see the figure below.

The stoppingDistance Value Property typed by distance[metre] Value Type.

Displaying/hiding Units

After the unit is specified you can:

Anchor
value_property
value_property
Displaying/hiding units for Value Property

The full name of the unit (e.g. metre, kilogram) is shown by default next to the Value Property on the Block compartments.

To hide/display full name of unit for Value Property


  1. Select the Block shape.
  2. From its shortcut menu, select Symbol Properties.
  3. Select the All options display mode.
  4. Find the Show Attributes Tagged Values option.
  5. Set its value to true to show the unit (default), or false to hide it.
    The full name of the unit is shown/hidden next to values in brackets in the compartments.

Anchor
symbol
symbol
Displaying/hiding unit symbols for Value Property

You can show the unit symbol in brackets (e.g. (m), (kg)) next to the Value Property on the Block compartments. If the Value Property has a value defined, unit symbol in brackets is hidden (see the figure below). How to show unit symbols next to values >>

To display/hide unit symbol next to Value Property


  1. Select the Block shape.
  2. From its shortcut menu, select Symbol Properties.
  3. Find the Show Unit on Value Property option.
  4. Set its value to true to show the unit symbol, or false (default) to hide it.
    The unit symbol is shown/hidden next to Value Property.


Anchor
values
values
Displaying/hiding units symbols for values

You can hide or display the symbol of units (e.g. m, kg):

Anchor
on block
on block
Displaying/hiding unit symbols next to values

You can display or hide the unit symbols (e.g. m, kg) of values in the whole project when the Unit is already defined for the Value Property and it has a value specified. For projects older than version 18.5, you must enable the Show Units option in the Project Options dialog if you want to see unit symbols. As of version 18.5, this option is enabled by default for any new projects.

Anchor
show_units
show_units
To display/hide units symbols next to values


  1. Select Options > Project.
  2. In the Project Options dialog, expand the General option group and select SysML.
  3. Set the Show Units option value to true to show unit symbols, or false to hide.
    The unit symbols are shown next to the values in the compartments.


Anchor
slot
slot
Displaying/hiding unit symbols next to slots

You can display a unit symbol for a slot on the Instance Specification shape by specifying it in the following ways:

Warning
titleWarning

The following procedures work only if the Show Units option is enabled. How to enable the Show Units option >

Anchor
type
type
To specify or change the unit symbol of a slot using the Specify Type button


  1. Do one of the following:
    • Select the value in the compartment, and click the Specify Type button.
        The Specify Type button from smart manipulator toolbar.
    • Right-click the value in the compartment, and select Type
    • Select the value in the compartment, and press Ctrl+T.
  2. Specify the new unit, or select an existing unit from the Select Type menu list.

    Info
    titleInformation

    The list of units in the Select Type menu consists of those units that are defined in the Block property type, or in its subtypes.

    The Select Type dialog opens automatically when specifying unit.



Anchor
manually
manually
To specify or change unit by typing it manually


  1. Select the slot on the Instance Specification shape.
  2. Click it to edit.
  3. Type the required unit symbol next to the slot value.
  4. Press Enter.


Anchor
right-click
right-click
To specify or change the unit using the right-click menu


  1. Select the slot in the Instance Specification compartment, the row in the Instance table, or the Slot in the Containment tree.
  2. Right-click it, select the Unit button, and choose the required unit from the list.

    Info
    titleInformation

    The list of units under the Unit button consists of those units that are defined in the Block property type, or in its subtypes.

Anchor
cells_columns
cells_columns
Displaying unit symbols in the Instance table

You can display units in the Instance table in the following ways:


Anchor
unit_in_cell
unit_in_cell
To show unit symbols in cells of the Instance Table


  1. Click the Options button.

  2. Select the Show Units on Values option.
    The unit symbols are displayed next to the values in cells.


 

Warning
titleWarning
The Show Units on Values option does not allow you to specify units directly in the row of the Instance Table. If you want to edit them, enable the Show Unit option in the Project Options dialog. How to enable Show Units option >


Anchor
unit_in_column
unit_in_column
To show the unit symbol in the column header of the Instance Table


  1. Click the Options button.

  2. Select the Show Units on Columns option.
    The unit symbols are displayed on the column header.


Content block
id155310088

Related pages


Sample model

The model used in the figures of this page is the Extract requirement values sample model that comes with SysML Plugin. To open this sample do one of the following: