Creating Tags in Cintoo

Modified on Wed, 19 Feb at 4:19 PM

TABLE OF CONTENTS

Create a Tag List
Create a Tag
Duplicate a Tag
Import a List of Tags

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 to first set the viewpoint in the 3D View to look at the element to be tagged. Both Scan & Teleport and 3D Navigation modes are supported for tagging.

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. Click on the "+" sign next to the Bounding box field. A representation of the tag will appear below. Viewport is now in the Boundary box edit mode which is indicated below navigation bar. Now cursor of the mouse is moving along with a bounding box

Note: to have only the current bounding box in the viewport the Tag list in the Tag Explorer could be put in the mode Hide.

It's possible to add more bounding boxes by clicking on the "+" sign next to the Bounding box field.

Adding additional bounding boxes converts a simple tag into a complex tag, which changes the icon. More information on complex tags could be found here: Tag Explorer.

9. Click once in the 3D View to place the bounding box and display the gizmo. After that the point of view or the display mode (e.g. 3D Surface, 3D RGB, etc.) could be changed to have a better understanding of the equipment’s form and size. For example, switch to 3D Surface in 3D Navigation.

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.

12. Clicking on the Create another leaves the right panel for tag creation process open but resets the fields.

13.Once created the tag appears in the corresponding tag list.

14. To edit the tag click on the tag and then click on Edit at the bottom of the Tag Explorer. The menu on the right opens, allowing to adjust the bounding box. There is also a possibility to mark several bounding boxes from the same view by clicking additionally on the "+' sign next to the Bounding box field, which creates a complex 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 duplicated 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 opens the Import Tag List panel on the right side of the screen.

4. Select a CSV or Excel file and click Import. This will populate the tag list automatically.