Review Simulink Models
Collaborator supports reviewing MathWorks Simulink models that are exported as web view archives.
| Note: | Reviewing Simulink models is only supported in Collaborator Enterprise edition. 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
- MathWorks Simulink version 2018-2021, 2022b with Simulink Report Generator is installed.
- Models, exported from 2022a, cannot be processed in Collaborator now.
- Collaborator Enterprise edition is installed.
- (Optional.) Collaborator Simulink Reviewer App is installed in Simulink and configured.
Upload Simulink models
There are several ways to upload a Simulink model to a Collaborator review: export it manually with the Report Generator and then upload it to Collaborator server, use the Collaborator Simulink Reviewer App to export and upload model directly from Simulink IDE, or automatically create reviews for Simulink models from remote repositories.
Export and upload manually
- Open the desired model in MathWorks Simulink.
- Switch to the Simulation tab and click the down-arrow next to Save button.
- In the drop-down menu select Export model to > Web View . (This menu item is available when Simulink Report Generator is installed.)
Export and upload with Collaborator Simulink Reviewer App
- Install and configure Collaborator Simulink Reviewer App.
- (Optional.) Open the desired model in MathWorks Simulink.
- Switch to the Apps tab and click Collaborator Simulink Reviewer.
Export and upload automatically for models from remote repositories
Collaborator administrators can configure it to automatically create or update reviews for Simulink models that were found in pull requests or pushes from remote repositories. To perform this any of remote repository integrations should be configured and running, and MathWorks Simulink with Simulink Report Generator must be installed on the same machine where Collaborator server is installed. See Automatically create reviews for Simulink models from remote repositories for details.
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, differences in embedded code, as well as differences in graphical objects: changes are yellow, additions are green and deletions are red.
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.
- When the Show diffs in nested levels option is enabled Diff Viewer will highlight parent block as changed when some of its nested blocks have changes.
Additionally it has several options that affect text comparison of block properties: Ignore Whitespace , Ignore Capitalization , Ignore Sequence Number .
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-2021, 2022b with Simulink Report Generator installed.
- To use the Collaborator Simulink Reviewer App you should have MathWorks Simulink version 2019-2021, 2022b with Simulink Report Generator installed.
- Models, exported from 2022a, cannot be processed in Collaborator now.
- Any Collaborator user can upload Simulink archive to Collaborator server.
- 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.
- «Running MATLAB on a headless server, or any other remote workflow, is currently not supported. While it is possible that MATLAB and Simulink may run successfully, it is not guaranteed and the technical support MathWorks can provide will be limited». The issue could be due to some missed libraries. If customers are experiencing difficulties with running Simulink they should contact Mathworks support.
Новые возможности моделирование в Automation Studio
Наличие двустороннего интерфейса связи между MATLAB/Simulink и Automation Studio позволяет существенно снизить затраты на разработку нового оборудования. Новая функция для Automation Studio Target for Simulink добавляет возможность отправлять данные о состоянии с реальной машины обратно в симуляционную модель Simulink, а также новые возможности для анализа и оптимизации среды тестирования.
- Главные особенности
- Привязка к любой целевой системе без генерации кода
- Высокая скорость обработки данных с машины
- Простота использования
- Оптимизация среды тестирования
Новая функция Hot-Plug обеспечивает прямой обмен данными между моделью MATLAB/Simulink и любой системой на оборудовании B&R — без промежуточного этапа генерации кода. Это позволяет передавать данные реального компьютера в режиме реального времени в среду MATLAB/Simulink для анализа и значительно упрощает управление данными. Набор инструментов MATLAB/Simulink позволит существенно упросить внедрение и использование глубокого обучения (Deep Learning), машинного обучения (Machine Learning), статистики и предиктивного обслуживания в полевых условиях на реальном оборудовании.
Предиктивное техническое обслуживание
Возможность извлечь данные с реальной машины и передать их в симуляционную модель позволит оптимизировать интервалы технического обслуживания. Сравнение поведения реальной машины с её моделью позволяет выявить ранние признаки скорой поломки, например, определить изношенные или поврежденные подшипники. Данные предварительно обрабатываются в MATLAB/Simulink, а затем их можно передать в облако с помощью B&R Edge Controller. Полученные данные и опыт по оптимизации оборудования на одном из заводов можно будет применить для всего парка оборудования по всему миру.
Больше возможностей для анализа
Благодаря новой функции WebView модель MATLAB/Simulink можно экспортировать в формате сгенерированного кода или блок-схем. Затем программист может открыть блок-схему в веб-интерфейсе Automation Studio. Модель, работающую на целевой системе, можно проанализировать с помощью веб-браузера, без необходимости какого-либо специального программного обеспечения.
Оптимальная среда тестирования
Функция WebView также расширяет параметры, доступные в среде тестирования Automation Studio. Зачастую необходим беглый анализ автоматически сгенерированного кода. Данная функция не только считывает и записывает входные и выходные переменные, но также анализирует значения сигналов. Функции Hot-Plug и WebView облегчают выполнение повторяемых тестов и виртуальный ввод в эксплуатацию новой машины, а также помогают анализировать и оптимизировать общую производительность машины. Функции могут также использоваться во время работы, чтобы помочь предотвратить отказ благодаря раннему обнаружению поломок и дефектов.