Review Simulink Models

Applies to Collaborator 13.6
Collaborator 14.7 (latest version)Collaborator 14.6Collaborator 14.5Collaborator 14.4Collaborator 14.3Collaborator 14.2Collaborator 14.1Collaborator 14.0Collaborator 13.12Collaborator 13.11Collaborator 13.10Collaborator 13.9Collaborator 13.8Collaborator 13.7Collaborator 13.6Collaborator 13.5Collaborator 13.4Collaborator 13.3Collaborator 13.2Collaborator 13.1Collaborator 13.0Collaborator 12.5Collaborator 12.4Collaborator 12.3Collaborator 12.2Collaborator 12.1Collaborator 12.0Collaborator 11.5Collaborator 11.0Collaborator 10.xCollaborator 9.xCollaborator 8.xCollaborator 7.xCollaborator 6.x
, last modified on December 21, 2021

Collaborator supports reviewing MathWorks Simulink models that are exported as web view archives.

Note: Reviewing Simulink models is only supported in Collaborator Enterprise edition with additional Simulink integration licenses purchased and assigned to users. For a complete list of differences between Collaborator editions, see the comparison page.
The Collaborator Visual Studio Extension and Eclipse Plug-in do not support reviewing Simulink models. Use the Web Client instead.

Requirements

There are two ways to upload a Simulink model to a Collaborator review: export it manually with the Report Generator and then upload it to Collaborator server, or use the Collaborator Simulink Reviewer App to export and upload model directly form Simulink.

Export and upload manually

  1. Open the desired model in MathWorks Simulink.
  2. Switch to the Simulation tab and click the down-arrow next to Save button.
  3. In the drop-down menu select Export model to > Web View. (This menu item is available when Simulink Report Generator is installed.)
  4. In the subsequent dialog, select which systems to export, specify output folder path, make sure that package type is Zipped and press Export.
  5. Log into CollaboratorWeb Client.
  6. Create new review or open an existing one.
  7. Scroll to the Review Materials section.
  8. Click Upload and then select Simulink Archives from the drop-down list.
  9. In the ensuing dialog, choose one or more Simulink web view archives you want to attach and then click Upload.
  1. Install and configure Collaborator Simulink Reviewer App.
  2. (Optional.) Open the desired model in MathWorks Simulink.
  3. Switch to the Apps tab and click Collaborator Simulink Reviewer.
  4. In the subsequent dialog, switch to the Upload models tab, press Choose models and select one or more models you want to upload.
  5. Select which systems to export and specify include options.
  6. Specify whether to upload model to the last review that was created with Simulink Reviewer App, to create a new review or to upload it to some existing review.
  7. Click Upload to Collaborator.

View Differences

The UI displays differences between two revisions of a Simulink model in a side-by-side layout. Diff Viewer can highlight differences in block properties, as well as differences in graphical objects: changes are yellow, additions are green and deletions are red.

Reviewing Simulink models

Click the image to enlarge it.

Selecting a block will display its properties in the right side of the revision pane. Changes in property values are highlighted as well.

Display options

The Display panel has specific options for Simulink model review.

  • When the Show diff based on block properties option is enabled Diff Viewer will highlight blocks whose properties have been added, deleted or changed.
  • When the Show diff based on image comparison option is enabled Diff Viewer will highlight graphical objects that have been added, deleted or changed.

Make comments and mark defects

On the left of the main Diff Viewer page, there is a pane for chat threads, where you can view and make comments and mark defects that should be fixed. When reviewing Simulink models, you can create global, annotation, overall for file revision, element and label comments and defects. Comment and defect description could be in plain-text or use rich-text and Markdown formatting, they could also mention other Collaborator users.

To comment on a specific element of a model, click the desired element (block, property, line and so on) in the content view, type your comment in the text box and click Add. To add defects, click the desired element in the content view, type the defect description, click Add as defect and fill-in the required fields.

Alternatively, you may specify an arbitrary label, such as "Header section", to describe the content you are referring to.

To learn more about communicating during the reviews, see Types of Review Comments and Defects and Review Chats, Comments, and Defects topics.

Technical details and limitations

  • To export Simulink models as web view archive you should have MathWorks Simulink version 2018 and newer with Simulink Report Generator installed.

  • To use the Collaborator Simulink Reviewer App you should have MathWorks Simulink version 2019 and newer with Simulink Report Generator installed.

  • Any Collaborator user can upload Simulink archive to Collaborator server. However, to review the archive contents, users should have Simulink integration license. These licenses are purchased from SmartBear additionally to Collaborator Enterprise licenses and are assigned to particular users by your Collaborator administrators.

  • Simulink integration licenses can be re-assigned only once in 24 hours.

  • When exporting models as web view archive, Simulink does not export complete information about a model. Consequently, some information will not be available to Collaborator and cannot be reviewed.

See Also

Review Materials
Diff Viewer

Collaborator Simulink Model Support
 
Highlight search results