Verity Item Table

This article will cover the Analyze results in the Verity Item Table.

The Verity Item Table

Elements or scans added to Verity from the host project will appear in the Verity Item Table or Scans list.


Figure 1: Verity Item Table

After Analyze, selecting an item in the table will display that element’s geometry and relevant points in the Verity Viewer, which can be customized with Camera and Visibility settings. If Analyze has not yet been run, selecting an item in the table will only display the As-Designed (magenta) geometry. Displayed at the bottom-right of the item table is the total number of elements that were added to the current analysis.

Selecting a scan in the Scans list will clear the Verity Viewer and select the same scan location (Navisworks) or point cloud (Revit) in the host, but will not update the host view. Displayed at the bottom-right of the Scans list is the total number of scans brought in from the host.


Figure 2: Verity Bi-Directional Selection and Navigation.

When items are first added to Verity (before Analyze), the only populated fields in the Item Table are the ones that will not change based on analysis- Item Description, Geometry Surface Area, the X, Y, Z Locations, and Guid. The Guid listed is a unique Verity identifier and will not match the host identifier.

Once Analyze has been completed, most of the remaining fields in the Item Table are populated with the results of the Analyze algorithm.

Coverage

During the analysis, Verity calculates how much scan data covers the surface of each item. Verity reports this percentage in the Coverage column of the table as a decimal value (0.221 = 22.1%). This column helps to identify which items are most likely to be erroneously classified or fit by our algorithm so you can more easily find them and make the necessary corrections.

Installation Status and Conformance to Tolerance

Assuming all primary analysis steps were run, the following list includes the installation status and conformance to tolerance values you see in the Verity table for each item and what they mean:

  • Installed – Algorithm found a signature matching the geometry in the scan data.
  • Uncertain – Point data was inconclusive or contradictory for this item.
  • Occluded – Captured points obscured the geometry location, so we can’t tell what it is.
  • Not Found – Points would have been captured if the geometry was there, so it is missing.
  • Not Enough Data – There are insufficient points to analyze this item.
  • No Data – There were no points in the space around the item.
  • N/A – No as-built location was found, so not applicable.

For any items found to be Installed, Verity will compare the total translation against the tolerance to determine how each item conforms to that user defined tolerance. Conformance to Tolerance values can be:

  • Pass – Item was installed within the specified tolerance (less than or equal to)
  • Out Of Tolerance – Item was installed outside the specified tolerance (greater than)
  • N/A – Not applicable because the item wasn’t found to be installed

Translation Metrics

Translations are computed by taking every vertex on the As-Designed geometry and measuring the distance to the same vertex on the As-Built geometry. Those measurements are broken into vector components to isolate movements along individual planes or axes. The table reports the largest value for each element. (The diagram below illustrates this). All the measurements are taken, but only those underlined in red are published in the table. Most are taken from the top right corner of the beam, but the largest X translation occurs on the bottom right corner, and the largest Y translation occurs on the top left corner:


Fig 2: Translations and Metrics 3D View

  • Cross Axis Translation – Component vector on the plane perpendicular to the item’s long axis.
  • Long Axis Translation – Component vector along the item’s long axis.
  • Y-Axis Translation – Component vector parallel to the project Y-axis.
  • X-Axis Translation – Component vector parallel to the project X-axis.
  • Horizontal Translation – Component vector in the project XY plane.
  • Vertical Translation – Component vector parallel to the project Z-axis.
  • Total Translation – The linear distance between both points (used for conformance to tolerance).

The measurements made in the object’s coordinate system are not given a sign (+ or -) as that is highly subjective. Verity will assign measurements that are in the project’s coordinate system a sign when possible.

Rotation Metrics

Rotations are more complex to calculate, as different methods will yield different answers. Verity uses two different methodologies for calculating rotations based on whether the object is “typical” (anything but almost vertical) or like a column (vertical or nearly vertical). Almost vertical is when either the as-built or the as-designed is within 5 degrees of vertical (positive Z).

A) In most cases, Verity calculates the rotation from vertical and horizontal as the difference in inclination and azimuth (respectively) between the as-designed geometry and the as-built geometry. Rotations are determined by first rotating the geometry to change the inclination, then changing azimuth, with twist calculated as whatever additional rotation is needed around the long axis of the geometry to align to the as-built position.

B) In the case that the item is almost vertical, Verity calculates the rotation from vertical as the total angular difference between the as-designed and as-built geometry, with twist calculated as whatever additional rotation is needed around the long axis of the geometry to align to the as-built. In this case, the horizontal rotation will be calculated as 0 (zero).

This solution yields the most consistent results for building components in most cases. If Verity has incorrectly identified the long axis, then these calculations will not be relevant. This may happen in the case of beams or pipes with lengths shorter than their depth, for instance.


User-Defined Fields

In addition to the calculated fields above, the Verity Item Table also has several fields that you can fill out with whatever additional information you would like to include in the report:

  • Action Required – this field provides a place to note any next steps or actions that need to occur to come to a resolution about the item. Usually, this field populated with things like “Fix in the field” or “Update as-built drawings” or the names of people to get involved.

  • Notes – as the name suggests, this field is for a user to write down any additional notes about the item.

  • Reviewer – This lets you type in a name, initials, or anything else you might desire to indicate who has looked at the results.

  • Review Status – This lets you designate one of three pre-defined statuses for each item:

    • Not Reviewed
    • Under Review
    • Reviewed

Sorting the Item Table

The Verity Item Table can be sorted by any of its fields, making it easy to Review based on your project needs. There are many use cases for sorting by specific fields, like:

  • Sorting by Conformance to Tolerance to focus on Out of Tolerance or missing (N/A) items first.
  • Sorting by Total Translation to focus on large discrepancies between the As-Built and As-Designed geometries.
  • Sorting by the Geometry Surface Area column helps to identify small elements that you don’t need to analyze, or to group identical geometries together.
  • Sorting by Z Location to order items by their level.