Creating Tags in Cintoo

This article describes the process of tag creation in Cintoo, as well as different actions that could be performed upon tag and tag lists in Cintoo project.

TABLE OF CONTENTS

Note: unlimited tagging capacity is available only with TWIN edition, while BIM edition users do not have access to this functionality.


Contact us via sales@cintoo.com to know more about the upgrade. 

Learn more about editions BIM and TWIN.

Create a Tag List

1. Click on Add drop-down menu in the top right corner of the Cintoo interface and select Tag list.



2. Enter a name for the tag list.


3. Select a color for tags. In 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 custom metadata (up to 20 custom fields). When naming tag metadata fields, avoid spaces in 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 Tag List.

Create a Tag


Manual tagging in Cintoo consists of using the bounding box tool to demarcate the equipment in 3D View and setting tag ID and metadata manually.

 

1. Go to 3D View and open Tag Explorer from the vertical tool bar.


2. In Tag Explorer, select a Tag List by clicking on the name of the list.

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


3. Click Show (check box) to toggle on Tag List visibility. Clicking on Show will ensure display the tags for this list in 3D View, but it does not mean that this tag list is selected. 

Both clicks (select Tag List + Show) are mandatory.


4. Before creating a tag, it is recommended to first set the viewpoint in 3D View to look at the element to be tagged. Both Scan & Teleport and 3D Navi modes are supported to capture default tag view.


5. With a Tag List selected (highlighted in blue), click Create tag from the list of action icons at the bottom of Tag Explorer.


Note that the same actions are also available from Data tab.


 

6. 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 ID and Description fields.


8. Click on "+" sign next to Bounding box field. A representation of the tag will appear below. Viewport is now in 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 Tag list in Tag Explorer could be put in Hide mode.



It is possible to add more bounding boxes by clicking on "+" sign next to 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 3D View to place the bounding box and display gizmos. After that point of view or 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 Navi.

 

10. Use gizmos to adjust the bounding box to the equipment:

  • Click & drag the cubes to adjust 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 Create another leaves the right panel for tag creation process open but resets the fields.


13. There is also a possibility to mark several bounding boxes from the same tag by clicking additionally on "+' sign next to Bounding box field, which creates a complex tag.


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


15. To edit the tag, click on it and then click on Edit at the bottom of Tag Explorer. The menu on the right opens, allowing to adjust the bounding box or add additional ones to create a complex tag.

Duplicate a Tag


1. Select a tag in 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. Enter an appropriate ID for a tag duplicate.



4. It is possible to 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 Tag List

 

Get a Tag List from a Digital Twin or from a Revit or Navisworks model via a simple CSV file that contains the ID of each piece of equipment, their location (x, y, z coordinates), and various other metadata according to the tag data model that was set initially when creating this list of tags.


These tags from a Digital Twin or CAD model will then be displayed as bounding boxes overlaid on scans, with a possibility to edit each box to match reality, or to edit the list to add more metadata.


1. When creating a Tag List (see Create a Tag List section above), make sure metadata fields in the Tag List match exactly the column headings provided in the 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 the CSV file. But they need to be present to be populated correctly.


1.1. (optional) It is possible to change the default size of the bounding box by adding a column named size. A value of 0.1 corresponds to a 10cm x 10cm bounding box.


2. Once the corresponding list has been selected in Tag Explorer, click on Import tags from CSV from the list of actions at the bottom of Tag Explorer.


Note: that the same actions are also available from Data tab. 


 

3. On the right-side Import tags from CSV panel is opened.

 

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