Main Content

View Simulink Requirements Links Associated with Model Elements

You can work with links that were added to the model with Simulink® Requirements™ when you use the Requirements Viewer app in Simulink. For all links, you can:

  • Highlight model objects with links

  • View information about a link

  • Filter link highlighting based on specified keywords

For links to requirements that are stored in external documents, you can also navigate to the linked requirements.

Highlight, Filter, and View Information for Links in a Model

This example shows how to work with a Simulink model that has links using the Requirements Viewer app. You can highlight links, view information about a link, and filter link highlighting based on specified keywords.

Open the slvnvdemo_fuelsys_officereq model.

open_system('slvnvdemo_fuelsys_officereq')

In the Apps tab, click Requirements Viewer.

Highlight Links in a Model

To highlight model objects that have associated outgoing links, in the Requirements Viewer tab, click Highlight Links.

Model objects that have associated outgoing links are highlighted in yellow, such as the block called MAP sensor.

Objects that contain child objects with associated outgoing links are highlighted with an orange outline, such as the fuel rate controller subsystem.

Model objects that do not have associated links are dimmed.

To remove highlighting, click the Highlight Links button again. When highlighting links, ensure that you don't have any keyword filters applied because this can prevent some objects from becoming highlighted. For more information, see Filter Highlighted Links.

View Information About a Link

After you've identified the model objects that have associated outgoing links, you can view information about those links. Right-click the MAP sensor block and select Requirements > Open Outgoing Links dialog.

The Outgoing Links dialog displays information about the link and its destination. In this case, the link destination is a requirement stored in an external document. The dialog displays the:

  • Link description

  • Document type

  • Document name and relative location

  • Location identifier for link destination

  • Link keywords

Filter Highlighted Links

Links in your model can have associated keywords. You can categorize a link with a keyword. For example, the slvnvdemo_fuelsys_officereq model uses the keywords design, requirement, and test.

In the slvnvdemo_fuelsys_officereq model, the MAP sensor block has the specified keyword test, which was found in View Information about a Link. Filter the highlighted links so that only blocks that have associated links with the keyword test are highlighted:

  1. In the Requirements Viewer tab, click Link Settings.

  2. In the Requirement Settings dialog, in the Filters tab, select Filter links by keywords when highlighting and reporting requirements.

  3. In the Include links with any of these keywords field, enter test.

  4. Click Close.

  5. In the Requirements Viewer tab, click Highlight Links.

Note that the fuel rate controller subsystem is not highlighted when the filter is applied.

You can also use the Exclude links with any of these keywords field to omit blocks from highlighting that have associated links with the specified keyword. You can enter multiple keywords in the Include links with any of these keywords and Exclude links with any of these keywords fields. If you select Apply same filters to link labels, when you right-click blocks that have links but are not highlighted, the link is greyed out and you cannot navigate to the destination.

To clear the filter, clear Filter links by keywords when highlighting and reporting requirements, or remove all keywords from the Include links with any of these keywords and Exclude links with any of these keywords fields.

Cleanup

Close the open models without saving changes.

bdclose all;

Navigate to Externally Stored Requirements from a Model

This example shows how to navigate to linked requirements that are stored in an external document from a model using the Requirements Viewer app in Simulink. If a model object is linked to a requirement that is stored in an external document, such as a Microsoft® Word or Microsoft Excel® file, or an IBM® Rational® DOORS® or IBM DOORS Next project, then you can navigate to the requirement in the external document from the associated block in Simulink.

Open the slvnvdemo_fuelsys_officereq model.

open_system('slvnvdemo_fuelsys_officereq')

The block called MAP sensor is linked to a requirement in a Microsoft Excel file. To navigate to the requirement in the Excel file, right-click the MAP sensor block, select Requirements, and click the link at the top of the context menu.

The associated requirement opens in Excel.

If you don't have Simulink Requirements installed, then you cannot navigate to requirements that are stored in a Simulink Requirements requirement set.

Close the open models without saving changes.

bdclose all;

See Also