TABLE OF CONTENTS
- Create a Tag List
- Create a Tag
- Duplicate a Tag
- Import a List of Tags
- Automatic Tag Detection and Classification with Cintoo AI
Create a Tag List
1. Hover the mouse cursor over the menu icon in the top right corner of the Cintoo interface and select ‘Create Tag List’ from the drop-down menu.
2. Enter a name for the tag list.
3. Select a color for the tags. In the 3D View, this color will be applied to all tags in the list.
4. Add a description, which can be regular text or a hyperlink.
5. Add your custom metadata (up to 20 custom fields).
6. When naming your tag metadata fields, avoid spaces in the metadata field name, and avoid reserved keywords such as:
- "id"
- "subId"
- "name"
- "boundingBox"
- "orientedBoundingBox"
- "model"
- "class"
- "cameraState"
- "unit"
- "functionalSystem"
- "description"
- "confidence"
- "scanUuids"
- "needValidation"
- "nature"
- "customFields"
- "metadata"
Create a Tag
Manual tagging in Cintoo consists of using the bounding box tool to demarcate the equipment in 3D View, and setting the tag ID and metadata manually.
1. Go to 3D View and open the Tag Explorer from the vertical tool bar.
2. In the Tag Explorer, select a tag list by clicking on the name of the list.
3. Click ‘Show’ (check box) to display the tags in the 3D View. Clicking on ‘Show’ will display the tags for this list in the 3D View but it does not mean that you have selected this list of tags. Both clicks (select Tag List + 'Show') are mandatory.
4. Before creating a tag, it is recommended that you first set your viewpoint in the 3D View to look at the element to be tagged. You can be in ‘Scan & Teleport Mode’ or ‘3D Navigation’ mode.
5. With the Tag List selected, click ‘Create Tag’ from the list of action icons at the bottom of the Tag Explorer.
*Note that the same actions are also available from the DATA tab.
6. The 'Create tag' dialogue will appear on the right side of the screen. Make sure the correct Tag List is indicated at the top.
7. Fill in the ID and Description fields.
8. Once you place your mouse in the 3D View, you will see a bounding box appear, which you may place close to the equipment to be tagged. Note that you can use the mouse scroll wheel to preadjust the size of the box.
*If the bounding box does not appear, see Step 3 in these instructions.
9. Click once in the 3D View to display the gizmo. You may change the point of view or the display mode (e.g. 3D Surface, 3D RGB, etc.) to have a better understanding of the equipment’s form and size. For example, switch to ‘3D Surface’ in 3D Navigation in this case:
10. Use the gizmos to adjust the bounding box to the equipment:
- Click & drag the cubes to adjust the faces of the bounding box
- Click & drag the lines to move the bounding box along each axis.
- Click & drag the curves to rotate the bounding box along each axis.
11. Fill in all metadata fields as needed and click ‘Create’ The view used for the creation of the bounding box (in Scan & Teleport Mode or in 3D Navi mode) will be the default view for this tag.
Duplicate a Tag
1. Select a Tag in the Tag Explorer.
2.Click ‘Duplicate Tag’ in the list of available actions.
3. This will open the Duplicate Tag panel, prefilled with the information from the Tag selected in Step 1 of these instructions.
4. You may then simply move the bounding box with a simple translation. Click Duplicate to create an save the duplicate tag, or click Duplicate Again to save the duplicate tag and create another copy.
Import a List of Tags
You can get a list of tags from your Digital Twin or from your Revit or Navisworks model via a simple CSV file that contains the ID of each piece of equipment, their location, and various other metadata according to the tag data model that you have set initially when creating this list of tags.
These tags from your Digital Twin or CAD model will then be displayed as bounding boxes overlaid on the scans, with the possibility to edit each box to match the reality, or to edit the list to add more metadata.
1. When creating the tag list (see Creating a List of Tags section above), make sure the metadata fields in the Tag List match exactly the metadata fields provided in your CSV file. Note that the metadata fields in Cintoo do not need to be in the same order as the columns in your CSV file.
2. Once the corresponding list has been selected in your Tag Explorer, click ‘Import Tag List’ from the list of actions related to this list:
*Note that the same actions are also available from the DATA tab.
3. Clicking on ‘Import Tag List’ will open the Import Tag List panel.
4. Select your CSV or Excel file and click Import. This will populate your tag list automatically.
Automatic Tag Detection and Classification with Cintoo AI
Cintoo's AI Engine replaces the cumbersome manual tag search in your scan data with an automated, faster, easier, and more accurate approach.
Based on a Deep Neural Network engine and modern computer vision algorithms, Cintoo's AI Engine allows users to automatically geolocate and classify tags in the 3D scans. Cintoo's AI Engine is tailored to the industrial customers’ requirements and the important objects they need to identify for their specific applications.
For example, Cintoo's AI Engine can readily detect common Industry 4.0 objects such as valves, flanges, electric motors, electric devices etc. The Cintoo AI Library contains a large set of real use-case content that has been manually annotated and includes at least seven different categories of tags. This customized list of assets is continuously enhanced and updated according to customer requirements.
Example categories of tags:
- Electric Motors
- Valves (Handle Actuator)
- Valves (Hand Wheel Actuator)
- Flanges
- Electric Boxes
- Control Boxes
- Manometers
- Filters
- Pressure Regulators
- Slam Shut Valves
1. In 3D View, select the Work Zone that contains the scans to use for the AI detection process.
* Note that the current AI Engine will search tags in a maximum of 500 scans simultaneously, so you may have to organize your scans accordingly.
2. Using the Tag Explorer, select the list that has been created for this search. (If no lists are present see Create a List of Tags section above)
3. With the Tag List selected, click AI Detection in the list of available actions.
4. Select the tag class(es) to be automatically detected for this list and click Detect.
The online detection process benefits from bidirectional translation between 3D point clouds and 2D display modes (RGB, surface map, intensity map). Using cloud computing, the online detection process runs very fast, around 45 seconds for a 40-million-pixel scan. You will be notified by email when the search is complete.
*Note that there can be only one AI search process at a time on a given project. If one AI search has started already, you will be notified with "Tag List has Pending AI Jobs" message.
5. Once the search process is complete, you need to go through the validation step. Each tag detected automatically comes with a confidence metadata that can be found in the Properties. Each tag created by AI Detection also automatically comes with the status ‘Validation Needed’.
6. Select ‘Go To’ to view the selected tag in the closest scan location computed by Cintoo Cloud.
You may manually edit this selected tag to add metadata or adjust the bounding box, by clicking on ‘Edit’ in the list of possible actions for this tag.
7. Click Validate to validate the tag, or click Delete to remove the tag.
8. Repeat Steps 5-7 for each tag in the list to be validated.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article