PlantSight Enterprise Help

To Aggregate Data Using Fuzzy Match

Often when merging data from other sources into the digital twin, there are acquired tags and classes that do not match up exactly to any project tags or classes in the digital twin. This could be due to different naming schemes, outdated information, or other reasons. PlantSight's Data Aggregation feature allows you to use a Fuzzy Match process to examine the data and either apply a user-determined confidence level, or let you define rules that find or create similarities in the datasets.

Follow these steps to aggregate data using the Fuzzy Match process.

  1. From the Data Aggregation grid, select the tag rows that you want to match. For example,
    Tip: If you want to examine a specific Class instead of all data, you can filter the Existing Class column to display only that Class.
  2. Click Match tags ( ). The Match Tags dialog appears. For example,
  3. Select one of the following:

    Auto Match: Allows you to automate matching up tags that are not an exact match by using a string search. The confidence level determines how closely the tags must match in order to be accepted.

    or

    Custom: Allows you to create rules based on regular expressions that manipulate a tag so that it is accepted.

  4. If you selected Auto Match in Step 3,
    1. Accept or adjust the confidence level using the slide control.
      Note: The matching operation concatenates the strings of the tag name and the existing Class for each object. If the EC Classes do not match for the same tag, there are no automatic matching results. For this type of situation, enable the Allow mismatched tag definitions option. For example,
    2. If you want to allow tag definitions that do not match, enable Allow mismatched tag definitions.
    3. Click Match Tags. A dialog displays how many selected items are successful matches based on the confidence level. There are entries in the Existing Tag column and the Existing Class column for each of the selected and matched items.
    4. Click Publish. A summary of the number of accepted and rejected tags appears.
    5. Enter a Description in the box.
    6. To publish the changes to the digital twin, click Publish. A progress bar appears.
  5. If you selected Custom in Step 3, the Match Tags dialog changes. For example, you can create a basic rule by doing the following:
    1. If no rules exist, click Create New Rule. The Match Tags dialog changes. For example,
    2. Enter the field for which you want to apply the rule (required).
      Note: This is a required field.
    3. To create a basic rule, select the parameter for which the rule applies, from the list. For example, you can select that you want to Ignore a specific prefix that exists on tags in the acquired data, otherwise go to Step 6 to create an advanced rule.
    4. Select the location that this string content would appear.
    5. Repeat Steps 5 (b) to 5 (d) for each Tag Matching Rule that you want to create.
    6. Click Match Tags.
      Note: You can click Save to save this rule for future use.
  6. If you selected Custom in Step 2, you can create an advanced rule by doing the following:
    1. Click Create New Rule.
    2. Click to enable Advanced Mode. The Match Tags dialog changes, for example,
    3. Enter the Regular Expression (also referred to as Regex), that is used to either locate a specific substring in a tag name, or segment the tag name.
      Note: This field is required.
    4. If you want to replace instances of the Regular Expression with alternate text, enter a Replacement String. For more information about defining a replacement string, see Using Replacement Strings.
    5. When you are finished, click Match Tags.
      Note: You can click Save to save this rule for future use.
    6. Repeat Steps 6 (a) to 6 (d) for each custom rule that you want to create.
  7. When you are finished, publish the data to the digital twin.