Supervisely
AboutAPI ReferenceSDK Reference
  • 🤖What's Supervisely
  • 🚀Ecosystem of Supervisely Apps
  • 💡FAQ
  • 📌Getting started
    • How to import
    • How to annotate
    • How to invite team members
    • How to connect agents
    • How to train models
  • 🔁Import and Export
    • Import
      • Overview
      • Import using Web UI
      • Supported annotation formats
        • Images
          • 🤖Supervisely JSON
          • 🤖Supervisely Blob
          • COCO
          • Yolo
          • Pascal VOC
          • Cityscapes
          • Images with PNG masks
          • Links from CSV, TXT and TSV
          • PDF files to images
          • Multiview images
          • Multispectral images
          • Medical 2D images
          • LabelMe
          • LabelStudio
          • Fisheye
          • High Color Depth
        • Videos
          • Supervisely
        • Pointclouds
          • Supervisely
          • .PCD, .PLY, .LAS, .LAZ pointclouds
          • Lyft
          • nuScenes
          • KITTI 3D
        • Pointcloud Episodes
          • Supervisely
          • .PCD, .PLY, .LAS, .LAZ pointclouds
          • Lyft
          • nuScenes
          • KITTI 360
        • Volumes
          • Supervisely
          • .NRRD, .DCM volumes
          • NIfTI
      • Import sample dataset
      • Import into an existing dataset
      • Import using Team Files
      • Import from Cloud
      • Import using API & SDK
      • Import using agent
    • Migrations
      • Roboflow to Supervisely
      • Labelbox to Supervisely
      • V7 to Supervisely
      • CVAT to Supervisely
    • Export
  • 📂Data Organization
    • Core concepts
    • MLOps Workflow
    • Projects
      • Datasets
      • Definitions
      • Collections
    • Team Files
    • Disk usage & Cleanup
    • Quality Assurance & Statistics
      • Practical applications of statistics
    • Operations with Data
      • Data Filtration
        • How to use advanced filters
      • Pipelines
      • Augmentations
      • Splitting data
      • Converting data
        • Convert to COCO
        • Convert to YOLO
        • Convert to Pascal VOC
    • Data Commander
      • Clone Project Meta
  • 📝Labeling
    • Labeling Toolboxes
      • Images
      • Videos 2.0
      • Videos 3.0
      • 3D Point Clouds
      • DICOM
      • Multiview images
      • Fisheye
    • Labeling Tools
      • Navigation & Selection Tools
      • Point Tool
      • Bounding Box (Rectangle) Tool
      • Polyline Tool
      • Polygon Tool
      • Brush Tool
      • Mask Pen Tool
      • Smart Tool
      • Graph (Keypoints) Tool
      • Frame-based tagging
    • Labeling Jobs
      • Labeling Queues
      • Labeling Consensus
      • Labeling Statistics
    • Labeling with AI-Assistance
  • 🤝Collaboration
    • Admin panel
      • Users management
      • Teams management
      • Server disk usage
      • Server trash bin
      • Server cleanup
      • Server stats and errors
    • Teams & workspaces
    • Members
    • Issues
    • Guides & exams
    • Activity log
    • Sharing
  • 🖥️Agents
    • Installation
      • Linux
      • Windows
      • AMI AWS
      • Kubernetes
    • How agents work
    • Restart and delete agents
    • Status and monitoring
    • Storage and cleanup
    • Integration with Docker
  • 🔮Neural Networks
    • Overview
    • Inference & Deployment
      • Overview
      • Supervisely Serving Apps
      • Deploy & Predict with Supervisely SDK
      • Using trained models outside of Supervisely
    • Model Evaluation Benchmark
      • Object Detection
      • Instance Segmentation
      • Semantic Segmentation
      • Custom Benchmark Integration
    • Custom Model Integration
      • Overview
      • Custom Inference
      • Custom Training
    • Legacy
      • Starting with Neural Networks
      • Train custom Neural Networks
      • Run pre-trained models
  • 👔Enterprise Edition
    • Get Supervisely
      • Installation
      • Post-installation
      • Upgrade
      • License Update
    • Kubernetes
      • Overview
      • Installation
      • Connect cluster
    • Advanced Tuning
      • HTTPS
      • Remote Storage
      • Single Sign-On (SSO)
      • CDN
      • Notifications
      • Moving Instance
      • Generating Troubleshoot Archive
      • Storage Cleanup
      • Private Apps
      • Data Folder
      • Firewall
      • HTTP Proxy
      • Offline usage
      • Multi-disk usage
      • Managed Postgres
      • Scalability Tuning
  • 🔧Customization and Integration
    • Supervisely .JSON Format
      • Project Structure
      • Project Meta: Classes, Tags, Settings
      • Tags
      • Objects
      • Single-Image Annotation
      • Single-Video Annotation
      • Point Cloud Episodes
      • Volumes Annotation
    • Developer Portal
    • SDK
    • API
  • 💡Resources
    • Changelog
    • GitHub
    • Blog
    • Ecosystem
