Creating Tags in Cintoo

Created by John Tapia, Modified on Tue, 12 Nov at 9:56 AM by Nikita Barnev

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

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 and 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 Create a Tag List 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

Full description of this functionality could be found here.