Before using SimDiff we highly recommend that you watch the Flash demos that are included with the software. There are two demos, one for SimDiff Pro, and one for SimDiff LT. You can find them in the SimDiff start menu group:
Start ▷All Programs ▷EnSoft ▷SimDiff ▷SimDiff Flash Demo.

After that you can use this manual as a quick reference while using SimDiff. Its small width makes it fit perfectly next to SimDiff on your monitor.

Organization

This manual is organized into instructions for various tasks you may want to perform in SimDiff. For example how to diff two models, how to audit differences, etc.

Typically each step in a set of instructions will have a diagram indicating what parts of SimDiff's window you need to focus on for that step. Blue shaded parts of the diagram indicate where to perform the described action, and green shaded parts of the diagram indicate where results are displayed. For example:

1. 4 Click on a difference on in the center panel. Attribute changes for the selected difference appear in the lower mid panel.

Text Conventions

Instructions     Regular
Screen Elements     Blue Italic
Menus     Menu ▷Menu Item

1. 1 Run SimDiff-3.0-Setup.exe from the e-mail you received from EnSoft or your SimDiff Installation CD.
2. 2 Follow the on-screen instructions.
3. 3 The first time you run SimDiff you will be asked to enter your license key or license server information.

1. 1 Select the first model to compare.
2. 2 Select the second model to compare.
3. 3 Click on the Diff button.
4. 4 Click on a difference on in the center panel. Attribute changes for the selected difference appear in the lower mid panel.
5. 5 Click on the View Difference button to view the difference highlighted within Simulink.

Notes: If you see this icon to the right of a model you selected, the model is stored in a ClearCase repository. Click on the icon to change which version you want to diff.

1. 1 Click on one of the colored squares:
   Additions, Changes, Deletions, Flashing Color
2. 2 Pick the color you want.
3. 3 Click on the Diff button.

Notes: Changing Flashing Color does not require that you click on Diff—it is immediately applied.

Your model may contain library reference blocks. By default SimDiff will only diff the information inside the .mdl file—in this case the reference block, not the referenced block. If you want SimDiff to diff the referenced block instead, follow these instructions:

1. 1 Check-off Inline under the Library Links section.
2. 2 Click Directories to open the Library Directories dialog.
3. 3 Add library directories using . Directories may be specific to the first or second model, or common to both.
4. 4 Click OK. Next time you click Diff, SimDiff will ask MATLAB to create a model with referenced blocks inline.

Notes: Library directories may be relative or absolute.

When you view differences in Simulink, SimDiff organizes the Simulink windows so that you can browse differences efficiently. All the windows for model 1 will appear in the same place, and all the windows for model 2 will appear in another.

1. 1 Open File ▷Preferences.
2. 2 Click Set Window Positions.
3. 3 Place the windows where you want them.
4. 4 Click OK. Click OK. Next time you click Diff the windows will appear in their new positions.

SimDiff allows subsystems of models to be diffed, while ignoring the rest of the model.

1. 1 Select the first model to compare.
2. 2 Click Select to open the Available Subsystems dialog.
3. 3 Select the subsystem to diff from the tree.
4. 4 Click OK.
5. 5 Repeat steps 1-4 for the second model.
6. 6 Click on the Diff button.

Notes: To clear a subsystem selection, click the next to the subsystem name.

The Model Hierarchy panel shows the unified tree of the subsystem for the first and second model. The subsystems that are changed, added or deleted are colored using the highlighted colors. Subsytems that have their name changed are shown in bold.

1. 1 Select the node in the model hierarchy tree. The difference list is updated to show only differences in that subsystem.
2. 2 Choose the option "Show difference in selected subsystem only" or "Show all differences under selected subsystem" to see the elements under that node.

1. 1 Click on the "Choose columns" button to choose the columns you want to be displayed.
2. 2 Columns can also be moved around by clicking on the column heading and dragging them to an appropriate location.

SimDiff uses a MATLAB Automation Server for certain tasks, such as displaying Simulink models. By default, SimDiff will use the version of MATLAB registered with Windows. To specify another version, follow these instructions:

1. 1 Open File ▷Preferences.
2. 2 Select the installation folder for the desired MATLAB version.
3. 3 Click OK.

Notes: You may need administrator privileges for these settings to take effect.

SimDiff can be told to ignore certain attributes when determining if a block or line has changed. The attribute can be ignored for specific block or line types, or for all blocks and lines.

1. 1 Open the Attributes Filter Editor dialog.
2. 2 If the element is a Stateflow element, switch to the Stateflow tab.
3. 3 Select the block or line type in the left column. Attributes for that type are displayed on the right.
4. 4 Select the attribute name in the right column.
5. 5 Click Save to save the filter to an ".af" file. The next diff will ignore the attributes specified in this file.

Notes:

• —The special types [All Block Attributes], [All Line Attributes], [All Stateflow Object Attributes], and [All Transition Attributes] can be used to filter out an attribute from every block or line in the model, not just a specific block type or line type.
• —If the text (Common) appears at the end of an attribute name, the attribute is common to all blocks or all lines. Otherwise, the attribute is specific to that block type or line type.
• —Custom attributes and undocumented MATLAB attributes can be imported into the editor by selecting Import and choosing an ".mdl" file containing these attributes.

This feature is only available in SimDiff Pro

1. 1 After you are down reviewing a difference, click the checkbox on the left side of the difference. SimDiff will fill out the user name of the person who checked off the difference and the date and time it was checked off.
2. 2 You can add a comment if you like.
3. 3 When you are done you can generate an HTML report. Refer to the next section for instructions.

This feature is only available in SimDiff Pro

1. 1 Open File ▷Export HTML Report.
2. 2 Select where you would like to save the HTML report.
3. 3 Click Save.

1. 1 Run Start ▷All Programs ▷EnSoft ▷SimDiff ▷ClearCase Integration Tool ▷ClearCase Integration Tool
2. 2 Select the directory Clearcase is installed in.
3. 3 Select the directory SimDiff is installed in.
4. 4 Click on the Install or Update button.
5. 5 Select the VOB Configuration tab.
6. 6 Select the VOB(s) containing MDL files. Multiple VOBs can be selected by holding the CTRL key while clicking each VOB following the first.
7. 7 Click on the Install/Update on Selected button.

Notes: For more information, refer to the integration tool documentation at Start ▷All Programs ▷EnSoft ▷SimDiff ▷ClearCase Integration Tool ▷Manual

Most repository clients allow you to specify an external tool to diff specific file types. For instructions, please consult your repository client's documentation.

For most clients you will be asked to enter a command to execute. For SimDiff use this command:
C:\Program Files\EnSoft\SimDiff-3.0\simdiffgui.exe MDL1 MDL2
(please use the path to your specific SimDiff installation)

Replace MDL1 and MDL2 with the appropriate syntax for your client. For example, for CM Synergy, replace MDL1 and MDL2 with %1 and %2, respectively.

If your repository client adds any invalid characters to the model names that would prevent Simulink from opening them, SimDiff will automatically remove them.

1. 1 Send an e-mail to support@ensoftcorp.com.
2. 2 Please include general questions in the body of your email.
3. 3 If you experience an error while running SimDiff please include your SimDiff log.
   Open the log by selecting: Start ▷All Programs ▷EnSoft ▷SimDiff ▷SimDiff Log
   Save it to a location of your choice and attach it to your e-mail.