Ango Hub Docs
Open Ango HubContact iMerit
  • Ango Hub Documentation
  • Video Guides
  • Changelog
  • FAQs & Troubleshooting
  • All Keyboard and Mouse Shortcuts
  • Core Concepts
    • Assets
    • Attachments
    • Batches
    • Benchmarks
    • Category Schema (Ontologies)
    • Frame Interpolation
    • Geofencing
    • Idle Time Detection & Time Tracking
    • Instructions
    • Issues
      • Issue Error Codes
    • Label Validation
    • Labeler Performance
    • Labeling
    • Labeling Queue
    • Multiple Classification
    • Notifications
    • Organizations
    • Projects
    • Requeuing
    • Reviewing
    • Review Queue
    • Skipping
    • Stage History
    • Tasks
    • Usage
    • User Roles
    • Workflow
      • Complete
      • Consensus
      • Hold
      • Label
      • Logic
      • Plugin
      • Review
      • Start
      • Webhook
  • Labeling
    • Managing Users in Projects
      • Profile Page
    • Managing the Project Ontology
    • Labeling Editor Interface
      • Audio Labeling Editor
      • Image Labeling Editor
      • Video Labeling Editor
      • DICOM Labeling Editor
      • Medical Labeling Editor
        • 3D Bounding Box
        • Fill Between Slices
        • Island Tools
        • Line (Tape Measure)
        • Smoothing
      • PDF Labeling Editor
      • Text (NER) Labeling Editor
      • LLM Chat Labeling Editor
      • Markdown Labeling Editor
      • 3D Multi-Sensor Fusion Labeling Editor
    • Labeling Classes
      • Tools
        • Bounding Box
        • Brush
        • Entity
        • Message
        • Nested Classifications
        • PCT
        • PDF Tool
        • Point
        • Polygon
        • Polyline
        • Rotated Bounding Box
        • Segmentation
        • Spline
        • Voxel Brush
      • Classification
        • Checkbox
        • Multiple Dropdown
        • Radio
        • Rank
        • Single Dropdown
        • Text
        • Tree Dropdown Tools (Single and Multiple Selection)
      • Relation
        • Single Relation
        • Group Relation
    • Magnetic Lasso
    • Performance & Compatibility Considerations
  • Data
    • Data in Ango Hub
      • Embedding Private Bucket Files in MD Assets
    • Importing Assets
      • Asset Builder
      • Bundled Assets
        • Importing Multiple Images as One Multi-Page Asset
        • Importing Multiple Single-Frame DICOM Files as One Multi-Page Asset
        • Importing multiple DICOM files to be annotated and displayed at once
        • Importing Multiple Single-Frame DICOM Files as a DICOM Series
        • Importing Multiple Markdown Files as One Multi-Page Asset
      • File Explorer
      • Supported Asset File Types & Codecs
      • Importing Cloud (Remote) Assets
      • Importing From Local Machine
      • Creating and Importing LLM Chat Assets
      • Importing Data in the 3D Multi-Sensor Fusion Labeling Tool
      • Bulk Importing Markdown/HTML Assets
      • Importing Attachments during Asset Import
      • Importing Annotations during Asset Import
      • contextData: Adding Extra Data to Assets
      • Importing Reference Images as Overlay
      • Importing Reference Medical Data During Asset Import
    • Importing and Exporting Annotations
      • Importing Annotations
        • Ango Import Format
        • Importing Brush Traces
        • Importing NRRD Annotations
      • Exporting Annotations
        • Ango Export Format
          • Asset
            • Task
              • Tools
              • Classifications
              • Relations
          • Stage History
    • Adding and Managing LLMs
    • Storages
      • Set up a storage integration with Azure
      • Set up a storage integration with AWS S3
      • Set up a storage integration with MinIO and S3-compatible custom storage services
      • Set up a storage integration with GCP (Google Cloud Platform)
      • Set up CORS
      • Validating Storage Integrations
    • Purging Data from Ango Hub
  • Plugins
    • Overview of Plugins in Ango Hub
      • Installing Plugins
      • Plugin Setting Presets
      • Monitoring Plugin Progress
    • First-Party Plugins
      • Ango Export Converter Plugins
      • Asset Converter Plugins
      • Ango to Mask Converter
      • Batch Assignment
      • ChatGPT
      • Column-Agnostic Markdown Generator
      • CSV Export for Classification
      • DALL-E
      • DALL-E (Model Plugin)
      • File Explorer Plugin
      • General Object Detector
      • General Object Segmenter
      • Markdown Generator
      • One-Click Segmentation
      • Open World Object Detection
      • Optical Character Recognition
      • TPT Export
      • YOLO | Instance Segmentation
      • YOLO | Pose Estimation
      • YOLO | Object Detection
      • YOLO | Image Classification
    • Plugin Developer Documentation
      • Export Plugins
      • Batch Model Plugins
      • Model Plugins
      • File Explorer Plugins
      • Markdown Generator Plugins
      • Plugin Logger
      • [WIP] Deploying your Plugin
      • Plugin 'Host' Information
  • SDK
    • SDK Documentation
      • Project Level SDK Functions
        • add_members_to_project
        • assign_batches
        • assign_task
        • create_attachment
        • create_batch
        • create_issue
        • create_label_set
        • create_project
        • delete_issue
        • export
        • exportV3
        • get_assets
        • get_batches
        • get_issues
        • get_metrics
        • get_project
        • get_project_performance
        • get_task
        • get_tasks
        • get_task_history
        • import_labels
        • list_projects
        • requeue_tasks
        • rerun_webhook
        • update_workflow_stages
        • upload_files
        • upload_files_cloud
        • upload_files_with_asset_builder
        • upload_chat_assets
      • Organization Level SDK Functions
        • create_storage
        • delete_organization_invites
        • delete_organization_members
        • delete_storage
        • get_organization_invites
        • get_organization_members
        • get_storages
        • invite_members_to_org
        • update_organization_members_role
    • SDK - Useful Snippets
    • SDK Changelog
  • API
    • API Documentation
  • How-To
    • Add Members
      • Add multiple users to a project
    • Annotate
      • Annotate 3D Point Cloud Files on Ango Hub
      • Perform targeted OCR on images
    • Export Data
      • Automatically send Ango Hub Webhook contents to Google Sheets, Email, Slack, and more with Zapier
      • Download a JSON of your project ontology
      • Download DICOM Segmentation Masks
      • Download your annotations in the COCO, KITTI, or YOLO format
      • Download your Segmentation Masks
      • Get your export as separate JSON files for each asset
    • Manage a Project
      • Get your API Key
      • Get your Organization ID
      • Mute your notifications
      • Open an asset provided the Asset ID
      • Pre-label assets
      • Share a filtered view of the Tasks table with others
      • Transfer project ontologies between projects
      • Transfer project workflows between projects
    • Perform Model Evaluation on Ango Hub
  • Troubleshooting
    • I get a "0 Tasks Labeled" alert when trying to pre-label tasks
    • I get a 'The data couldn't be loaded properly' error when opening certain assets
    • I get a "Unknown Classification" warning when opening a task
  • Feature Availability Status for projects of the 3D Multi-Sensor Fusion type
  • Comparison between QuickServe and Ango Hub
  • Changes from Ango Hub Legacy
  • Video V2 Breaking Changes and Transition
  • Data Access, Storage, and Security
  • Two-Factor Authentication
  • Single Sign-On (SSO) Support
  • Customer Support
  • Ango Hub Status Page
