Published xcompare V User Manual

Transcription

1 Published xcompare V User Manual

2 Conventions in this Manual Markings NOTE CAUTION marks an advice that performing an action may lead to unwanted consequences such as loss of data. marks important information, such as dependencies or requirements of a function. INFO marks supplementary information, e.g. with respect to a wider context. TIP marks information for the practical use of the software. This symbol marks step-by-step instructions. Syntax Notation for command line input and configuration files Bold Italic Boldface marks text to be typed as shown. Italics mark text to be replaced by the required parameter value. [ ] Square brackets mark an optional parameter. Include this parameter, if required. { } Braces mark a list of parameters, which are separated by vertical bars. Include one of the given parameters. The parameter before the ellipsis may be included more than once. Contacting Transcat PLM xcompare on the internet > Products > xcompare Transcat PLM on the internet xcompare support Phone: support@transcat-plm.com Transcat PLM GmbH 2013

3 Contents 1 Application Overview Installing xcompare System Requirements System Requirements Installing xcompare using the installation package Installing xcompare manually List of environment variables Requesting and installing licenses Installing the license at the command line Installing the license using the LUM Basic License Tool Starting xcompare in a CATIA session xcompare Configurations Introduction to Configurations Setting up Configurations Reference to the Configuration Editor Reference to the Mapping Editor Generating a configuration file in batch mode Manually Editing the Configuration File Comparing Models in Interactive Mode Comparing Models Reference to the xcompare Main Window Open/Delete reports dialog Settings dialog Comparing Models in Batch Mode Preparations for batch mode Configuring a batch input file Transcat PLM 3 xcompare V5 1.7.x

4 6.3 Performing a check run in batch mode Analyzing the results Viewing the results Viewing results in the analysis window Visualizing geometrical differences with the Fine Analysis tool Reference to the Analysis Window Reference to the Enhanced Visualization Window Capturing user-defined images for the external report Reference to the Show captured image window Reports viewed in an HTML browser Mapping Introduction Reference to Mapping Rules Entity Selection Rules Filtering by Part Number/Name Filtering by Type Select by Part Number/Name Select by Element Type Select Visible Elements Select Invisible Elements Select Leaf Feature Select Parent Feature Select by Parent Name Select by Parent Type Select by Layer Select by Custom View Select by Drawing Sheet Select by Drawing View Element Pairing Rules Pair by Name Pair by Type Pair by Path Pair by Internal Name Pair by Parent Name Pair by Layer Transcat PLM 4 xcompare V5 1.7.x

5 Pair by Custom View Pair by Position Pair by Bounding Elements Aggregation Rules Special Rules Override Entity Selection Rules Override Entity Matching Rules Override Aggregation Rules Checks and Parameters Prechecks Compare CRC Structural Checks Compare Product Components Compare Find New or Deleted Entities Compare Find Renamed Entities Compare Find Types Match Geometrical Checks Compare Areas Compare Axis Systems Compare Bounding Boxes Compare CGRs Compare V5 BRep to CGR Compare CGR to V5 BRep Compare Tessellations to CGR Compare Centers of Gravity Compare Points Compare Drawing View s Generated Geometry Compare Sketches Compare Transformation Matrices Metadata Checks Compare Activation Status Compare Color Properties Compare Current Work Objects Compare Dimension Properties Compare Drawing Dittos Compare Drawing Sheets Transcat PLM 5 xcompare V5 1.7.x

6 9.4.7 Compare Drawing Views Properties Compare Feature Input Compare Font Properties Compare Layer Properties Compare Annotation Graphic Primitive Compare Parameters Compare Pick Properties Compare Point/Line Types Compare Product Properties of Root Compare Publications Compare Show Properties Compare Text Properties Compare Time Stamps Compare Annotation Notes Compare Annotation Datums Compare Annotation Dimensions Compare Annotation Geometrical Tolerances Compare Annotation Captures Compare Annotation Roughness Electrical checks Compare Bundle Segments Model Types Keyboard shortcuts Known Issues Quick Reference to Configuration Files Environment Application Languages MappingRules AggregationRules, EntityPairingRules, EntitySelectionRules, SmartModeMappingRules, OtherRules MappingRule SmartModeMappingRules Parameter (Mapping Rules) Checks CheckReference MappingRuleLinks Transcat PLM 6 xcompare V5 1.7.x

7 SmartModeRuleLinks CheckInstance Parameter (Check References, Check Instances) ModelTypes ModelType ModelTypeRules ModelTypeRule (Parameter Rule) ModelTypeRule (Application Feature Attribute) Profiles Profile CheckLink Setting Transcat PLM 7 xcompare V5 1.7.x

8 Application Overview 1 Application Overview What is xcompare? xcompare is an application for comparing CAD data, particularly different formats or versions derived from the same model. xcompare covers a number of compare operations, or checks, for structure, geometry and metadata. For a description of the available checks see Section 9 Checks and Parameters, page 71. xcompare V5 includes checks to compare the following pairs of models: V5 Product with V5 Product V5 Part with V5 Part V5 Drawing with V5 Drawing V5 Part with V5 CGR V5 CGR with V5 CGR Modes of operation xcompare is integrated into CATIA V5 and can be used in two ways: Interactive mode: Compare models from within the current CATIA session. Batch mode: Command line-based operation. Compare one or more pairs of models sequentially. For interactive mode, see Section 5 Comparing Models in Interactive Mode, page 29. For batch mode, see Section 6 Comparing Models in Batch Mode, page 34. Definitions Reference Document The reference document is the model file based on which differences to another models are evaluated. Compare Document The compare document is the model file that is compared to the reference document. Configuration A configuration is a set of application settings, profile and check definitions. A configuration is defined for a dedicated pair of file formats, e.g. for checking a V5 Part compare document against a V5 Part reference document. Profile A profile is a set of checks which is used to compare models. Mapping Mapping is a mechanism that controls correlation of elements during compare process Mapping Rule A mapping rule influences the input pair-list of a check. Transcat PLM 8 xcompare V5 1.7.x

9 Application Overview Custom View Selective view of a model. Visibility of elements in custom views is controlled by user-defined rules. In V5, custom views are defined in an external file. Transcat PLM 9 xcompare V5 1.7.x

