RequirementsTable

Configure Requirements Table blocks

Since R2022a

Description

Use RequirementsTable objects to configure Requirements Table blocks.

Creation

To create a RequirementsTable object:

• Use the slreq.modeling.create function to create a new Simulink^® model that contains a Requirements Table block.

• Add a Requirements Table block to an existing model using add_block (Simulink) and retrieve the object with the slreq.modeling.find function.

Properties

Name — Name of Requirements Table block

"Requirements Table" (default) | string scalar | character vector

Name of the Requirements Table block, specified as a string scalar or character vector.

Example: table.Name = "tableName" changes the block name to tableName

Data Types: char | string

Path — Path of Requirements Table block

character vector

This property is read-only.

Path of the Requirements Table block, returned as a character vector.

Data Types: char

RequirementHeaders — Requirements Table block headers

structure array

Requirements Table block headers, specified as a structure array. Specify headers to add under the Precondition, Postcondition, and Action columns in the Requirements tab by setting the Preconditions, Postconditions, and Actions fields to a string vector or cell array of character vectors. Use a cell array to add multiple columns under the Precondition, Postcondition, and Action columns.

Example: table.RequirementHeaders.Preconditions = ["u1","",""] changes the Precondition column header where one header is u1 and the other two are empty.

Data Types: struct

ChildEvaluation — First-level requirement evaluation

"independent" (default) | "exclusiveExhaustive" | "prioritized"

Since R2024a

First-level requirement evaluation, specified as "independent", "exclusiveExhaustive", or "prioritized". For more information, see Specify Prioritized Evaluation for First-Level Hierarchy Requirements and Specify Exclusive Exhaustive Evaluation for First-Level Hierarchy Requirements.

Data Types: char

Object Functions

addRequirementRow	Add requirement to Requirements Table block
addAssumptionRow	Add assumption to Requirements Table block
addSymbol	Add data to Requirements Table block
clear	Clear row in Requirements Table block
getAssumptionRows	Retrieve assumptions in Requirements Table block
getRequirementRows	Retrieve requirements in Requirements Table block
findSymbol	Retrieve data in Requirements Table block
hideAssumptionColumn	Hide Precondition column in Assumptions tab
hideRequirementColumn	Hide columns in Requirements tab
removeRow	Remove Requirements Table block row
showAssumptionColumn	Show Precondition column in Assumptions tab
showRequirementColumn	Show columns in Requirements tab

Examples

Change Name of a Requirements Table Block

Create a new model called myModel that contains a Requirements Table block.

table = slreq.modeling.create("myModel");

Change the name of the block to newTableName.

table.Name = "newTableName";

Specify Precondition, Postcondition, and Action Columns

Create a new model called myModel that contains a Requirements Table block.

table = slreq.modeling.create("myModel");

Specify three Precondition columns with empty headers.

table.RequirementHeaders.Preconditions = ["","",""];

Specify two Postcondition columns where one header is u1 and the other is empty.

table.RequirementHeaders.Postconditions = ["u1",""];

Specify two Action columns with the headers u2 and u3.

table.RequirementHeaders.Actions = ["u2","u3"];

Create Requirements Table with Prioritized First-Level Hierarchy Requirements

This example shows how to create a Requirements Table block with three prioritized requirements.

Create a new model called myModel that contains a Requirements Table block, reqTable.

reqTable = slreq.modeling.create("myModel");

Add two additional requirements.

addRequirementRow(reqTable);
addRequirementRow(reqTable);

Set the evaluation of the first-level requirements to prioritized.

reqTable.ChildEvaluation = 'prioritized';

Close myModel.

bdclose("myModel");

Version History

Introduced in R2022a

R2024a: Set first-level requirement evaluation

Use the ChildEvaluation property to specify how the first-level hierarchy requirements in a Requirements Table block execute.