Documentation

Author Requirements in Simulink

In Simulink® Requirements™, you organize your requirements in groups called requirements sets. In each requirements set, you can create additional levels of hierarchy for when you need more requirements to describe the details of a requirement.

In this tutorial, you use the Requirements Editor to create a requirements set to organize related requirements and add requirements to the set.

Suppose that you are writing requirements for a controller model of an automobile cruise control system. You develop these requirements, using your company’s numbering standard for requirements (R1, R2, and so on).

ID and DescriptionRationale
R1: The maximum input throttle is 100%The maximum value of the throttle from the acceleration pedal can be no greater than 100%.
R2: Cruise control has a speed operation rangeCruise control has a minimum and maximum operating speed.
R2.1: The vehicle speed must be at least 40 km/hThe speed of the vehicle must be at least 40 km/h for the cruise control system to engage.
R2.2: The vehicle speed cannot be greater than 100 km/hThe maximum operational speed of the cruise control system for the vehicle is 100 km/h.

Add these requirements to a model called crs_controller.

  1. The model and supporting files are in a Simulink project. Open the project. At the MATLAB® command prompt, enter:

    slreqCCProjectStart
  2. Open the model. At the command prompt, enter:

    open_system('models/crs_controller')
  3. Open the Requirements Editor. In the Simulink Editor, select Analysis > Requirements > Requirements Editor.

    The Requirements Editor opens with the requirements in view in the requirements browser, arranged by requirements set. The crs_controller model has two requirements sets that you can see in the browser: crs_req_func_spec and crs_req.

  4. Add a requirements set in the requirements browser. From the Requirements Editor toolbar, click New Requirement Set .

  5. You save requirements sets to external files. Save your requirements set to a writeable location and name it cruise_control_reqset.slreqx.

  6. When you save requirements sets to external files, you can share requirements with other models.

  7. Add a requirement to your requirements set. Select the requirements set and click Add Requirement .

  8. In the Properties pane, enter details for the requirement. You can copy and paste or drag requirements from another source to the Properties pane.

    • Custom ID: R1

    • Summary: Max input throttle %

    • Description: The maximum input throttle is 100%.

    If you do not specify a custom ID, the Requirements Editor numbers requirements in order. Custom IDs let you use your company standards for labeling requirements and set the numeric order. (Custom IDs cannot contain a # character.) You can also use an ID to help locate a requirement by searching. Keywords also aid in searching for a requirement.

  9. Create the requirement R2. Right-click R1 and select Add Requirement After. Enter details for the requirement:

    • Custom ID: R2

    • Summary: Cruise control speed operation range

    • Description: Cruise control has a minimum and maximum operating speed.

  10. Create the child requirement of R2. Right-click R2 and select Add Child Requirement. Enter details for the requirement:

    • Custom ID: R2.1

    • Summary: Maximum vehicle speed

    • Description: The speed of the vehicle must be at least 40 km/h for the cruise control system to engage.

    Add the other child to requirement R2 if you want.

Tip

You can rearrange the hierarchy by using the or by dragging requirements.

Was this topic helpful?