10 Installing xcompare System Requirements System Requirements 2 Installing xcompare 2.1 System Requirements System Requirements Operating system CATIA version and releases The following versions of Microsoft Windows are supported: Microsoft Windows XP 32bit and 64bit Microsoft Windows Vista 32bit and 64bit Microsoft Windows 7 64 bit CATIA V5 R18 or later. All CATIA platforms (P1, P2, P3, PLM Express) are supported. If no xcompare installation package is available for the required CATIA release, please contact Transcat PLM. Depending on the CATIA platform, the following configuration packages and corresponding licenses must be available: CATIA P1 platform: All configuration packages At least MD1 license CATIA P2 platform: At least EI2+MD2+PM2+SA2 configuration and PX1 product At least MD1 license CATIA P3 platform: on request For detailed software requirements refer to the CATIA Program Directory that comes with your CATIA installation. xcompare is supported only on certified CATIA systems. 2.2 Installing xcompare using the installation package 1 Make sure to use the correct installation package. There are different installation packages for the particular CATIA releases, and for 32-bit and 64-bit systems. The name of the installation package for 64-bit systems contains B64, e.g. xcompare_171_r19b64.exe. Transcat PLM 10 xcompare V5 1.7.x

11 Installing xcompare Installing xcompare using the installation package System Requirements 2 Start the installation routine by double-clicking the installation package. When the Start Installation dialog is displayed, click Next. To abort at any time during installation, click Cancel. All settings will be canceled. To modify the settings you made in a previous step at any time during installation, click Back repeatedly until the desired dialog is displayed. 3 The installation routine looks up which versions of the CATIA release are installed. If an installation is found, select the desired version, then click Next. If no CATIA installation has been found, the following dialog is displayed instead. Choose the directory where CATIA is installed, then click Next. TIP: The CATIA installation directory can be recognized by its subdirectory named intel_a (for 32-bit versions) or win_b64 (for 64-bit versions). 4 Specify the installation directory where to install the xcompare application, then click Next. Transcat PLM 11 xcompare V5 1.7.x

12 Installing xcompare Installing xcompare using the installation package System Requirements 5 Specify the directory where xcompare report files will be stored, then click Next. TIP: You can change the report directory later. Specify the desired path using the TCACMPReportPath environment variable in the CATIA environment file. 6 To make xcompare available in CATIA, a CATIA environment must be prepared. Choose one of the following options: Transcat PLM 12 xcompare V5 1.7.x

13 Installing xcompare Installing xcompare using the installation package System Requirements Create new CATIA environment : A new environment file will be created. Click Next to continue. Modify existing CATIA environment : With this option, click Next to display a file selection dialog that displays the local CATIA environment directory. Select the CATIA environment file that you want to modify. If the selected environment already contains xcompare variables, an error will be displayed. In this case, choose a different environment file, or delete the existing xcompare environment variable definitions from the environment file manually. See the List of environment variables, page When creating a new CATIA environment, you can choose a directory for the new environment file: 8 When creating a new CATIA environment, you can specify the name of the new CATIA environment file. To recognize the environment readily, we recommend to include the versions of both xcompare and CATIA in the name, e.g. xcompare_171_catiav5_r19. Transcat PLM 13 xcompare V5 1.7.x

14 Installing xcompare Installing xcompare manually Click Next to proceed. NOTE: 9 The installation routine displays a summary of the specified settings. If all settings are correct, click Next to copy the required files to the installation directory. Otherwise click Back repeatedly until the desired dialog is displayed. 10 When the installation is complete, click Finish to leave the installation routine. xcompare is now available when you start a CATIA session using the xcompare environment. A desktop icon and start menu entry (in Programs > CATIA ) with the environment named have been created. When you have selected the Modify existing CATIA environment option during the installation routine, it is recommended that you check the modified CATIA environment file. In some cases, the modification of the environment may have failed, e.g. if it the environment file is write-protected or if the CATIA environment is very complex. 2.3 Installing xcompare manually To install xcompare manually, follow these steps: 1 Get the correct installation zip archive. There are different installation archives for particular CATIA releases, and for 32-bit and 64-bit systems. The name of the installation package for 64-bit systems contains B64, for example xcompare_171_r19b64.zip. 2 Extract the installation zip archive to a directory on a local disk. 3 Open the CATIA environment into which you want to integrate xcompare. You can open the environment in the CATIA Environment Editor. Transcat PLM 14 xcompare V5 1.7.x

15 Installing xcompare List of environment variables Alternatively, locate the CATIA environment file and open it in a text editor. 4 Add the xcompare paths and environment variables to the CATIA environment. Environment variables are described in 2.4 List of environment variables, page 15. To add a variable in the CATIA Environment Editor, right-click in the lower list and choose New Variable from the context menu, then type name and value of the new variable. Alternatively, you can edit the CATIA environment file manually in a text editor. 2.4 List of environment variables List of environment variables Name TCACMPReportPath TCACMPConfigPath TCACMPLangPath TCACMPLicV5V5 TCACMPTempPath TCTRACE TCACMPTRACEMAPPING Parameters and description Path to xcompare report files Path to xcompare configuration files. xcompare will look for configuration files in the given path and all its subdirectories. Path for xcompare language files. This directory contains language-specific files for the interface and reports. YES: Use license for V5/V5 checks, if available (default) NO: Do not use license for V5/V5 checks This variable is optional. If not set, xcompare will use a license for V5/V5 checks and cannot run any V5/V5 checks. Path to temporary model files. xcompare will temporarily store copies of V5 models in this directory if the file names and unique identifiers of reference and compare document are equal. Make sure that you have read/write access to the specified directory and that there is enough storage space available. Path and file name of the trace file. Set this variable to activate the creation of a trace file, in which significant activities of the xcompare application are recorded. Remove this variable to write no trace file. Set this variable only when needed, and remove it after use. Set this variable to record all mapping actions of xcompare in the trace file. Remove this variable to exclude mapping actions from the trace file. When this variable is set, both processing time and the size of the trace file will increase considerably. This variable has no effect if TCTRACE is not set. Transcat PLM 15 xcompare V5 1.7.x

16 Installing xcompare Requesting and installing licenses List of environment variables (continued) Name TCACMPIMGCAPTURE TCACMPStyleSheetPath TCACMPBrowserPath Parameters and description YES: Images for the report are captured following the check run (default). Processing time can increase considerably when there are many differences between the compared models. NO or variable not set: Images will be captured only when generating the HTML report from within the analysis window. This variable is optional and applies to V5/V5 only. Note that environment variable TCACMPNOCAPTURE is no longer used. Path to a customized report template. If this variable is set, xcompare copies the report template from the given path to the report directory when creating HTML reports. If this variable is not set, xcompare copies the report template located in the intel_a\reffiles or win_b64\reffiles subdirectory of the xcompare installation. Customizing the HTML report template, page 55 Path and file name of the HTML browser for viewing reports. Reports viewed in an HTML browser, page 55 This variable applies to V5/V5 only. 2.5 Requesting and installing licenses License types xcompare uses the IBM LUM license system. There are two types of licenses: Nodelock: License password only valid on one computer (tied to the hardware) NOTE: Requesting a license Concurrent: License is available in a network. A license server is required. Administrative rights are required to install a license. A license is required to run xcompare. For V5/V5 checks, a TC-xcompareV5 license is required. Modules for checking different pairs of file formats may require additional licenses. To obtain licenses, please contact Transcat PLM: Phone: license@transcat-plm.com Transcat PLM 16 xcompare V5 1.7.x

