Configure tags and camera views - johnnyw-aws/aws-iot-twinmaker-samples GitHub Wiki

This topic describes how tag equipment in your AWS IoT TwinMaker scene, and how to add a fixed virtual camera view for that equipment.

Prerequisites

Before you are able to tag or add cameras make sure you have the following prerequisites:

  1. An AWS Account and the necessary permissions to use AWS IoT TwinMaker. If you already have AWS IoT TwinMaker set up, you can proceed to the next section. Otherwise, follow the instructions to set up an account and configure authentication.

  2. You have created an AWS IoT TwinMaker workspace. For more information on workspace creation read the workspace creation topic.

  3. You have created a scene within your workspace. For more information on scene creation, read Creating and editing AWS IoT TwinMaker scenes documentation.

Goals

"I want to tag equipment in my scene, and add a fixed virtual camera view for that equipment."

Once you have placed equipment into your scene, you can use AWS IoT TwinMaker features to organized and interact with the digital twins of your machinery and equipment.

Scene Tags

Tags associates the data with a location. A tag is an annotation added to a specific x, y, z coordinate position of a scene. The tag connects this scene part to the knowledge graph by using an entity property. You can use a tag to configure the behavior or visual appearance of an item in the scene, such as an alarm.

Fixed Cameras

Scene cameras, are virtual cameras that provide a fixed view of an element or piece of equipment in your scene. Set up scene cameras to allow your factory operators to efficiently locate and observe the status of particular piece of equipment. Scene cameras are also useful in isolating key parts of your scene. For example, you may have an entire industrial facility mapped out in a scene. If you want to only look at critical equipment within that scene, you can set up fixed cameras, which for quick easy access those key pieces of equipment.

For more information on scene features and editing, read the Scene enhanced editing topic in the official AWS IoT TwinMaker documentation.

Tag your equipment

Use the following procedure to add a fixed camera view:

  1. Navigate to your scene in the AWS IoT TwinMaker console.

  2. In the scene hierarchy menu, select the element you want to tag. select-element-scene

  3. Press the + button, and select the Add tag option.  This will apply an icon to your mouse cursor in the scene. tag-option ion.png)

  4. Mouse over the equipment or element in your scene you wish to tag and select it. This action will place a tag on the object.

  5. In the right side inspector window, configure your tag according the to the available options. tag-config

  6. You now have tag associated with your equipment.

Add a fixed camera view

Use the following procedure to add a fixed camera view:

  1. Navigate to your scene in the AWS IoT TwinMaker console.

  2. In the scene hierarchy menu, select the element you want to attach the camera to. select-element-scene

  3. Press the + button, and from the drop down options select Add camera from current view. To apply a camera with the current perspective to the entity. camera-option

  4. In the inspector, you can configure your camera and adjust the following settings:

  • A camera Name
  • The camera position and rotation
  • The camera focal length
  • The zoom level
  • Near and Far clipping planes camera-config

  1. To access your camera after you have placed it. Select the entity you added the camera to in the hierarchy. Look for the camera name listed under the entity.

  2. Once you select the placed camera from your entity, the scenes camera view will snap to the set perspective of the placed camera.

Clean up

The following procedures to remove tags or cameras from your scene.

Remove tags

  1. Navigate to your scene in the AWS IoT TwinMaker console.

  2. In the scene hierarchy menu, select the tag you want to remove.

  3. Select the trashcan icon from the scene options. Pressing the trashcan button with an element from your scene selected, removes it from the scene. delete-tag ure-tags-and-camera-views-Screens/delete-tag.png)

  4. Check the scene hierarchy to ensure that the tag has been removed.

Remove camera views

  1. Navigate to your scene in the AWS IoT TwinMaker console.

  2. In the scene hierarchy menu, select the camera you want to remove.

  3. Select the trashcan icon from the scene options. Pressing the trashcan button with an element from your scene selected, removes it from the scene. delete-camera

  4. Check the scene hierarchy to ensure that the camera has been removed.