Page History

On this page

Specifying Unit for a Value Property

When a Block has a 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.

   
   

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
   title Unit libraries
   - If you cannot find a suitable Unit in the standard libraries, you can create custom Units. To learn more about creating units, refer to the Customizing Units page.  - You can manage the scope of provided units with the Package Import feature.

   The unit is specified for a Value Property. As an 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:

• Display/hide units for Value Property.
• Display/hide unit symbols for Value Property.
  
• Display/hide unit symbols for values.

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 the full name of a unit for a 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 the 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, the unit symbol in brackets is hidden (see the figure below). How to show unit symbols next to values >>

To display/hide a unit symbol next to a 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 the Value Property.
   
   

Anchor
values values

Displaying/hiding units symbols for values

You can hide or display a unit's symbol (e.g. m, kg):

• Next to values in the whole project.
• Next to slots on the Instance Specification shape.
• In cells and column headers of the Instance Table.
  
  

You can display or hide the unit symbols (e.g. m, kg) of values in the entire 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.

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.
   

   

   
   

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

• Using the Specify Type button from the smart manipulator toolbar.
• Typing the appropriate unit symbol directly next to slot value.
• From the right-click menu.
  
  

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
   title Information
   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.
   

   
   

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.
   

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
   title Information
   The list of units under the Unit button consists of those units that are defined either in the Block property type or in its subtypes.

   
   

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

• Next to the values in cells.
• On column header of the table.
  

1. Click the Options button.

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

1. Click the Options button.

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

Related pages