17 Installing xcompare Requesting and installing licenses If you need the target ID of the computer where xcompare will be installed, enter the following command at the Windows command line: i4target Installing a Nodelock License This requires the LUM runtime to be installed on the computer. 1 Open the file named nodelock at c:\documents and Settings\All Users\ Application Data\IBM\LUM. If no such file exists, create the file using a text editor. 2 Normally, you will receive your license information via . In the license , you will find a text similar to the following example: Copy the following 2 lines into your nodelock file. # TransCAT: TC-xcompareV5, Version 1.x, gueltig bis db765b tkq3wfzxi2g8p49keaa "" "2" NOTE: Copy these two lines from the to your nodelock file. 3 Save the nodelock file. The nodelock file has no filename extension. Some text editors automatically add a filename extension such as.txt. Make sure that the filename has no extension. Rename the file if necessary. Installing a Concurrent License Concurrent licenses are valid for a specific license server and are tied to its CPU ID. When adding license keys, LUM license manager must be installed, configured and activated. Installing the license at the command line 1 Save the license file in a directory on the LUM server. 2 Enter the following command: i4blt -a -f filename Where filename is the path and file name of the license file. Installing the license using the LUM Basic License Tool 1 Start the i4blt tool. Transcat PLM 17 xcompare V5 1.7.x

18 Installing xcompare Requesting and installing licenses 2 Choose Products > Single Product to open the Enroll window. 3 Click Import to open the import dialog. Select the license file and click OK to confirm. 4 Click OK to close the Enroll window. Transcat PLM 18 xcompare V5 1.7.x

19 Starting xcompare in a CATIA session 3 Starting xcompare in a CATIA session To start xcompare in interactive mode, click the xcompare icon on the xcompare toolbar in CATIA. The xcompare main window is shown. In the main window, you can do the following: Create or edit a configuration: 4.2 Setting up Configurations, page 21 Compare models: 5.1 Comparing Models, page 29 View results: 7.2 Viewing results in the analysis window, page 38 Transcat PLM 19 xcompare V5 1.7.x

20 xcompare Configurations Introduction to Configurations 4 xcompare Configurations 4.1 Introduction to Configurations xcompare settings are organized in configurations. From the definitions given in a configuration, xcompare gets the information what and how to compare and which entities of a given model to compare. A configuration defines: General settings for the xcompare application and user interface Set of available checks Profiles in which checks are organized Values of check parameters Model types Mapping information such as mapping rules A check has parameter values (if required) and a set of mapping rules. A profile defines a set of checks to be used. When using model types, a single profile contains alternate sets of activated checks for each model type. Below is a graph that visualizes these relations. Configuration Check Parameter values Active mapping rules x x Application Settings Available checks?????????? Available mapping rules?????? Profiles A lchecks Profile Profile 1 Profile 2 x x x Profile 1 Defaultmodeltype Active checks x x Modeltype 2 Active checks x Model types Defaultmodeltype Modeltype 1 Modeltype 2 Modeltype 2 Active checks x x x x Transcat PLM 20 xcompare V5 1.7.x

21 xcompare Configurations Setting up Configurations 4.2 Setting up Configurations Below is a step-by-step guide for setting up a new xcompare configuration. A detailed description of the functions used in this task can be found in Section 4.3 Reference to the Configuration Editor, page 23. For creating a default configuration at the command line, see Section 4.4 Generating a configuration file in batch mode, page 27 1 In the CATIA session, click the Start xcompare button. 2 Click Edit configurations. The configuration editor is shown. 3 Create a new configuration. Click the black arrow on the lower right corner of the Add configuration button. Choose the desired pair of document types from the flyout. A new configuration is added. 4 To rename the configuration, click the Rename configuration button. Change the name in the Configurations list box. Press [ENTER] to apply the new name. 5 Set the parameters of the checks to be used. Select a check to show its parameters in the Edit box. You can repeat this step whenever required. The parameter settings apply to this check in all profiles and model types throughout the configuration. 6 If you do not want to use default mapping rules, you can specify a user-defined selection. Select a check, then click Define mapping for selected check to display the Mapping Editor. In the Mapping Editor, activate or deactivate mapping rules by selecting or clearing the respective check boxes. You can disable all mapping rules or mapping rules of a certain type by selecting the respective Disable check box. To use smart pairing, select the Enable Smart Mapping option. From the Smart Pairing list box, select a predefined or user-defined set of pairing rules. You can repeat this step whenever required. Note that the selection of mapping settings applies to a check throughout the configuration, regardless of model types and profiles. 7 To use the same check several times with different parameter settings, select the check and click Duplicate selected check. An additional instance of the check is added. Initially, parameter values are identical. You can set the parameters individually for each instance. 8 To remove unused checks, select a check and click Remove selected check. If required, you can add all removed checks again by clicking Update check templates. Transcat PLM 21 xcompare V5 1.7.x

22 xcompare Configurations Setting up Configurations 9 Decide whether the configuration should to be model-type dependent. Model types can be used to automatically choose a set of checks within a profile, based on model-type rules. For more informations on model types see Section 10 Model Types, page 135. To set up the configuration with the default model type only, proceed with step (10). To define model types for this configuration, close the configuration editor and edit the configuration file manually. Define the model types to be used in the configuration. For informations on manually editing a configuration file see Section 4.5 Manually Editing the Configuration File, page 28. For the specification of model types see the element description for ModelTypes, page 144. Save the configuration file, then reopen the configuration editor and select the configuration. 10 Create a new profile by clicking the Add profile button. A new profile is added. You can add profiles whenever required. 11 Rename the profile by clicking the Rename profile button, then change the highlighted name in the Profiles list box. Press [ENTER] to apply the new name. You are prompted to confirm the new name. 12 If the configuration uses different model types, select a model type in the Model types list box. 13 Enable or disable checks to be used or ignored in this profile, respectively. Repeat this step for all available model types, if applicable. 14 When you have finished setting up the configuration, click OK to return to the xcompare main window. The configuration and profiles can be used for check runs both in interactive and in batch mode. Transcat PLM 22 xcompare V5 1.7.x

