Comparing and Reviewing Parts

This task shows you how to:

Check the Prerequisites

  1. Make sure you are starting Compare & Review on CATParts with no review feature.

  2. Check that SUN Java plug-in 6 update 10 is available.

  3. Check that one of the following browsers is available:
    • Under Windows: IE6, IE7 and Firefox 3.0,
    • Under Unix: Firefox 3.0

  4. To generate the HTML report, use the Environment Editor to set the following environment variables(compulsory). See Customizing Your Environment on Windows in the Installation & Deployment User's Guide.

    • CATReport={path of CATReport directory}
    • CATTemp={ path of CATTemp directory}
    • CATInstallPath={ path of intel_a directory}
    • JavaROOT_PATH={directory path of java virtual machine}
    This directory must include a sub directory "bin", where the java.exe file is stored.
  5. In Internet Explorer, select Allow Block Content in order to run java scripts.

  6. By default, the File Selection dialog box lets you open files on disks.
    To open documents already loaded in your session:

    • Go to Tools > Options > General > Document > Document Environments.
    • Set Loaded document to Allowed.
 

Compare

  1. Open the first (Old) CATPart (PanHandle1.CATPart from the samples directory).

  2. Click Compare & Review .

  3. In the File Selection dialog box that appears, select the second (New) CATPart (PanHandle2.CATPart from the samples directory).
    The Compare Parts dialog box is displayed.

  4. Set the parameters. Those parameters are modal.

    • the Distance, i.e. the distance below which two points are considered as identical.
    • the Method,
      • Quick: the comparison is fast, but:
        • some differences may be missing,
        • area borders are rough.
      • Detailed: the comparison takes longer, but the quality of the result is higher.
    • if necessary, the Detailed options to compute the mesh used for the comparison:
      • User Parameters lets you enter the Sag (chordal error) and Step (maximum length of the edges of the meshes) values.

        A small value of Step will create a mesh with many triangles, and thus increase the quality of the comparison but is time-consuming.
        Sag applies to models with curvatures.
        A small value of Sag in those models will create a mesh with many triangles and thus increase the quality of the comparison but it is time-consuming.
      • The meshing starts with the Sag and Step values you have entered, but the command may use other values to optimize the meshing.
      • When you choose an automatic meshing mode, the command computes the Sag and Step.
  5. Click OK.
    Progress bars are displayed and the comparison can be interrupted.
    The command computes a list of areas seen from the Old model and a list of areas seen from the New model.
    In general, a modification is made on an area from the Old model and an area from the New model. In some cases, a modification contains only one area, e.g. when a hole has been created in the New model.

    A new CATPart MergeResult is created.

The algorithm which groups areas from Old and New models can fail when the areas are too different. This can happen when the meshes are not precise enough (Quick mode) and/or the distance parameter is too large (Distance parameter = 0.02mm and geometry modifications to detect are around 0.02mm).
 

Review

 

List the Modifications

  1. Go to the CATPart MergeResult.
    Identical areas are blue, removed (Old) geometry is red and added (New) geometry is green.

  2. Double-click the feature CompareReview in the specification tree.
    The Compare for Review dialog box is displayed:

  3. Choose what you want to see:
    • Old Only: shows only removed areas (red),
    • New Only: shows only added areas (green),
    • Both: shows removed and added areas.

  4. Filter the modifications:

    This filter does not impact the final HTML report.

  5. Transparency helps the visual comprehension. Use the slider to tune the transparency level.
    Note that Transparency is applied to identical geometry only.

  6. In the list of modification, you find:
    • The identical areas. This item is the first which appears in the HTML report.
    • The name of the modifications. The default name is Modified.xx. This name is editable.
    • The value of the maximum deviation.
      This value is always greater than or equal to the distance comparison.
      The unit is the unit of the session.
      For identical areas, this value is lower or equal to the distance comparison.
    • The status of the modification:
      • Not inspected (default value): means that you have not given a status for this modification.
      • OK or KO: means you have analyzed the modification.
        The modification will appear in the HTML report.
      • Ignored: means you have analyzed the modification and found it to be non significant.
        This modification will not appear in the HTML report.
      • Adding information, e.g. a comment, a camera or an annotation, on a modification does not change its status.
    • The comment associated to the modification.
      The comment is editable.
      It appears in the HTML report.

  7. Inspect the modifications:

    • Select a modification in the list or in the specification tree, this modification is highlighted.
      The modification is displayed with its triangles.
      The review annotations of this modification are displayed.
      The default camera of this modification is activated.
    • If you create review annotations, they will be aggregated to the current activated modification.
    • Preselection does not modify the dialog box.
    • If a modification if filtered out, it is not displayed in the list.
  The tools described below will help you inspecting the modifications.
 

