Using the Vector workspace

When you are annotating a task with a vector image or video, your workspace will resemble the following:

Each of these main areas of the workspace are described in detail in the sections below.



Annotation tools

The following annotation tools are provided for vector projects.



Edit

The Edit tool is used to modify existing shapes. It also contains a sub-tool for adding points (see Add points below).

With the regular Edit tool, you can:

OperationAction
Move shapesClick on the shape (or press Ctrl [Cmd] to select multiple shapes) and drag it into a new location.
Resize a rectangleClick and drag a corner of the rectangle to resize two sides at once, or an edge to resize one side.
Delete a point from a line, arrow, or polygonClick on the shape, and then hold Alt (Option) and click on the point.
Move a pointClick and drag the point.
Copy shapesClick on the shape (or press Ctrl [Cmd] to select multiple shapes) and press Ctrl (Cmd) + C.
Paste shapesPress Ctrl (Cmd) + V.


Add Points

With the Add Points sub-tool, you can easily add extra points to an existing line, arrow, or polygon. Just click where you want to add a point, and the point will automatically be connected to the closest line in the existing shape.

👍

Tip

Since points will always connect to the closest line, you may find that a point tries to connect to the wrong line because it's closer. To prevent that, just add more points to the "right" line until it's closest to where you're adding the new point.

You can also remove points, just like you can with the regular Edit tool, by holding Alt (Option) and clicking on the point.



Edit with Machine-assisted annotation

When editing a polygon, you're able to benefit from Machine-assisted annotation to automatically place points along the ideal path. Simply move any of the points around the object, and all points will be re-placed automatically along the edge of the object.



Point

The Point tool allows you to annotate objects with a single click.



Line

The Line tool is used to place polylines that contain any number of points. This tool can be used to annotate straight or curved lines.

To draw a line:

  1. Click to place the starting point of the line.
  2. Click to place additional points, if desired.
  3. Double-click to stop drawing the line.



Arrow

The Arrow tool can be used to indicate a direction on an image. For example, an arrow could be used to show what direction a car is going in a 2D image, in which the car has been outlined with a rectangle.

To draw an arrow:

  1. Click to place the starting point of the arrow (the side without the arrowhead).
  2. Click to place additional points, if desired.
  3. Double-click to stop drawing the arrow.



Rectangle

The Rectangle tool is a quick and easy way to annotate shapes, but doesn't capture any 3D information.

To draw a rectangle:

  1. Click on the corner of a shape.
  2. Drag your mouse to the opposite corner of the shape.
  3. Click to place the rectangle.



Slider rectangle

The Slider rectangle tool is slightly more complex than the Rectangle tool, since you also need to drop a dotted line that indicates where the corner of a 3D object is located. Slider rectangles capture a little 3D information — not as much as cuboids, but more than rectangles.

To draw a slider rectangle:

  1. Click on the corner of a shape.
  2. Drag your mouse to the opposite corner of the shape.
  3. Click to place the rectangle.
  4. Move your mouse to the corner of the 3D shape and click to place the dotted line.



Polygon

The Polygon tool is used to precisely outline the edges of an object for accurate detection.

To draw a polygon:

  1. Click to place the first point on the edge of the shape.
  2. Click to place as many additional points as needed to outline the shape.
  3. Double-click to stop placing points and finish the polygon.

👍

Tip

If you need to adjust some of your points, you can easily add, remove, or move points using the Edit tool.

An additional resource available to you as a subset of the polygon tool is shape creation with Machine Learning Assisted Annotation (MAA). When selecting the polygon tool, you'll be able to select the MAA Polygon feature as a subtool.

Using the MAA-enhanced polygon is simple - all you need is 4 clicks around the object to create your shape. The clicks must be made in the following order:

  1. Place the first click on the extreme left-side of the object.
  2. Place the second click at the extreme top of the object.
  3. The third click needs to be placed on the extreme right-side of the object.
  4. The fourth and final click needs to be placed at the extreme bottom of the object.

Once these four clicks are made, a polygon will be created surrounding the object.

MAA in actionMAA in action

Once your shape is created, you'll note that the shape itself is made up of many points, even though it was created with only four clicks. These additional points allow you to use the edit tool to fully control the size and precision of the shape.



Cuboid

The Cuboid tool is used to detect the depth and height of 3D objects in a 2D plane using perspective mathematics. Cuboids have a face of interest, a side, and a top. They can be finicky to get right, but they capture more 3D information than a slider rectangle or rectangle.