23 xcompare Configurations Reference to the Configuration Editor 4.3 Reference to the Configuration Editor Enable/Disable selected check button Click to enable or disable the currently selected check. Duplicate selected check button Click to create an additional instance of the currently selected check. This allows you to perform the same check with different parameter settings. Rename selected check button Click to display a dialog where you can rename the currently selected check for any interface language. In the Rename dialog, click the list entry for a given language, then click the Name column of the same entry to edit the text. Remove selected check button Click to remove the currently selected check from the current configuration. Define mapping for selected check button Click to display the Mapping Editor where you can enable or disable mapping rules for the currently selected check. Transcat PLM 23 xcompare V5 1.7.x

24 xcompare Configurations Reference to the Configuration Editor For a description of the Mapping Editor see Reference to the Mapping Editor, page 25. Update check templates button Click to add an instance of every available check missing from the current configuration. TIP: Use this function to: Add checks that have been removed from the configuration Add new checks that have become available when you have updated to a new version of xcompare Show help button Currently not available. Model types list box Select a model type from the list. Tree view The tree view lists the xcompare checks that are available in the current configuration. A selected check box indicates that a check is enabled in the current configuration. The currently selected check is highlighted. To enable or disable a check, click button or double-click the check box of the tree item. To enable or disable all structure, geometry, or metadata checks, right-click the respective parent node in the tree and select Enable checks or Disable checks from the context menu. Info box Displays a short description of the currently selected check. Edit group box with controls Set the parameter values for the selected check in the current configuration. Configurations combo box with buttons Select a configuration from the list. Add configuration button To add a new configuration, click the black arrow on the lower right corner of the Add configuration button. Choose the desired type of configuration from the flyout. Clicking the Add configuration button either adds a new V5/V5 Part configuration (initial state), or adds a configuration of the type that you have chosen recently from the flyout. Rename configuration button To rename the currently selected configuration, click this button, then change the highlighted text in the list box. To apply the text, click the button again or press [ENTER]. You are prompted to confirm the action. Transcat PLM 24 xcompare V5 1.7.x

25 xcompare Configurations Reference to the Configuration Editor Delete configuration button To delete the currently selected configuration, click this button. You are prompted to confirm the action. Profiles combo box with buttons Select a profile from the list. Add profile button Click to add a new profile. Set default profile button The default profile is used in batch runs when no other profile has been selected. Click to set the current profile as default profile. You are prompted to confirm the action. The white star icon indicates that the currently selected profile is the default profile; with all other profiles, the black star icon is displayed. Rename profile button To rename the currently selected profile, click this button, then change the highlighted text in the list box. To apply the text, click the button again or press [ENTER]. You are prompted to confirm the action. Delete profile button To delete the currently selected profile, click this button. You are prompted to confirm the action. Keyboard shortcuts: Configuration editor shortcuts, page 137 Reference to the Mapping Editor Use the Mapping Editor to select the mapping rules for building pairs. The selected rules apply to the currently selected check. The mapping editor lists all available mapping rules for the check. Each check has a set of default mapping rules, which is used as preset. TIP If you select additional mapping rules, mapping is more specific, which will narrow down the number of entities to be compared. If you deselect or disable mapping rules, mapping is less specific, therefore more pairs of entities can be formed. If no mapping rules are selected at all, all possible pairs of compare and reference entities are compared with each other. Transcat PLM 25 xcompare V5 1.7.x

26 xcompare Configurations Reference to the Configuration Editor NOTE: Enable Smart Mapping check box Select this check box to enable smart mapping. Currently, smart mapping is available for building pairs. For configurations created with Q-Compare V or earlier, smart mapping cannot be enabled using the configuration editor. Smart Pairing Mode list box Select the set of pairing rules for smart pairing: Apply GEO Smart Mapping Mode Predefined set of rules in which geometrical similarity has the highest priority. The predefined rule set is: 1. Pair by Bounding Elements, 2. Pair by Position (for V5 Products only), 3. Pair by Name, 4. Pair by Internal Name. Apply META Smart Mapping Mode Predefined set of rules in which the name property has the highest priority. Transcat PLM 26 xcompare V5 1.7.x

27 xcompare Configurations Generating a configuration file in batch mode The predefined rule set is: 1. Pair by Name, 2. Pair by Internal Name, 3. Pair by Bounding Elements, 4. Pair by Position (for V5 Products only). Apply User Defined Smart Mapping Mode User-defined set of rules. For editing the user-defined set of rules, see the Inactive pairing rules / Active pairing rules value list below. Inactive pairing rules / Active pairing rules value list When using a predefined set of pairing rules for smart pairing, the Active pairing rules list shows the rules sorted by priority in descending order. Predefined sets of pairing rules cannot be changed. NOTE: When using the user-defined set of rules, mark a rule and click an arrow button to add the rule to the selection, or to remove it from the selection. To change the order, remove all rules from the selection, and add them again sorted by priority in descending order. Aggregation is currently not supported for V5/V5 checks. Disable selection, Disable matching, Disable aggregation check boxes Select a check box to disable all selection rules, all pairing rules, or all aggregation rules for the currently selected check, respectively. See also Special Rules, page 70 Selection by, Pairing by, Aggregation by check boxes Select to activate the respective selection rule, pairing rule, or aggregation rule. Double-click to select or clear these check boxes. Edit Selected Mapping Rule If the highlighted mapping rule has parameters, you can edit its parameter values here. The same parameter values apply to all checks in the profile for which this rule is enabled. 4.4 Generating a configuration file in batch mode Apart from creating new configurations interactively in the configuration editor, you can generate default configurations at the command line or in a command file. In the resulting default configuration file, all available checks are enabled. Use the following composed command to initialize a CATIA environment and to create a default configuration file. CATIA_Install_Path\code\bin\CATStart.exe -env Environment_Name -direnv Environment_Path -run "TCACmpCoreBatch.exe -c {V5:V5Part V5:V5Drawing V5:V5Product V5CGR:V5CGR} Config_Path_and_Filename" CATIA_Install_Path Path of the CATIA V5 installation Transcat PLM 27 xcompare V5 1.7.x

28 xcompare Configurations Manually Editing the Configuration File Environment_Name Name of the CATIA V5 environment with xcompare integration (without the.txt filename extension) Environment_Path Path of the CATIA V5 environment file with xcompare integration V5:V5Part Compare V5 parts with each other V5:V5Product Compare V5 products with each other V5:V5Drawing Compare V5 drawings with each other V5CGR:V5CGR Compare V5 CGR models with each other Config_Path_and_Filename Full path and filename of the configuration to be created Example c:\catiav5\b19\intel_a\code\bin\catstart.exe -env xcompare_v5r19_171 -direnv "C:\Documents and Settings\All Users\Application Data\ DassaultSystemes\CATEnv_R19" -run "TCACmpCoreBatch.exe -c V5:V5Part """c:\program Files\TranscatPLM\xCompare_V5R19_171\config\MyConfigV5_ V5Part.xcmpconfig.xml""" " NOTE Always put the -run argument in double quotes ("). Within the -run argument, put any path that contains blanks in three double quotes ("""). 4.5 Manually Editing the Configuration File You can use an XML editor to edit the configuration file. For a reference to configuration files see Section 13 Quick Reference to Configuration Files, page 139 Transcat PLM 28 xcompare V5 1.7.x

