Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shoumikchow/bbox-visualizer
Make drawing and labeling bounding boxes easy as cake
https://github.com/shoumikchow/bbox-visualizer
annotation annotations bboxes bounding-box bounding-boxes boundingbox computer-vision computer-vision-tools cv data-labeling deep-learning image-annotation image-labeling image-labeling-tool labeling object-detection object-recognition python3
Last synced: 3 months ago
JSON representation
Make drawing and labeling bounding boxes easy as cake
- Host: GitHub
- URL: https://github.com/shoumikchow/bbox-visualizer
- Owner: shoumikchow
- License: mit
- Created: 2020-06-22T06:16:10.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2024-02-15T20:04:31.000Z (4 months ago)
- Last Synced: 2024-03-15T21:54:58.996Z (3 months ago)
- Topics: annotation, annotations, bboxes, bounding-box, bounding-boxes, boundingbox, computer-vision, computer-vision-tools, cv, data-labeling, deep-learning, image-annotation, image-labeling, image-labeling-tool, labeling, object-detection, object-recognition, python3
- Language: Python
- Homepage: https://bbox-visualizer.readthedocs.io
- Size: 8.63 MB
- Stars: 371
- Watchers: 6
- Forks: 27
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: HISTORY.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Authors: AUTHORS.md
Lists
- awesome-stars - bbox-visualizer
- awesome-stars - shoumikchow/bbox-visualizer - Make drawing and labeling bounding boxes easy as cake (Python)
- awesome-stars - shoumikchow/bbox-visualizer - Make drawing and labeling bounding boxes easy as cake (Python)
- awesome-stars - shoumikchow/bbox-visualizer - Make drawing and labeling bounding boxes easy as cake (Python)
README
# bbox-visualizer
[![Documentation Status](https://readthedocs.org/projects/bbox-visualizer/badge/?version=latest)](https://bbox-visualizer.readthedocs.io/en/latest/?badge=latest)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PyPI version](https://badge.fury.io/py/bbox-visualizer.svg)](https://pypi.org/project/bbox-visualizer/0.1.0/)
[![Downloads](https://pepy.tech/badge/bbox-visualizer)](https://pepy.tech/project/bbox-visualizer)This package helps users draw bounding boxes around objects, without doing the clumsy math that you'd need to do for positioning the labels. It also has a few different types of visualizations you can use for labeling objects after identifying them.
The bounding box points are expected in the format: `(xmin, ymin, xmax, ymax)`
* Documentation: https://bbox-visualizer.readthedocs.io.
* Free software: MIT license## Installation:
pip install bbox-visualizer## Usage:
import bbox_visualizer as bbv![cover](images/cover.jpg)
#### Photos by [Joshua Earle](https://unsplash.com/@joshuaearle), [Jonas Weckschmied](https://unsplash.com/@jweckschmied) and [Sherzod Max](https://unsplash.com/@sherzodmax) on [Unsplash](https://unsplash.com).
| **image** | **function** |
|:----------------------------------------------------------------------------------------------------------:|:------------------------------------------------------------------------------------------------------------------:|
| ![bbox with label on top](images/bbox_top.jpg "Bouding box with label on top") | img = bbv.draw_rectangle(img, bbox)
img = bbv.add_label(img, label, bbox, top=True) |
| ![bbox with T label](images/bbox_T.jpg "Bouding box with label inside") | img = bbv.draw_rectangle(img, bbox)
img = bbv.add_T_label(img, label, bbox) |
| ![label with flag](images/flag.jpg "Label that looks like a flag, pole originates from inside the object") | img = bbv.draw_flag_with_label(img, label, bbox) |
| ![bbox with label inside](images/bbox_inside.jpg "Bouding box with label inside") | img = bbv.draw_rectangle(img, bbox)
img = bbv.add_label(img, label, bbox, top=False) |
| ![label with opaque overlay](images/overlay.jpg "Opaque bounding box with label inside the box") | img = bbv.draw_rectangle(image, bbox, is_opaque=True)
img = bbv.add_label(img, label, bbox, draw_bg=False, top=False) |
| ![multiple bbox](images/bbox_multiple.jpg "Multiple bounding boxes") | img = bbv.draw_multiple_rectangles(img, bboxes)
img = bbv.add_multiple_labels(img, labels, bboxes) |
| ![multiple flags](images/bbox_multiple_flags.jpg "Multiple flags") | img = bbv.draw_multiple_flags_with_labels(img, labels, bboxes) |
| ![multiple T bbox](images/bbox_multiple_T.jpg "Multiple bounding boxes with T labels") | img = bbv.draw_multiple_rectangles(img, bboxes)
img = bbv.add_multiple_T_labels(img, labels, bboxes) |## There are *optional* functions that can draw multiple bounding boxes and/or write multiple labels on the same image, but it is advisable to use the above functions in a loop in order to have full control over your visualizations.
* bbv.draw_multiple_rectangles(img, bboxes)
* bbv.add_multiple_labels(img, labels, bboxes)
* bbv.add_multiple_T_labels(img, labels, bboxes)
* bbv.draw_multiple_flags_with_labels(img, labels, bboxes)`bboxes` and `labels` are lists in the above examples.
#### Credits
This package was created with Cookiecutter and the `audreyr/cookiecutter-pypackage` project template.