bbox-visualizer 0.3.0

Different ways of visualizing objects given bounding box data

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

Photos by Joshua Earle, Jonas Weckschmied and Sherzod Max on Unsplash.

image	function
	img = bbv.draw_box(img, bbox) img = bbv.add_label(img, label, bbox, top=True)
	img = bbv.draw_box(img, bbox) img = bbv.add_T_label(img, label, bbox)
	img = bbv.draw_flag_with_label(img, label, bbox)
	img = bbv.draw_box(img, bbox) img = bbv.add_label(img, label, bbox, top=False)
	img = bbv.draw_box(image, bbox, is_opaque=True) img = bbv.add_label(img, label, bbox, draw_bg=False, top=False)
	img = bbv.draw_multiple_boxes(img, bboxes) img = bbv.add_multiple_labels(img, labels, bboxes)
	img = bbv.draw_multiple_flags_with_labels(img, labels, bboxes)
	img = bbv.draw_multiple_boxes(img, bboxes) img = bbv.add_multiple_T_labels(img, labels, bboxes)

Note: The functions draw_rectangle and draw_multiple_rectangles are also available as aliases for draw_box and draw_multiple_boxes respectively. Both naming conventions work identically.

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_boxes(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.