29 Comparing Models in Interactive Mode Comparing Models 5 Comparing Models in Interactive Mode In Interactive Mode, you can compare the active model in the current CATIA session with another model in the same CATIA session, or with another CATIA model. 5.1 Comparing Models NOTE: To compare a pair of models, follow these steps: 1 Click the Run xcompare button on the xcompare toolbar. 2 Select a reference document. To select a model from the file system or from a logical folder (DLName), click the Select document button. If the reference document is not open in the CATIA session, it is opened automatically. To select a model from the current CATIA session, activate the respective model window in CATIA. When comparing a V5 Part and a V5 CGR model, the V5 Part must be the reference model. 3 Select a compare document. To select a model from the file system or from a logical folder (DLName), click the Select document button. To select a model from the current CATIA session, activate the Document in session option and choose a model from the list box. CATIA V5 does not allow to open two files with the same filename and the same unique identifier (UUID). To compare models, open only the reference document in the CATIA V5 session, and use Select document in xcompare to select the compare document. 4 Choose configuration and profile. Note that configurations work only for a certain combination of formats (e.g. V5 Part reference model with V5 Part compare model). 5 Optionally you can specify a user-defined report name. To do this, deactivate Use reference document name in report name and type a name into the box below. Otherwise xcompare uses the default name comprising the name of the reference document and a timestamp. 6 To compare the models, click OK. A progress bar shows the progress of the compare operation. When finished, the results are displayed in the analysis window. Transcat PLM 29 xcompare V5 1.7.x

30 Comparing Models in Interactive Mode Reference to the xcompare Main Window NOTE: For details see the Reference to the xcompare Main Window, page 30. Comparing models with identical filenames/uuids may take longer than comparing other models. This is because xcompare has to create a temporary copy of the compare document, due to restrictions of file handling in CATIA. 5.2 Reference to the xcompare Main Window Settings button Show the Settings dialog. Settings dialog, page 33 Show info button Show the xcompare version Show help button Currently not available Reference document text box Path and name of the reference document. To choose a model from a folder or logical drive (DLName), click the Select document button. If you click a model window in the CATIA session, this model is set as the reference document. If you activate the window of the compare document, compare document and reference document are swapped against each other. Compare document text box Path and name of the compare document. Transcat PLM 30 xcompare V5 1.7.x

31 Comparing Models in Interactive Mode Reference to the xcompare Main Window To set a model from the current CATIA session as compare document, activate the Document in session option and choose a model from the list box. To choose a model from a folder or logical drive (DLName), click the Select document button. Configuration list box Select a check configuration from the list box. The names of the check configurations correspond to the names of the check configurations files. Profile list box Select a check profile from the list box. The names of the profiles correspond to the ProfID attribute value of the respective profile definition in the configuration file. Edit configurations button Display the available configurations and their parameters. See Section 4.3 Reference to the Configuration Editor, page 23 Use reference document name in report name check box with list box Here you can specify the name of the check report to be created, or select an existing check report to be displayed. Deselect the check box and enter the user-defined report name in the list box. The file name extension.xcmpreport.xml is added to the report file automatically. Select the check box to use the default report name. The default report name contains the name of the reference model, followed by a timestamp in brackets (year, month, day, time) and the file name extension.xcmpreport.xml. Example This is the default report name for a model named Piston created on 15 March 2013 at 14:32:48. Piston[ _143248].xcmpreport.xml The list box contains existing reports that have been created in interactive and batch check runs. To display the results of a check run, select a report from the list and click Open selected report. Before you can select a report, deselect the Use Document Names For Report Name check box. To delete report that is selected in the list box, right-click the list box and select Delete. Open external report button Click to open the Open/Delete reports dialog. In the dialog, you can select a report to be displayed. You can also delete existing reports. Transcat PLM 31 xcompare V5 1.7.x

32 Comparing Models in Interactive Mode Reference to the xcompare Main Window box. Open the selected report button Click to open the report selected in the list Before you can select a report, deselect the Use Document Names For Report Name check box. Otherwise this button remains unavailable. OK button Click to compare the selected models with the current settings. Cancel button Click to discard all changes and to close the main window. Keyboard shortcuts: Main window shortcuts, page 136 Open/Delete reports dialog Look in text box Directory in which xcompare looks for reports. The default directory is the %TCACMPReportPath% directory specified in the CATIA environment. Select folder button To view reports from a different directory, click this button and select a directory. Delete selected reports button Click this button to delete the check reports that are currently selected in the list. Open selected report button Click this button to open the report selected in the reports list. Search field To filter the reports list, type a substring of the report names to be displayed. Clear the search field to display all reports in the current directory. Reports list The list shows all xcompare reports in the current directory. To sort the reports by file name, file size or date, click the column headers. OK button Click this button to open the report selected in the reports list. Transcat PLM 32 xcompare V5 1.7.x

33 Comparing Models in Interactive Mode Reference to the xcompare Main Window Cancel button Click this button to close this dialog. Settings dialog Dump only differences into the report check box If this option is selected, reports will contain only pairs of different entities. If this option is not selected, reports will contain all checked pairs of entities. Transcat PLM 33 xcompare V5 1.7.x

34 Comparing Models in Batch Mode Preparations for batch mode 6 Comparing Models in Batch Mode 6.1 Preparations for batch mode Batch Mode allows you to compare one or more pairs of models from the command line. To compare models with xcompare in batch mode, you need the following: A configuration file in which the intended checks are configured. A batch input file to tell the program which models to check, which configuration to use, and where to save the reports. If you have not yet prepared a configuration, see Section 4.2 Setting up Configurations, page 21. For generating a default configuration in batch mode, see Section 4.4 Generating a configuration file in batch mode, page 27. For creating an input file, see Configuring a batch input file below. 6.2 Configuring a batch input file Sample input file Multiple check runs One or more sample batch input files are supplied in the input subdirectory of the xcompare installation. Open a sample batch input file in a text or XML editor. Adapt the settings as described below, then save the file with a new name. The required information for each check run is specified in an XML node named Run. Example <InputFile Product="xCompare" Version="1.0.0"> <Run RunName="TestRun">... </Run> <InputFile> To define more than one check run to be performed in one batch run, copy the entire Run node, and insert the node in a valid place, as shown in the example. Transcat PLM 34 xcompare V5 1.7.x

