Viewers Guide

There are 3 different dataset viewers in Smartdata, the inspection viewer, the 2D viewer and the 3D viewer. Since the 2D and 3D viewers are similar, they will be covered in a single section and the inspection viewer guide will be in a separate section

Inspection Viewer

Annotations

Creating

Firstly, select the tool and color you wish to use from left toolbar. Click on the current color to expand the options.

Annotation tools:

  • Draw Polyline - This tool can draw a line with multiple points on the image. While drawing, there is options to finish, delete the last point or cancel the polyline. To finish drawing, click the last point of the polyline.

  • Draw Polygon - This tool can draw a polygon on the image. While drawing there is options to finish, delete the last point or cancel the polygon. To finish drawing, click the first point of the polygon.

  • Draw Rectangle - This tool can draw a rectangle on the image. While drawing there is options to cancel the rectangle. To finish, release the mouse.

  • Draw Marker - This tool can drop a marker on the image with a mouseclick.

Editing

Clicking the edit control on the left toolbar will allow you to edit your current annotations, this can mean dragging the points of your shapes and lines or moving your markers, there is options to save or cancel your changes.

Deleting

Clicking the delete control on the left toolbar will allow you to delete your current annotations. You can delete individual annotations or clear all of them. There is options to save or cancel your changes.

Other Controls

Download Image

This control allows you to download a copy of the current image at its original resolution. On some browsers you may have to right click on the image in the newly opened tab and save it manually.

Image Size Selection

These controls allow you to change the quality of the image: Small, Medium and Large is available. Smaller images will load faster, however larger images have more detail.

Altitude Slider

The Altitude Slider allows you to see the altitude at which the current image was taken.

Example

Inspection View: Inspection View

2D and 3D Viewers

Basics

Navigation

The camera can be moved through two separate methods, the mouse and the keyboard.

Navigation using the mouse is the most intuitive method in most cases. Move around by clicking and dragging in the viewer window. Zoom by using the scroll wheel on your mouse or use two fingers on the touchpad and scroll up and down. To focus on a point and swivel the camera around it, click and drag with the middle button on your mouse.

Navigation using the keyboard is useful in models where mouse navigation can be difficult e.g. a bridge model. Use A and D to move left and right. W and S keys are used to zoom in and out. Q and E keys move up and down. To rotate the camera, use the arrow keys. The arrow keys rotate the camera in their respective direction e.g. up arrow rotates the camera upwards, etc. You can also rotate that camera by holding down the ctrl button and using the touchpad to rotate in the desired direction.

Settings

  • Toggle Shadows - Turn on or off shadows on the current model (Only applicable to 3D Viewer.)

  • Toggle Negative/Positive Raise - By default, each point selected on the model is raised by 10cm to account for uneven ground which would occasionally mean that annotations were clipping through the ground. However, in some cases, this is undesirable. This toggle allows you to set the raise distance to -10cm for cases where the annotation will be underneath an object e.g. the underside of a bridge (Only applicable to 3D Viewer.)

  • Toggle Annotations - Turn on or off annotations on the current model.

  • Toggle Mouse Label - Toggle the mouse label that displays coordinates of mouse hover point.

  • Export Annotations - Export the current dataset’s annotations. These can be imported later.

  • Import Annotations - Import annotations to the current dataset. Currently accepted formats include the SmartData custom format and KML files

Settings

Annotations/Measurements

Creating

Firstly, select the tool you wish to use from the menu in the top left.

For all annotations, a left click on the model indicates selecting a new point.

When an annotation is finished, a sidebar will open from the right that allows the user to input a label and a description for the annotation.

Annotation specific usage instructions are below.

