powered by CADENAS

Manual

Manual

3.1.15.2.  Duplicate Analysis

With the Duplicate Analysis, you can search a selected directory for duplicates.[120]

  1. Call

    In the index tree, click on the context menu command Analysis -> Create duplicate analysis....

    -> The same-named dialog box is opened.

  2. Setting options

    Perform the desired settings.

    • Search type: Geometric | Textual

      A duplicate analysis can be performed on a geometrical or textual base.

    • Report name: In the input field, enter the desired name.

    • Search template: Select the option Duplicate search.

    • Minimum similarity in %: Determine the minimal tolerated similarity. Default is 98%.

    • Maximum number of search result: Hereby you can limit the displayed results. It does not affect the search itself.

    • Size-dependent: This option should be activated by default.

    • Filter mirrored parts: When activating the option, mirrored parts are filtered.

      Example: Mirrored parts

      Example: Mirrored parts

    • Ignore duplicates in same project: May be there are parts with the same geometry within a part family, but with other properties like color for example.

    • Variable filter: This dialog area can be optionally activated.

      When using the geometrical search, the option Search variables all together can be used in addition. When using the textual search, the options Ignore blanks, Ignore multiple references, Ignore hidden variables and Search variables all together are possible (see below).

      The variable filter is versatile: In the input field, both variables of the link database and class attributes can be entered. Multiple selection is also possible. Then entries are separated by comma.

      When clicking on or all relevant options are displayed in a list field and so can directly be selected.

      1. For Parts Management, when using the duplicate search, the consideration of material, for example, is important.

        Select variable of link database

        Select variable of link database

        Following figure shows the result list without using the variable filter. The marked hit is not a duplicate due to the difference in material. Once the variable filter is set (with respective value, here in this example "MAT_NAME"), this hit will not arise in the result list anymore.

        Same geometry but different material

        Same geometry but different material

        However, there are also cases where unequal values indicate a duplicate.

        [Note] Note

        When using an exclamation mark ! before the variable name, the values must be different in order to be recognized as a duplicate.

        Use cases

        • Example 1

          Part1.Material = Steel
          Part2.Material = Steel

          ➝ This is a duplicate.

          Part1.Material = Steel 
          Part2.Material = Wood

          ➝ This is not a duplicate.

          In this case the variable filter is set to MATERIAL. (The entry in the table column "Material" must be the same in order to be recognized as duplicate.)

        • Example 2

          Part1.Filename = xy123.prt
          Part2.Filename = xy123.prt

          ➝ This part is NO duplicate. It only has been saved twice with the same name. So it should be excluded from the result list.

          In this case the variable filter is set to !FILENAME. (The entry in the table column "Filename" must be unequal, in order to be recognized as duplicate.)

      2. For Part Modelling a duplicate check with regard to wrong or double class attributes like especially Order number and Typecode is possible and namely independently from the concrete variable name. Similar applies for other object attributes. Also see below under Search variables all together.

        Select class attributes

        Select class attributes

      Additional options

      • Ignore blanks (only for textual search)

      • Ignore multiple references (only for textual search): It's about link projects here.

      • Ignore hidden variables (only for textual search)

      • Search variables all together: All variables entered in the input field are searched. (Several variables separated by comma.)

        This function can both be used in the field of Parts Management and in the field of Parts modelling:

        • Parts Management

          For example, if the material is set under two different variables, of course they should be searched all together.

          Example

          Two variables: A,B

          Without activation of the option is means:

          Part1.A = Part2.A AND Part1.B = Part2.B (Variable A must be identical in part 1 and 2 AND variable B must be identical in part 1 and 2.)

          With activation of the option is means:

          Part1.A = Part2.A OR Part1.A = Part2.B OR Part1.B = Part2.B OR Part1.B = Part2.A

          (It is sufficient if one variable-part combination matches.)

        • Parts modelling

          Use case A

          Without activation of the option parts with same Order number or same Typecode are recognized as duplicates.

          Use case B

          If erroneously sometimes Order number and sometimes Typecode had been set (although, for example Order number should have been set, the duplicate check is useful anyway with activated option. Then with same value it's a duplicate, regardless of whether be found under Order number or Typecode.

      [Note] Note

      A list of synonyms can be stated under $CADENAS_USER/reports.cfg.

      Example:

      [Synonyms]
      8.8=St37, St 37

      These synonyms are checked for LinkDB variables and table variables.

    • Topology filter:

      The geometrical search, which is the base for duplicate analysis, does not consider details like different hole pattern. So in some cases 100% similarity is displayed, which is not correct.

      With Topology filter you can specify that, for example, the hole pattern of search part and result part have to match.

      Example:

      At Linear pattern select Distance X and Distance Y. Now parts with different hole pattern are not listed as duplicates anymore.

    • Filter:

      In the dialog area Filter you can further restrict results. Available filters are Variables search and Topology search. The functions can be used several times by clicking on Add search function.

      [Note] Note

      The filter concerns result parts not search parts.

      Example: If you only want parts with holes in result, specify a search with Hole -> Amount > 0.

      The functionality is according to the standard search functions:

    • Search only in preferred rows

      You can also create a report based on preferred parts. Therefor activate the checkbox. This is comparable to the button Preferred rows on/off in the ERP toolbar. Then the report only uses preferred parts.

      [Note] Note

      The state of the button Preferred rows on/off , in the ERP toolbar, has no effect for reports.

  3. Result

    Finally confirm with a click on OK.

    Once the analysis is finished, the result is automatically displayed on its own tabbed page. The tab label (here "Duplicate Analysis") is analogously to the entered name in the settings dialog.

    [Note] Note

    The percent value on the respective main row shows the degree of similarity of the best found result part.

  4. Search part

    In order to find results you can use the search function.

    Details on this can be found under Section 3.1.15.3.4, “ Search part ”.

  5. Mark and Filter

    Optionally, you can mark duplicate suggestions. Afterwards you can set respective filters.

    Meaning of the single icons:

    Mark Filter
    • This part is a duplicate

    • This part is not a duplicate

    • This part has to be analyzed

    • Remove mark

    • This part is a duplicate

    • This part is not a duplicate

    • This part has to be analyzed

    • Show unmarked Elements

    Example:

    1. Select the desired row.

    2. Under Mark, click on the icon This part is a duplicate.

      -> The icon is displayed on the left side of the selected row.

    3. Now, when enabling the filter This part is a duplicate and the others disabling, in the result list only parts marked as duplicate are displayed.

  6. Part comparison and further options

    After mouseover on a row further functions are available optionally:

    You can load parts into the part comparison, open in the PARTdataManager 3D view or export into the CAD.

    You can load parts into the part comparison, open in the PARTdataManager 3D view or export into the CAD.

    When clicking on the button Compare with all search results, the search part and all result parts below are loaded into the part comparison.

    Parts in part comparison

    Parts in part comparison

    For details see Section 3.1.15.3.5, “ Part comparison and different functions”.

  7. Export

    Optionally, you can export the results in HTML, CSV or PDF format.

    Details on this can be found under Section 3.1.15.3.8, “ Export ”.



[120] For the Duplicates Report the license PSADDONS*GEO_DUPLICATE_ANALYSIS is required.