Creating Tags in Cintoo

Modified on Mon, 25 Nov at 10:45 AM

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 tagged elements.

4. Add a description, which can be regular text or a hyperlink.

5. Add your custom metadata (up to 20 custom fields). 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"

6. Click Create to save the Tag List.

Create a Tag

Manual tagging in Cintoo consists of using the bounding box tool to demarcate the equipment in the 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.

If there are no Tag Lists displayed in the Tag Explorer, see Create a Tag List section above.

3. Click ‘Show’ (check box) to toggle on the Tag List visibility. Clicking on ‘Show’ will ensure 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 (highlighted in blue), 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 column headings provided in your CSV file (e.g. a CSV column with heading "Manufacturer" must be included as a Cintoo metadata field called "Manufacturer").

A column with heading "ID" must be included in the CSV
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 the Tag Explorer, click the ‘Import Tag List’ icon from the list of actions at the bottom of the Tag Explorer panel.

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 on the right side of the screen.

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.