Powered by GitBook
On this page
  • What is Polygon Annotation Tool?
  • Video Tutorial
  • How to use the Polygon Tool
  • Create class with Polygon shape
  • Manual Annotation Guide
  • Pro Tips
  • Hotkeys

Was this helpful?

  1. Labeling
  2. Labeling Tools

Polygon Tool

Learn how to use the Polygon Tool for precise object annotation in semantic and instance segmentation tasks with Supervisely.

PreviousPolyline ToolNextBrush Tool

Last updated 8 months ago

Was this helpful?

What is Polygon Annotation Tool?

The Polygon is a powerful tool for outlining the boundaries of objects in images or other data. It works by connecting a series of points to create polygonal figures that accurately represent the shape of an object. Usually, Polygon annotation is used to address semantic segmentation and instance segmentation tasks in computer vision.

Unlike bounding boxes, which use rectangles to enclose objects, polygons offer greater flexibility by allowing any number of points to closely follow an object’s exact shape. This tool is ideal for complex or irregular shapes where precise object boundaries are necessary.

Video Tutorial

Take a moment to watch our comprehensive 5-minute video tutorial, which provides clear and straightforward instructions on how to unlock the full capabilities of our newly enhanced Polygon annotation tool.

How to use the Polygon Tool

Below are step-by-step instructions for creating a polygon class, manually annotating objects, refining annotations, working with holes, and other advanced features to improve your annotation process.

Create class with Polygon shape

  1. Click the Polygon Icon in the toolbar of the labeling interface.

  2. Or select an existing object class or add a new class by clicking Add new class definition.

  3. In the modal window, enter the class name, choose the Polygon or Any shape, and configure additional settings (e.g., color, hotkeys).

  4. Click the Create button to add the new class to the definitions list.

  5. Select the newly created class and draw a polygon around the object boundaries in the image or video.

Manual Annotation Guide

  1. Click along the outline of the object to add points. Each click creates a new point connected by a line.

  2. To complete the shape, press SPACE or return to the starting point.

  3. You can easily adjust existing polygons by moving, adding, or removing points as needed. Just CLICK + DRAG any existing point to change its position and adjust the shape.

  4. Click on the edges of the polygon to add new points or SHIFT + CLICK on a point to remove it.

Correcting and refining annotations

To correct or refine an annotation, you can add new areas by clicking along the object's edge or remove unwanted sections by specifying new connecting points on the shape.

Automatic object linking

Automatically link objects without the need for precise alignment to individual object boundaries. To use this feature, move the pointer over a labeled object and click the nearest point. Then click subsequent points along the boundary to automatically link shapes.

Auto-placement points

Simply hold the SHIFT key and drag your cursor along the object to automatically set points, making it perfect for objects with smooth and non-linear contours. To add or remove a labeled area, first select or place a starting point, then continue by holding SHIFT to segment the area, and finish the path at any existing point.

Holes creation

To create a hole in a polygon, hold SHIFT and click to define it. You can then hover over the hole and edit it just like any other polygon. To remove a hole, move the cursor over it and press DELETE.

Pro Tips

  • Turn on the Auto-Select feature and hover over any polygon to automatically select it for editing. This feature makes it easier to modify existing annotations without manually selecting each shape.

  • Use the Object Color Randomizer to instantly change the color of any object with a single click, as often as you like. This is particularly useful if you have many objects of the same class, or if they are close together, so you can easily differentiate between polygons.

Hotkeys

Polygon Tool (minimum 3 points required)
7

Start & add point

Add point on edge

Move point

Drag

Remove point

Finish

Space

Finish

Auto-placement of points

Holes

You can then hover over other holes and edit them just like any other polygon. If you want to remove a hole, move the cursor over the hole and press Delete.

Replace edges in existing polygon

Click any point, draw a polyline, finish by clicking any other point or the polygon border

Scene Navigation

You can create a new class directly from the . To do this:

Learn more about the advanced capabilities of the Polygon tool and its effective use for semantic and instance segmentation tasks in :

Shift +

the first point

When you create or edit a polygon instead of clicking multiple times, you can hold both Shift and and draw a line.

You can hold Shift and press to create polygon hole

Zoom with Mouse wheel. Hold to move scene.

📝
Annotation Toolbox
our comprehensive blog post
Polygon Annotation Best Practices for Semantic & Instance Segmentation - SuperviselySupervisely
Logo