Convert Class Shape

Convert Class Shape

OverviewHow To Run

GitHub release (latest SemVer) views used by teams runs


It is often needed to convert labeled objects from one geometry to another while doing computer vision reseach. There are huge number of scenarious , here are some examples:

  • you labeled data with polygons to train semantic segmentation model, and then you decided to try detection model. Therefore you have to convert your labels from polygons to rectangles (bounding boxes)
  • or you applied neural network to images and it produced pre-annotations as bitmaps (masks). Then you want to transform them to polygons for manual correction.

This app covers following transformations:

  • from Bitmap to Polygon, Rectangle and AnyShape
  • from Polygon to Rectangle, Bitmap and AnyShape
  • from Polyline to Rectangle, Bitmap, Polygon, AnyShape
  • from Rectangle to Polygon, Bitmap and AnyShape
  • from Graph (i.e. Keypoints) to Rectangle and AnyShape
  • from Point to AnyShape
  • Cuboid, Cuboid3d, Pointcloud (segmentation of point clouds), Point3d are not supported yet (send us a feature request if you need it)


  • Result project name = original name + "(new shapes)" suffix
  • Your data is safe: app creates new project with modified classes and objects. The original project remains unchanged
  • Before converting AnyShape classes, you have to unpack it with another app - Unpack Anyshape
  • Colors of new classes will be generated randomly
  • Note: transformation from raster (bitmap) to vector (polygon) will result in huge number of points. App performs approximation to reduce the number. That can lead to slight loss of accuracy at borders. Special settings to control approximation will be released in next version.

How To Run

Step 1: Run from context menu of project

Go to "Context Menu" (images project) -> "Run App" -> "Transform" -> "Convert Class Shape"

Step 2: Waiting until the app is started

Once app is started, new task appear in workspace tasks. Wait message Application is started ... (1) and then press Open button (2).

Step 3: Define transformations

App contains 3 sections: information about input project, information about output and the list of all classes from input project. In column CONVERT TO there are dropdown lists in front of each class (row of the table). You have to define transformations for classes of interest.

Default remain unchanged option is selected and means that class and all its objects will be copied without modification to a new project. Dropdown lists only contain allowed shapes (see Overview), for example Rectangle can not be transformed to Polyline or Point.

Step 4: Press RUN button and wait

Press Run button. The progress bas will appear in Output section. Also you can monitor progress from tasks list of the current workspace.

App creates new project and it will appear in Output section. Result project name = original name + "(new shapes)" suffix.

Step 5: App shuts down automatically

Even if app is finished, you can always use it as a history: open it from tasks list in Read Only mode to check Input project, list of applied transformations and Output project.


Last Updated 2020-10-22 15:34:06
Author max-supervisely