Use the Contextual Menu

  1. Right-click the list to start the contextual menu and change the status of one or all items.
    You can also:
    • Reframe On Default, i.e. reframe on the default camera which was initially computed by the system.
    • Invert Default Camera if the other side of the model is more meaningful.
    • Reframe On a new camera you have defined.
      This item is greyed if no additional camera has been defined.
    • Add Camera in order to add a new view point in the HTML report for the selected item.
    • Display Color Scale, i.e. switch from one color display

      to color scale display mode.
    • Edit Properties lets you
      • Edit the current comment.
      • Change the name.
      • Change the status.
      • Display a color scale.
      • Reframe the default camera.
      • Reframe on an added camera (double-click or right-click).
      • Remove a camera (right-click)
    • In some cases, reframe on the default camera shows the wrong side of the modification or the modification may be hidden by other geometries (you cannot see the highlighted geometry). You need to invert the default camera or modify the current point of view and create a new camera.

 

Use the Color Scale

  1. Either right-click a modification in the Compare for Review dialog box and select Display Color Scale, or double-click a modification in the specification tree and select the Display Color Scale check box in the Modification Properties dialog box.

    • In the 3D viewer, the current modification is displayed with a color map.
    • The location and value of the maximum distance on the current modification appears as a red label.
    • The Color Scale dialog box opens.
    • Lower variations are blue while higher variations are red.
    • Note that the color scale depends on the modification and its maximum deviation.
      As a consequence, two modifications with different maximum deviations will have different scales.

    Either select Display Color Scale in the contextual menu again or clear the Display Color Scale check box to revert to the standard color display.

 

Check the Information

  1. Go to the Information tab to check:

    • The color of the identical, added (New) and removed (Old) areas.
      Double-click the colored square to modify the color.
    • The tolerance of the comparison.
    • The number of areas (added, removed, identical).
    • The distance threshold for comparison and the number of Reported, Ignored and Not inspected modifications.
 

Create Annotations

  1. Click to add an annotation.

    • Select Identical.0: the annotation will be created under this node.
    • As you pass the cursor over the model, a cross appears.
    • Pick to position the annotation. A green patch appears.
    • Drag it to where you want to position the label and click.
    • A dialog box appears.
    • Click OK. The annotation is created.
 

Create Distance Annotations

 
  1. Create a distance between two points annotation:

    • Select Modified.1. The distance between two points annotation will be created under this node.
    • Click .
    • Pick a first point. A green label Computed distance=0 appears.
    • Pick a second point. The distance between the two points is computed and the label is updated.
    • Drag the label where you want to position it and click.
    • The Text of Annotation dialog box appears.
      Enter your comment and click OK.
      The annotation is created.
 

Create Deviation Annotations

  1. Create a deviation annotation:

    • Select Modified.1. The distance between two points annotation will be created under this node.
    • Click .
    • As you pass the cursor over the model, a green label is displayed with the deviation found.
    • Pick the point where you want to compute the deviation.
    • Drag the label where you want to position it and click.
    • The Text of Annotation dialog box appears.
      Enter your comment and click OK.
      The annotation is created.
 
  • To delete a review annotation, right-click it in specification tree and select Delete in the contextual menu.
  • To change a graphic attribute on a review annotation, right-click it in specification tree and select Properties in the contextual menu.
  • To modify a review annotation, double-click it in the specification tree. You can change the user text and its position.
 

Generate the report

  1. Create the HTML report:

    • If all the modifications have not been inspected, the html report may not be accurate.
    • Click . The HTML report is generated in the CATReport directory and opens automatically.

    In the HTML report, you will find:

    • A main section including general information generated by the system :
      • Name of the review.
      • Date of creation the review.
      • Date of creation the report.
      • User name of the last reviewer.
      • Comparison method (Quick or Detailed) and parameters.
      • Number of OK and KO area groups.
      • Number of Ignored area groups.
      • Maximum deviation.
    • The list of OK (in green), KO (in red) and Ignored groups (in orange):
      • For each OK, KO or Ignored area groups:
        • The name of group,
        • The comment of the group,
        • The maximum deviation of group,
        • The list of cameras with 2 snapshots of the comparison with local annotations.
          • One with Old geometry.
          • Another with New geometry.
          • Note that in this display mode, the transparency is not applied.

          Each camera is applied on both models
          There is always at least one camera, the default camera.

        • The list of local annotations with their text.

    Note that, when used, the color map is displayed in the report, but not the color scale dialog box.

    It looks like this:

     

Clicking an image enlarges it in another window.

Changes regarding visibility (show/no show) impact the model objects and therefore images of report. Any element in no show will be not visible in all images where it is present.

In the Knowledge Base
Issue with positioning of graphical representations of Surface Connection Checker