Metadata-Version: 2.1
Name: simplebbox
Version: 0.0.5
Summary: Functions for bounding box processing
Home-page: https://github.com/serge-m/simplebbox
Author: Sergey Matyunin
Author-email: serge-m@users.noreply.github.com
License: MIT license
Keywords: simplebbox
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.5
Description-Content-Type: text/x-rst

==========
SimpleBBox
==========


.. image:: https://img.shields.io/pypi/v/simplebbox.svg
        :target: https://pypi.python.org/pypi/simplebbox

.. image:: https://img.shields.io/travis/serge-m/simplebbox.svg
        :target: https://travis-ci.com/serge-m/simplebbox

.. image:: https://readthedocs.org/projects/simplebbox/badge/?version=latest
        :target: https://simplebbox.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status




Functions for bounding box processing.

In many computer vision tasks a concept of a bounding box is used. In python bounding boxes are often represented
as lists, tuples or numpy arrays of 4 elements. However there is no standard representation and different formats are used.
Some formats are listed below.

* `(min x, min y, width, height)` or `(left, top, width, height)`
* `(min x, min y, max x, max y)` or `(left, top, bottom, right)`
* `(center x, center y, width, height)`

The coordinates can represent either

* relative position in the image dimensions. Then `x` takes values from `0..1` for pixels inside the image

* or absolute position in pixel


This package contains utility functions to convert between those formats.

Installation
--------------------

.. code-block::

   pip install simplebbox

Usage
--------------------

.. code-block::

    from simplebbox.array import x0y0wh_to_x0y0x1y1, x0y0x1y1_to_x0y0wh

    # convert bbox represented as list in ltwh format:
    x0y0wh_to_x0y0x1y1([100, 200, 10, 20])          # [100, 200, 110, 220]

    # and convert it back:
    x0y0x1y1_to_x0y0wh([100, 200, 110, 220])        # [100, 200, 10, 20]


Notes
--------------------

* Free software: MIT license
* Documentation: https://simplebbox.readthedocs.io.



=======
History
=======

0.0.1 (2020-12-16)
------------------

* First release on PyPI.


