When do I Need to Set Up Multiple Matches Resolution?

Multiple Matches resolution is used to decide what Appearance to apply to 3D Objects that have multiple associated values in the DataView, and so potentially multiple Appearances.

Multiple Matches Mode

BimSens can apply Colour Filters in 2 ways:

• In Standard Mode, BimSens loops through the values of the DataView, search for 3D objects associated to each value and assign an Appearance based on the Colour Filter settings. As a result, if an object has Multiple Matches, it can be picked up and change colour several times, the final colour being that of the last match.
• In Multiple Match Mode, BimSens loops through 3D objects, get all associated records in the DataView and apply a Multiple Match Resolution method defined by the user to extract the appropriate value.

In this mode, Multiple Matches can be resolved in 2 ways that can be used independently or in association:

1. Using Filtering that will exclude some matches based on a condition defined by the user, and
2. Using Aggregation, which calculate a summary value for all matches.

Filtering Multiple Matches

With the Filtering of Multiple Matches, a 3D object has Multiple Matches with different values, BimSens can be configured to only keep matches with a given value for a filtering property:

• Go to the MULTIPLE MATCHES tab
• Check the Multiple Matches Resolution and the Filter results and only take Matches where boxes.
• In the menu below, select the Property of the DataView to filter and type a Value to filter on. 

If the filtering returns only one result, the 3D object will be coloured accordingly.

In some cases however, the 3D object can still have Multiple Matches respecting the filtering condition, in which case BimSens then applies the Aggregation method to calculate a summary value.

Calculating Summary Value of Multiple Matches

With the Aggregation methods, when a 3D object has Multiple Matches with different values, BimSens can be configured to calculate a summary value and apply an appearance based on this value. Aggregation can be used alone or in combination with the Filtering of Multiple Matches.

• Go to the MULTIPLE MATCHES tab
• Check the Multiple Matches Resolution box
• In the When there are Multiple Matches section select the Aggregation Method to use:

• Apply Special Appearance, to apply the specified appearance to that object. Avoid using the same appearance as one of the reference value.
• Count, to use the count of Multiple Matches as a value for that object. This method can be used with a gradient to audit a model for Multiple Matches.

• Sum, to use the sum the values of all Matches. This method is only available for numeric properties. It is recommended to use the Gradient mode as the result of the sum can be a value that is not one of the Reference Value.
• Average, to use the average of all the values. This method is only available for numeric properties. It is recommended to use the Gradient mode as the result of the average can be a value that is not one of the Reference Value.
• Minimum, to use the minimum value of all Matches. There is no restriction in using that method, but when applied to a text property it returns the first value in alphabetical order.
• Maximum, to use the maximum value of all Matches. There is no restriction in using that method, but when applied to a text property it returns the last value in alphabetical order.
• Value of Match with Minimum..., to use the value of the Match that has the minimum value for another property that you specify. This method can be used to resolve Multiple Matches of a text property when each text value has a rank (different from alphabetical order).
• Value of Match with Maximum..., to use the value of the Match that has the maximum value for another property that you specify. This method can be used to resolve Multiple Matches of a text property when each text value has a rank (different from alphabetical order).

For an example of Multiple Matches resolution see the Look ahead walk through.