To draw a cuboid:

  1. Click on the horizon to drop the horizon line.
  2. Starting on the face of interest, outline the three visible corners of the object to be surrounded by the cuboid.
  3. Move your mouse upward to the top of the object and then click to stop drawing.



Measure

The Measure tool allows you to measure an object without drawing on the image. This tool allows annotators and QAs to measure objects to see whether they should be annotated based on project-specific quality requirements.

To measure an object:

  1. Click on the corner of a shape.
  2. Drag your mouse to the opposite corner of the shape and note the measurements; once you release the mouse button, the shape will disappear.



Zoom

The Zoom tool adds three more buttons to the workspace that you can use to adjust the zoom level.

  • Zoom In: Zooms in by 10%.
  • Zoom Out: Zooms out by 10%.
  • Reset Zoom: Resets the zoom to 100%.

📘

Note

To zoom in really close on a specific part of the image, use your mouse to draw a rectangle around that area — you'll zoom in automatically.

If you need to pan around your image while you're zoomed in, use the scroll wheel on your mouse to pan up and down, or hold Shift and scroll to pan side to side.



Top toolbar

The top toolbar contains an assortment of helpful tools for adjusting how the image and shapes are displayed, undoing or redoing actions, and referencing keyboard shortcuts.



All, Selected, and None (1)

If your workspace has a lot of shapes on it, these three options can be extremely helpful for removing visual clutter while you work.

  • All: Displays all the shapes in the workspace.
  • Selected: Displays only the shapes that have been selected, and hides all other shapes in the workspace.
  • None: Hides all the shapes in the workspace.
All
Selected
None


Shape View Settings (2)

These settings allow you to personalize the way that shapes are displayed in the workspace. These settings are just for the workspace and aren't saved along with the task when it's submitted.

  • Opacity: Increases or decreases the opacity of shapes, so you can see less or more of the image behind.
  • Show dimensions inside rectangles: Displays dimensions on top of rectangles.
  • Hide occluded shapes: Hides shapes that are occluded (positioned behind) other shapes.
  • Save settings across tasks: Saves your shape view settings and applies them to all tasks within the project going forward.
Low vs. high opacity
Dimensions
Occluded shapes hidden


Image View Settings (3)

These settings can help save your eyes if you're working on an image where it's hard to make out details. For example, adjusting these settings can be very helpful to identify objects in nighttime scenes or snowy landscapes.

  • Brightness: Increases or decreases the brightness of the image.
  • Contrast: Increases or decreases the contrast of the image.
Low vs. high brightness
Low vs. high contrast


Undo/Redo (4)

You can undo up to 1,000 actions in the workspace, so even the biggest of mistakes can be erased! Just about any kind of action can be undone or redone, except for zooming and panning.



Keyboard Shortcuts (5)

This button displays a pop-up cheatsheet of all the available keyboard shortcuts for easy reference.

👍

Tip

Use keyboard shortcuts whenever possible to save time when annotating. Annotators who use keyboard shortcuts for all their repetitive tasks are substantially more efficient than annotators who rely on a mouse.



Shape panel

The expandable shape panel on the right side of the workspace shows a list of each of the shapes that you have drawn on the image. If your project is set up to use shape atributes (see Creating a project), they'll appear in this panel when you edit a particular shape, allowing you to provide answers for each shape attribute.

In the shape panel, you can:

  • Expand the shape panel: Click the right-chevrons icon when the shape panel is collapsed.
  • Collapse the shape panel: Click the left-chevrons icon when the shape panel is expanded.
  • Delete the selected shape(s): Click the trash icon (or press Del on your keyboard).
  • Select all shapes: Click the double-checkmark icon (or press Ctrl/Cmd + A on your keyboard).
  • Reorder the shapes: Hover over a shape in the list, click the handle, and drag and drop it into a higher position (a layer closer to the foreground, in front of other shapes) or a lower position (a layer closer to the background, behind other shapes).
  • Edit a shape: Hover over a shape in the list, click the pencil icon, and then edit the shape (this is only useful if your project is set up to have shape outputs).



Mouse coordinates

In the bottom right of the workspace, you can see the X and Y coordinates of your mouse on the image.



Scrubber (video only)

The scrubber is used to move forward and background through the frames of the video. You can navigate frames in the following ways:

  • Jump to a specific frame: Enter a frame number in the box on the right and press Enter.
  • Move one/five frames at a time: Use the rewind/fast-forward buttons on the sides.
  • Scrub through frames sequentially: Click and drag the slider.