35 Comparing Models in Batch Mode Configuring a batch input file Example <InputFile Product="xCompare" Version="1.0.0"> <Run RunName="Check1">... </Run> <Run RunName="Check2">... </Run> <InputFile> You can change the RunName attribute value to distinguish the check runs in the input file, although this is not technically necessary. Report Path In the ReportPath node, specify the file path for the report to be created. Example <Report> <ReportPath>C:\TestData\Reports</ReportPath> </Report> Configuration In the Configuration node, specify the following: the configuration file path in the ConfigPath node the configuration file name in the ConfigFileName node the profile name within this configuration in the ProfileName attribute <Configuration ProfileName="default"> <ConfigPath>T:\qCompareConfigurations\config</ConfigPath> <ConfigFileName>DefaultConfigV5_V5Part.xcmpconfig.xml</ ConfigFileName> </Configuration> Reference and compare documents In the DocumentPair node, specify the following: the file path of the reference document in the RefDocPath node the file name of the reference document in the RefDocFileName node the file path of the compare document in the CmpDocPath node Transcat PLM 35 xcompare V5 1.7.x

36 Comparing Models in Batch Mode Configuring a batch input file the file name of the compare document in the CmpDocFileName node Example <DocumentPair> <ReferenceDocument> <RefDocPath>C:\TestData</RefDocPath> <RefDocFileName>Test3.CATPart</RefDocFileName> </ReferenceDocument> <CompareDocument> <CmpDocPath>C:\TestData</CmpDocPath> <CmpDocFileName>Test4.CATPart</CmpDocFileName> </CompareDocument> </DocumentPair> NOTE: Make sure that the formats of reference and compare document match the pair of formats for which the configuration has been created. Trace file For debugging purposes, a trace file can be created during the batch run. To create no trace file, delete or comment out the Trace node. To create a trace file, specify the following in the Trace node: the file path of trace file in the TracePath node the file name of the trace file in the TraceFileName node. To create no trace file, comment out or delete the Trace node. Example Specifying the trace file <Trace> <TracePath>C:\TestData</TracePath> <TraceFileName>TraceLog.txt</TraceFileName> </Trace> Commenting out the node to create no trace file: <!-- <Trace> <TracePath>C:\TestData</TracePath> <TraceFileName>TraceLog.txt</TraceFileName> </Trace> --> Transcat PLM 36 xcompare V5 1.7.x

37 Comparing Models in Batch Mode Performing a check run in batch mode 6.3 Performing a check run in batch mode Use the following composed command to initialize a CATIA environment and to perform a xcompare batch check run. CATIA_Install_Path\code\bin\CATStart.exe -env Environment_Name -direnv Environment_Path -run "TCACmpCoreBatch.exe -i Input_Path_and_Filename -o Output_Path_and_Filename" CATIA_INSTALL_PATH CATIA V5 installation path Environment_Name Name of the CATIA V5 environment with xcompare integration Environment_Path Path of the CATIA V5 environment file with xcompare integration Input_Path_and_Filename Path and name of the input file (an XML file). For configuring an input file see Section 6.2 Configuring a batch input file, page 34. Output_Path_and_Filename Path and name of the output file (a plain text file) Example c:\catiav5\b19\intel_a\code\bin\catstart.exe -env xcompare_v5r19_171 -direnv "C:\Documents and Settings\All Users\Application Data\ DassaultSystemes\CATEnv_R19" -run "TCACmpCoreBatch.exe -i """c:\ Test Data\MyInput.xml""" -o """c:\test Data\MyOutput.txt""" " NOTE Always put the -run argument in double quotes ("). Within the -run argument, put any path that contains blanks in three double quotes ("""). Transcat PLM 37 xcompare V5 1.7.x

38 Analyzing the results Viewing the results 7 Analyzing the results 7.1 Viewing the results In the analysis window In an HTML browser Following an interactive check run, the analysis window displays the results. For every check run in interactive and batch mode, report files are created that contain the results of the check run. You can display an existing report in the analysis window. Reports for recent interactive and batch check runs are listed in the reports list box in the xcompare main window. Other reports, e.g. reports copied from other installations, can be selected from the file system. Viewing results in the analysis window, page 38 Opening an existing report in the analysis window, page 40 You can display xcompare reports independent from xcompare in an HTML browser. For display in HTML browsers, the report is complemented by images that show entities with differences. To prepare a report for display in an HTML browser, open the report in the analysis window, then click the Show report in HTML browser button. To capture images for the report automatically following the check run, set the environment variable TCACMPIMGCAPTURE=YES. You may want to disable capturing to save processing time by setting the variable to NO. In this case, images will be captured only when clicking the Show report in HTML browser button. List of environment variables, page 15 Once the images have been generated, you can display the report in an HTML browser even if xcompare is not installed on the computer. In the analysis window, you can preview the images captured for the report. For all pairs with differences, images are captured from a default view angle. You can capture a different view of particular entities where necessary, for example if the difference can t be seen from the default view angle. Capturing user-defined images for the external report, page 53 In HTML browsers, you can open the.xcmpreport.xml report file from disk. Reports are stored in the %TCACMPReportPath% directory. 7.2 Viewing results in the analysis window The analysis window provides a structured view of the check results. To analyze check results, you should basically proceed like this: Transcat PLM 38 xcompare V5 1.7.x

39 Analyzing the results Viewing results in the analysis window 1 In the xcompare main window, select and open a report. 2 Click an item in the Checks list to display the pairs of entities that have been formed for this check. You can filter the list of checks by check status. 3 The Pairs list contains lists all pairs of entities that have been checked by the selected check. Click an item in the Pairs list to display detailed results with respect to the selected pair and check. Depending on the selected checks or pairs in the analysis window, you can use built-in analysis tools to visualize the differences of pairs in various ways. Check status For each check, the check status is indicated by a color: Color Check status Green No differences No differences between reference and compare document Red Different Differences between reference and compare document in all pairs Grey Not checked No pairs of entities were found to which the check would apply Blue General error Check could not be performed, for example when one of the documents could not be read. Yellow Partly different Differences between reference and compare document in some pairs Multicolor Partly different or General error Differences or general errors in some pairs Cyan/Green Precheck with equal checksum Reference and compare document have equal check sums Cyan/Red Precheck with different check sum Reference and compare document have different check sums Pair check status For each pair of entities, the check status is indicated by a color code: Transcat PLM 39 xcompare V5 1.7.x