Powered by GitBook
On this page
  • Overview
  • Features
  • Input Parameters
  • Use Cases
  1. Plugins
  2. First-Party Plugins

Ango to Mask Converter

PreviousAsset Converter PluginsNextBatch Assignment

Last updated 7 months ago

Overview

The Ango to Mask Converter plugin converts various types of annotations—such as segmentation, polygon, bounding box, and more—from Ango format into masks. This plugin supports different data types and annotation tools, offering flexibility for both image and video processing.

Features

  • Converts multiple annotation types (segmentation, polygon, bounding box, etc.) into masks.

  • Supports various data types, including images, videos, and multi-page assets.

  • Compatible with a wide range of annotation tools, offering extensive versatility.

  • Can overlay masks on original media with customizable opacity for enhanced visual analysis.

  • Customizable logging and detailed output options for monitoring large projects.

Supported Data Types

  • Image

  • Video

  • Multi-Page Assets

Supported Annotation Tools

  • Polygon

  • Segmentation

  • Point

  • Polyline

  • Bounding Box

  • Rotated Bounding Box

  • Brush (For image assets only)

Input Parameters

class_mapping_type: Defines how classes are mapped to the mask output.

Please note that the output mask image may appear fully black. This is because our eyes cannot easily distinguish between pixel values of 0, 1, and 2, as these values are very close to pure black.