Annotation tools:

  • Select Annotation - Use this tool to click on annotations in the model.

  • Draw Marker - Draw a single point anywhere on the model with a label and description. Left click where you want to display the point.

  • Draw Polygon - Draw a polygon over the model with a label and description. To draw a polygon, left click to select points, then right click to finish the annotation. The label will appear where you right click, but this point will not be included in the construction of the polygon.

  • Draw Rectangle - Draw a rectangle. This tool is most effective when facing North. Otherwise, it might not cover the expected area. In most cases, the draw polygon tool is recommended in place of this tool. The first point selected in a rectangle is the first corner and the second point selected is the second corner. The annotation will automatically finish after 2 points have been selected.

  • Draw Circle - Draw a circle. The first click will select the center point of the circle and will set the height for the annotation. The second click is used to calculate the radius. After the second click, the annotation will automatically finish.

  • Draw Polyline - Draw a polyline. Each left click selects a new point in the line. Right click to finish the annotation. The final right click is not included in the line, but is the position of the label.

  • Measure Fill Stockpile - Measure a positive volume using a pointmesh. Each left click contributes to a border around an area. Right click to enter a height adjustment mode. The height of the entity will move according to the y position of your mouse in this mode. Right or left click to finish the annotation when you are happy with the height of the measurement. The three settings for the resolution (Low, Medium, High) trade off speed for accuracy. High resolution can take a long time, but will provide an extremely accurate point mesh and volume calculation. Low resolution is much faster, but will be slightly less accurate.

  • Measure Cut Stockpile - Measure a negative volume using a pointmesh. Each left click contributes to a border around an area. Right click to enter a height adjustment mode. The height of the entity will move according to the y position of your mouse in this mode. Right or left click to finish the annotation when you are happy with the height of the measurement. The three settings for the resolution (Low, Medium, High) trade off speed for accuracy. High resolution can take a long time, but will provide an extremely accurate point mesh and volume calculation. Low resolution is much faster, but will be slightly less accurate.

  • Measure 2D Polyline - Measure a 2D polyline. All points are automatically locked to the 2D plane set by the first selected point. The value displayed as the label calculates the 2D distance between the points. Right click finishes the annotation and sets the position for the label. The user can set an individual label and description for each segment of the line. The default label for each segment is the 2D length of the line.

  • Measure 2D Polygon - Measure a 2D polygon. All points are automatically locked to the 2D plane set by the highest point selected. The value displayed as the default label is the surface area of the polygon. Left click to select points and right click to finish the measurement.

  • Measure 3D Polyline - Measure a 3D polyline. Each point retains their individual height, as opposed to the 2D tools. The default label for each segment of the line is the 3D length of the line. Left click to select each point in the line and right click to finish the annotation and set the position of the label.

  • Measure 3D Polygon - Measure a 3D polygon. This tool is used for measuring basic 3D volumes. Left click to select all the points you desire in a 2D shape. After you right click, the polygon will enter an extrusion mode, where you can change the height of the polygon based on the y position of your mouse. After this, either right or left click to finish the annotation. The default label for this polygon is the total volume in metres cubed and the total surface area in metres squared.

Note: the 3D tools (Measure Fill Stockpile, Measure Cut Stockpile, Measure 3D Polyline, Measure 3D Polygon) are only available in the 3D viewer.

Annotations are automatically saved upon creation.

To cancel an annotation, press the escape button on your keyboard.

Editing

To edit an annotation’s label or description, first select the annotation using the select annotation tool. After this, a row of buttons will appear on the right side of the screen. Hovering over each of them will give a description of it’s function. Click on the edit button. This will open the sidebar where you can edit the label or description.

To edit the positions of an annotation, you can click and drag the points of the annotation. This is not compatible with the stockpile measurement.

Annotation Information

After selecting an annotation using the select annotation tool, there is an information panel available. Select the information button to display the information panel.

There is different information available for each type of annotation, but there are some general attributes. The common attributes displayed are the label, the annotation type and the description (if supplied by user).

Specific information available:

Markers - Longitude, latitude and altitude of point.

Annotation Polygon - Surface area, perimeter of polygon.

Rectangle - Number of points.

Ellipse - Longitude, latitude and altitude of center point. Radius, circumference and area of circle.

Annotation Polyline - Number of points.

Stockpile Volumes - Volume and resolution of pointmesh. Number of points in pointmesh.

2D Polyline - 2D distance, 3D distance, angle of elevation.

2D Polygon - Surface area, perimeter of polygon

3D Polyline - 2D distance, 3D distance, angle of elevation.

3D Polygon - Height, total surface area, 2D surface area, volume.

Deleting

There are 3 methods of deletion.

The first specifically deletes a single annotation. It’s in the menu that appears when you select an annotation using the select annotation tool. Simply click the delete annotation button to permanently delete the annotation. To delete multiple entities at once, hold the CTRL key while selecting entities then click the delete annotation button to delete them all.

The second is using the entity selection tool. This tool allows the user to select points of a border. All entities within the selection will be deleted.

The third deletes all annotations in the dataset. This can be found in the settings dropdown menu at the very bottom.

Colours

To choose the colour used for an annotation, simply select a colour from the menu before you start drawing your annotation. Colours available include red, orange, yellow, green and white.

Annotation Examples

Annotations: Annotation Examples

Stockpile Measurement: Stockpile Measurement Example

3D Polygon: 3D Polygon Example

3D Polygon, 2D Polylines, 2D Polygon: Measurements Examples

3D Polyline: 3D Polyline Example

Back to Source

To open back to source, double click anywhere on the model and the embedded insepction viewer will open in the right sidebar with the most appropriate source image selected for that point on the model. For information on how to use the embedded inspection viewer, refer to the Inspection Viewer guide.

Comparison Viewer

To open back to source, click on the white button with a chevron icon on the left of the viewer.

Open Comparison Viewer

You can then select a dataset from the dropdown. The available datasets in the list are the datasets in the same site with the same dataset type (i.e. Inspection, 3D, 2D). Inputs are disabled on the comparison viewer, but any camera movements made in the original viewer will be reflected in the comparison viewer. This can be used to check changes between two datasets that have been captured at different times.

To close the comparison viewer, click the white button again. After this is done, a new dataset can be loaded in the comparison viewer by reopening it.