40 Analyzing the results Viewing results in the analysis window Color Check status Green Equal Matching entities, no differences Red Different Differences between matching entities Blue General error Check could not be performed, for example when one of the documents could not be read. Pairs of Entities In the analysis window, the Pairs list displays a node for each matching pair of entities that has been found. The name of the reference entity is shown left of the double arrow. The name of the compare entity is shown right of the double arrow. The pair node has a color bullet which indicates the pair s check status. If no matching counterpart has been found, a label No Compare element found or No reference element found is shown instead of the missing entity name. Where applicable, sub-elements are displayed with their respective color bullets, while the group element indicates the combined check result. Additional information is displayed when selecting branches without color bullets in the analysis tree. Opening an existing report in the analysis window The results of a check run are stored in a report file. You can display an existing report in the analysis window. 1 In CATIA, click the Run xcompare button on the xcompare toolbar. 2 Deselect the Use Document Names for Report Name option. 3 The list box contains the reports created in recent interactive and batch check runs. Select the report to be displayed from the list. Click Open Report to open the selected report. If the report is not listed, you can open a report file from the file system. Click Open report from file. Select the report file and click OK. 4 If neither the reference nor the compare model associated with the report is open in CATIA, you are prompted whether to open the models. The report is displayed in the analysis window. Transcat PLM 40 xcompare V5 1.7.x

41 Analyzing the results Viewing results in the analysis window Opening product component reports in the analysis window When comparing products that contain components, xcompare generates a report for the product and a separate report for each checked component of the product. You can open the component report while the product report is open in the analysis window. 1 Open the report of the product in the analysis window. 2 In the Checks list, select the Compare Product Components check. 3 In the Pairs list, mark the pair of components for which you want to display the report. 4 Click the Show report for product component button. The analysis shows the report for the marked pair of components. 5 To return to the report of the parent product, click OK. Visualizing geometrical differences with the Fine Analysis tool The fine analysis tool displays marking elements that visualize geometrical differences between reference and compare model. With the Fine Analysis button activated, click on a pair to display the marking elements directly in the CATIA geometry area. Example The image below shows the fine analysis marking elements for two bodies with different bounding boxes. Transcat PLM 41 xcompare V5 1.7.x

42 Analyzing the results Viewing results in the analysis window Using Enhanced Visualization Fine analysis marking elements are added temporarily and do not change the model. When selecting a different sub-node or when deactivating the fine analysis tool, the marking elements are cleared. To add fine analysis marking elements permanently, use the Create permanent marking elements button. Show fine analysis markings for selected pair button, page 47 Create permanent marking elements button, page 47 With the Enhanced Visualization tool, you can visualize geometrical differences directly in the active document window. 1 In CATIA, activate the document window in which you want to display the enhanced visualization. The active document window can be the reference or compare document window, or any other document window in the current CATIA session. 2 In xcompare, open the report to be displayed. 3 In the analysis window, select what to visualize: To show differences between a particular pair of entities, select a check, then select the pair of entites. To show all differences with respect to a particular check, select a check but no pair of entities. In this case, only fading will be available. 4 Click the Enhanced visualization button. 5 In the xcompare Enhanced Visualization dialog, you can select between the following visualization functions: Fading The selected reference and compare entities are shown as an overlay in the active document window. You can change transparency and color of the reference and compare entity. Transcat PLM 42 xcompare V5 1.7.x

43 Analyzing the results Viewing results in the analysis window Basic For the selected pair, differences of the respective other entity are visualized as points, triangles, or 3D faces in the active document window. In basic mode, enhanced visualization uses a fixed accuracy. Advanced For the selected pair, differences of the respective other entity are visualized as points, triangles, or 3D faces. In advanced mode, you can adjust the accuracy of the visualization with the Tolerance slider. To increase the accuracy of the visualization, set a lower tolerance value, then click the Update button. Examples of enhanced visualization, page 44 Reference to the Enhanced Visualization Window, page 48 6 To visualize other pairs or checks with the same enhanced visualization settings, click the Close button in the xcompare Enhanced Visualization dialog. When you select a check or pair in the analysis winrdow, the visualization is applied to the selection. 7 To disable enhanced visualization, deselect the Enable/Disable button for the respective visualization mode in the xcompare Enhanced Visualization dialog. Enhanced visualization is also disabled when you close the analysis window. Transcat PLM 43 xcompare V5 1.7.x

44 Analyzing the results Viewing results in the analysis window Examples of enhanced visualization Fig. 1: Fading Fig. 2: Points in basic or advanced visualization mode Fig. 3: Pairs of points in basic or advanced visualization mode Transcat PLM 44 xcompare V5 1.7.x

45 Analyzing the results Viewing results in the analysis window Fig. 4: Tessellation triangles in basic or advanced visualization mode Fig. 5: Pairs of tessellation triangles in basic or advanced visualization mode Fig. 6: 3D faces in basic or advanced visualization mode Fig. 7: 3D faces in basic or advanced visualization mode Transcat PLM 45 xcompare V5 1.7.x

46 Analyzing the results Reference to the Analysis Window 7.3 Reference to the Analysis Window The analysis window lists all checks from the check profile and the results for the pairs of models that have been checked. In the analysis window, you can also find tools for analyzing the compared models. NOTE: Some functions in the analysis window are not available if the reference or compare model are not open in CATIA. Center graph on selected pair button Automatically center the CATIA specification tree on the reference or compare entity of the selected entity pair. Zoom on selected pair button Automatically zoom the model in CATIA onto the reference or compare entity of the selected entity pair. Transcat PLM 46 xcompare V5 1.7.x

47 Analyzing the results Reference to the Analysis Window Show fine analysis markings for selected pair button Show marking elements for the selected entity pair directly in the CATIA geometry area. Visualizing geometrical differences with the Fine Analysis tool, page 41 Create permanent marking elements button Add a geometrical set containing all xcompare fine analysis elements to the active document (reference or compare document). The name of the geometrical set is xcompare-markup. Transparency button Use transparency to reveal covered elements in the CATIA geometry area. Model data remains unchanged; the display will be reset when closing the window. Show report for product component button Show the report for a product component. This button is only available when viewing the report for a product that has been checked with Compare Product Components, page 72. When comparing products that contain components, xcompare generates a report for the product and a separate report for each checked component of the product., page 41 Enhanced visualization button Display the Enhanced Visualization window with visualization options for reference and compare document. Reference to the Enhanced Visualization Window, page 48 Show captured images for report button Show the Show image window, where you can capture different images of the marked pair of components. To hide the Show Image window, click this button again. Capturing user-defined images for the external report, page 53 Reference to the Show captured image window, page 53 Show report in HTML browser button Generate captures of entities with differences (if required) and open the report in an HTML browser. Switch result viewer button If this button is not selected, results are arranged by check. Checks are listed in the left column. The respective checked pairs are listed in the right column. If this button is selected, results are arranged by pairs. Pairs are listed in the left column. The checks performed on these pairs are listed in the right column. Transcat PLM 47 xcompare V5 1.7.x