Options:

  • single_channel_sequential: Assigns grayscale values sequentially in a single channel.

Example: Class-1: [1], Class-2: [2], Class-3: [3]

  • single_channel_diverging: Uses diverging grayscale values for enhanced distinction.

Example: Class-1: [256], Class-2: [128], Class-3: [64]

  • multi_channel_qualitative: Maps each class to matplotlibs color schemas: 'tab10', 'tab20', 'tab20b', 'tab20c', and ‘xkcd-colors’ respectively.

Example: Class-1: [31, 119, 180], Class-2: [255, 127, 14], Class-3: [44, 160, 44]

  • project_colors: Uses project-defined colors for mask generation.

Example: Class-1: [244, 67, 54], Class-2: [3, 169, 244], Class-3: [156, 39, 176]

  • instance_segmentation: Assigns a distinct RGB color to each instance.

Example: Cat-1: [31, 199, 180], Dog-1: [255, 127, 14], Dog-2: [44, 160, 44]

selected_schema_ids: A list of schema IDs to specify which classes should be processed. Only annotations matching these IDs will be considered.

prioritized_schema_ids: A list of schema IDs that defines which annotations take precedence when multiple annotations overlap. Note: By default, the tools are sorted according to their tool type. The sorting order from back to front is as follows: brush, bounding box, rotated bounding box, polygon, segmentation, polyline, point

add_boundary: Boolean value (true or false). If enabled, adds boundaries to annotations for better visualization in the generated masks. Supported for polygon, segmentation, bounding box, and rotated bounding box.

polyline_thickness: Specifies the thickness of the boundary lines (in pixels) for polyline or segmentation annotations.

verbose: Boolean flag (true or false). When enabled, detailed logs are produced during the mask generation process.

verbose_frequency: Integer value specifying how frequently logs should be generated during processing. For example, setting verbose_frequency=5 will log progress for every 5th asset.

overlay_over_image: Boolean value (true or false). When enabled, the generated mask will be overlaid on the original image or video for easy comparison.

overlay_opacity: Float value between 0 and 1 that controls the transparency of the overlay. A value of 0 means the mask is fully transparent, while 1 means it is fully opaque.

Use Cases

  • Image and Video Segmentation: Convert segmentation annotations into masks for use in model training or visual analysis.

  • Object Detection: Generate masks from bounding box annotations for object detection models.

  • Overlay Masks on Media: Use the overlay_over_image feature to analyze masks over the original image or video.

Ango to Mask Converter (A) Annotations on AngoHub image editor, (B) Output mask
Output mask with "class_mapping_type": "single_channel_sequential" option
Output mask with "class_mapping_type": "single_channel_diverging" option
Output mask with "class_mapping_type": "multi_channel_qualitative" option
Output mask with "class_mapping_type": "project_colors" option
Output mask with "class_mapping_type": "instance_segmentation" option
(A) Output mask with "add_boundary": false option and (B) Output mask with "add_boundary": true option
(A) Output mask with "overlay_over_image": false option and (B) Output mask with "overlay_over_image": true option