4. The Reactis Info File Editor#

Reactis does not modify the .slx file for a model. Instead the tool stores model-specific information that it requires in an .rsi file. The primary way for you to view and edit the data in these files is via the Reactis Info File Editor. In Reactis Model Inspector, the search path and model comments can be modified, for all other elements of the .rsi file, the Info File Editor can be opened in read-only mode to inspect .rsi files created in Reactis. The comments pane is described below, whereas details of the other panes can be found in Chapter 5 of the Reactis User’s Guide. The information stored in the .rsi file is grouped into categories which are each controlled from a different pane of the Info File Editor. The categories are:

Harness.

This panel contains information and settings for the current test harness.

Inports.

This panel contains constraints on the values that the inports may assume during simulation, test generation, and validation.

Configuration Variables.

This panel lists workspace variables or data dictionary items tagged as configuration variables. Their value may change between tests, but not during a test.

Test Points.

This panel lists model data items which will be used as test points during testing.

Outports.

This panel specifies the tolerance for Simulator to use when comparing an outport value computed by the model against the corresponding value in a test suite. It also includes a list of intervals for each output for tracking interval coverage.

General.

This panel contains parameters which control how a model executes in Reactis (e.g. conditional input branch execution, short circuiting, etc.).

Error Checking.

This panel specifies how Reactis will respond to various types of errors (e.g. overflow, NaN, etc.).

Coverage Metrics.

This panel specifies the coverage metrics to be used when working with a model.

Excluded Coverage Targets.

This panel lists targets to be ignored when measuring the coverage of a model.

Validator Objectives.

This panel lists all Validator objectives (assertions, user-defined targets, virtual sources).

C Code.

If using the Reactis for C Plugin, this panel will contain a list of places C code is used in the model under test (S-Functions and Stateflow custom code) and settings which control the white-box analysis of each S-Function.

External EML Functions.

This panel lists .m files which contain Embedded MATLAB functions called from the model (e.g. from MATLAB Function blocks, Stateflow, Truth Tables).

Callbacks.

This panel specifies callbacks to be executed before and/or after a model is loaded.

Search Path.

This panel contains the model-specific search path.

File Dependencies.

This panel lists files on which the model depends.

Requirement Link Patterns.

This panel specifies templates or patterns for linking to requirements. A Validator objective can include a link to a requirement that the objective tests. Each such link is an instance of a pattern specified in this pane. Different types of requirements repositories (for example a Microsoft Word document or a Doors repository) can have different link patterns.

Comments.

This panel lists comments you have added to the model within Reactis.

Although not necessary, the default naming convention assumes that the .slx file and .rsi file of a model share the same base name; for example, if the model file is named cruise.slx, then the name of the associated .rsi file is assumed to be cruise.rsi. A .rsi file named differently may be associated with a model by loading the model in Reactis Model Inspector and selecting File -> Select Info File….

4.1. Comments Pane#

Reactis includes a mechanism for annotating the model under test without making any changes to the model itself. You insert a comment from the main Reactis window by right-clicking and selecting Add Comment…. The Comments pane of the Info File Editor, opened via Edit > Comments…, lists all comments you have added to your model, as shown in Figure Figure 4.1.

_images/rsifeCommentsPane.webp

Fig. 4.1 The Comments Pane of the RSI File Editor lists all comments.#

From within the Comments pane, you can do the following:

  • Highlight a comment’s location within the model by double-clicking on the comment’s row in the pane.

  • Cut or copy a comment to the clipboard by selecting the comment in the table, then selecting Edit > Cut or Edit > Copy.

  • Open the Comment Editor to view or change a comment by selecting the comment in the table, then selecting Edit > Edit

  • Remove a comment by selecting the comment in the table, then selecting Edit > Remove.

  • Sort the comments in multiple ways by clicking on column headers.

Comments can only be created or pasted from the main panel. Comments are listed in the table with seven columns:

  • Id Number. The unique ID number assigned to the comment by Reactis.

  • System. The path to the subsystem where the comment was placed.

  • Name. The name of the comment.

  • Last Modified. The time when the comment was most recently changed.

  • User. The name of the user who performed the last modification.

  • Created. The time when the comment was created.

  • Creator. The name of the user who created the comment.

4.1.1. Orphaned Comments#

Sometimes a model is changed in MATLAB in way that affects the subsystem paths. Changes that alter subsystem paths include renaming a subsystem, removing a subsystem, or moving a subsystem to a different parent system. When such changes occur, the system path stored in the .rsi file for a comment may no longer exist in the model, which makes it impossible to determine the location of the comment.

Comments whose system path does not exist are colored red in the Comments pane, with [orphaned] appearing after the ID number. An orphaned comment does not appear in the main window. It is only visible in the Comments pane of the RSI File Editor. You can take the following steps to reposition an orphaned comment:

  1. Click on the orphaned comment in the Comment pane.

  2. Right-click on the table of comments and select Cut. The orphaned comment will disappear from the table.

  3. Go to the main window, navigate to the subsystem where you want to place the comment. Right click on the location where you want the comment to appear and select Paste.

Once this is done, go back to the comment table. The comment should be visible in the table again, in black without the [orphaned] tag.