48 Analyzing the results Reference to the Analysis Window Info button Display general information about the check (configuration and profile name, model type, session settings, overall check status). Help button Currently not available. Checks list List of all checks that have been performed, as specified in the check profile. The color bullet with each item indicates the check status. Click an item to display the check details and the affected pairs of entities. Check status, page 39 Use the list box above to filter the checks list by check status. Pairs list List of the pairs of entities to which the currently selected check has been applied. The color bullet indicates the check status. Pair check status, page 39 Click an item to display the check details and the affected pairs of entities. If available, click a sub-node to display a detailed description for the given aspect. To filter the pairs list by check status, use the list box above. Details list box Click to display or hide the check or pair summary, or both. Check details text box Displays the check status and the check parameters specified in the check profile for the check selected in the Checks list. Pair details text box Displays the check status and lists the check results in detail for the pair of entities or a sub-node selected in the Pairs list. Keyboard shortcuts: Analysis window shortcuts, page 136 Reference to the Enhanced Visualization Window Enhanced visualization provides three visualization modes. The window shows different controls depending on the selected visualization mode. Transcat PLM 48 xcompare V5 1.7.x

49 Analyzing the results Reference to the Analysis Window Controls in all visualization modes (Fading, Basic, and Advanced) Fading button Click to show the selected reference and compare entities as an overlay in the active document window. Show difference Basic button Click to visualize differences between the selected reference and compare entity as points, triangles, or 3D faces in the active document window. Show difference Advanced button Click to visualize differences between the selected reference and compare entity as points, triangles, or 3D faces in the active document window. Enable/Disable... check box If this option is selected, the enhanced visualization is shown in the current window. If this option is not selected, the enhanced visualization is not shown. Set colors visualization button Click to show the Set color dialog, where you can select the color of reference and compare entities and the background colors of the reference and compare document windows. In Visualization, select the colors for marking elements of reference and compare entities. In Document background, select background colors for the reference and compare document. This helps to distinguish the two windows when viewed side by side. If the reference or compare document has been closed, click the respective Load document button to reopen the document. Modify graphic properties of equal features button Click this button to show the Equal features dialog, where you can change the appearance of pairs of entities that are identical: Transcat PLM 49 xcompare V5 1.7.x

50 Analyzing the results Reference to the Analysis Window To hide pairs of identical entities, select the Hide option. Deselect the Hide option to leave the visibility of pairs of identical entities unchanged. To change the color of identical entities, select the Color option and choose the color to be applied from the list box. Deselect the Hide option to leave the color of pairs of identical entities unchanged. CAUTION: These changes to visibility and color remain even after closing the analysis window. If you do not want to keep these changes, save pending changes to the model before using this function, and do not save the changed model afterwards. Fading visualization mode Close button Click to close the dialog. If an enhanced visualization is enabled, it stays active when the dialog is closed. To disable enhanced visualization, deselect the Enable/Disable button in the dialog. Transparency reference slider Use this slider to adjust the transparency of the selected reference entity. Transparency compare slider Use this slider to adjust the transparency of the selected compare entity. NOTE: A change in transparency is only visible with the following CATIA application setting: Transcat PLM 50 xcompare V5 1.7.x

51 Analyzing the results Reference to the Analysis Window In Tools > Options > General > Display > Performance, the Transparency quality option must be set to High. You have to restart CATIA for this setting to take effect. Show differences basic mode Show previous difference / Show all differences / Show next difference buttons If more than one different region is found in the pair of entities, you can show marking elements for this particular region or for all different regions by clicking the respective buttons. Show all differences button Select this button to show marking elements for both reference and compare entities in the active window. Deselect this button to show marking elements only marking elements for the compare entity if the reference document is active, or to show only marking elements for reference entity if the compare document is active. Tessellation points / Tessellation triangles / 3D faces buttons Select one of these buttons to show the differences in the respective other entity as points, triangles, or 3D faces, respectively. Create permanent marking elements button Select this button to add the currently displayed marking elements permanently to a geometrical set to the active document. This requires that the active document is either the reference document or the compare document. The name of the geometrical set is xcompare-showdifferences-markups. Transcat PLM 51 xcompare V5 1.7.x

52 Analyzing the results Reference to the Analysis Window Show differences advanced mode Show previous difference / Show all differences / Show next difference buttons If lmore than one different region is found in the pair of entities, you can show marking elements for this particular region or for all different regions by clicking the respective buttons. Show/Hide markings in pairs button Select this button to show marking elements for both reference and compare entities in the active window. Deselect this button to show marking elements only marking elements for the compare entity if the reference document is active, or to show only marking elements for reference entity if the compare document is active. Tessellation points / Tessellation triangles / 3D faces buttons Select one of these buttons to show the differences in the respective other entity as points, triangles, or 3D faces, respectively. Create permanent marking elements button Select this button to add the currently displayed marking elements permanently to a geometrical set to the active document. This requires that the active document is either the reference document or the compare document. The geometrical set is named xcompare-showdifferences-markups. Tolerance slider Use this slider to adjust the accuracy of the enhanced visualization. A small tolerance value corresponds to a high accuracy. Click the Update button to apply the changed tolerance. Update button Click this button to apply the tolerance setting. Transcat PLM 52 xcompare V5 1.7.x

53 Analyzing the results Reference to the Analysis Window Capturing user-defined images for the external report Images for the external report are captured in a default view. You can manually capture a different view to replace the default image. 1 If no images have been captured yet for the report, click the Show report in HTML browser button in the analysis window. 2 In the analysis window, click the Show captured images for report button. The dialog shows the current images for the selected pair of entities. No images are shown if the selected pair is equal, or if no images have been captured yet. 3 In the analysis window, select a pair of entities with differences. 4 In the respective document window, set the view of the entity to be captured. Make sure that you are using the correct document window. 5 In the Show capture image dialog, click the Capture image button for the reference or compare entity. 6 In the document window, drag a rectangle around the area that you want to capture. The new image has been captured. If you want to revert to the default image of an entity, click Capture default image for the reference or compare entity. Reference to the Show captured image window The functions in this window are available only when a pair with differences is selected in the analysis window. Capture custom image of reference entity button Click to change the captured image of the reference entity in the selected pair. Transcat PLM 53 xcompare V5 1.7.x