Skip to main content

No project description provided

Project description

GitlabCIPipeline GitlabCICoverage Appveyor Pypi Downloads

The kwimage module handles low-level image operations at a high level.

The kwimage module builds on kwarray and provides tools commonly needed when addressing computer vision problems. This includes functions for reading images, non-maximum-suppression, image warp transformations, and run-length-encoding.

The top-level API is:

from .algo import (available_nms_impls, daq_spatial_nms, non_max_supression,)
from .im_alphablend import (ensure_alpha_channel, overlay_alpha_images,
                            overlay_alpha_layers,)
from .im_core import (atleast_3channels, ensure_float01, ensure_uint255,
                      make_channels_comparable, num_channels,)
from .im_cv2 import (convert_colorspace, draw_boxes_on_image,
                     draw_text_on_image, gaussian_patch, imscale, imresize,)
from .im_demodata import (grab_test_image, grab_test_image_fpath,)
from .im_io import (imread, imwrite,)
from .im_runlen import (decode_run_length, encode_run_length, rle_translate,)
from .im_stack import (stack_images, stack_images_grid,)
from .structs import (Boxes, Coords, Detections, Heatmap, Mask, MaskList,
                      MultiPolygon, Points, PointsList, Polygon, PolygonList,
                      smooth_prob,)
from .util_warp import (subpixel_accum, subpixel_align, subpixel_getvalue,
                        subpixel_maximum, subpixel_minimum, subpixel_set,
                        subpixel_setvalue, subpixel_slice, subpixel_translate,
                        warp_points, warp_tensor,)

NOTE: THE KWIMAGE STRUCTS WILL EVENTUALLY MOVE TO THE KWANNOT REPO

The most notable feature of the kwimage module are the kwimage.structs objects. This includes the primitive Boxes, Mask, and Coords objects, The semi-primitive Points, Polygon structures, and the composite Heatmap and Detections structures (note: Heatmap is just a composite of array-like structures).

The primitive and semi-primitive objects store and manipulate annotation geometry, and the composite structures combine primitives into a single object that jointly manipulates the primitives using warp operations.

The Detections structure is a meta-structure that associates the other more primitive components, and allows a developer to compose them into something that represents objects of interest. The details of this composition are left up to the end-application.

The Detections object can also be “rasterized” and converted into a Heatmap object, which represents the same information, but is in a form that is more suitable for use when training convolutional neural networks. Likewise, the output of neural networks can be directly encoded in a kwimage.Heatmap object. The Heatmap.detect method can then be used to convert the dense heatmap representation into a spare Detections representation that is more suitable for use in an object-detection system. We note that the detect function is not a special detection algorithm. The detection algorithm (which is outside the scope of kwimage) produces the heatmap, and the detect method effectively “inverts” the rasterize procedure of Detections by finding peaks in the heatmap, and running non-maximum suppression.

This module contains data structures for image annotation primitives:

  • Boxes

  • Mask

  • Coords

And composites of these primitives:

  • Detections

  • Polygon

  • MultiPolygon

  • PolygonList

  • MaskList

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

kwimage-0.5.4-py2.py3-none-any.whl (155.6 kB view details)

Uploaded Python 2 Python 3

kwimage-0.5.4-cp37-cp37m-manylinux2010_x86_64.whl (696.2 kB view details)

Uploaded CPython 3.7m manylinux: glibc 2.12+ x86-64

kwimage-0.5.4-cp36-cp36m-manylinux2010_x86_64.whl (698.1 kB view details)

Uploaded CPython 3.6m manylinux: glibc 2.12+ x86-64

kwimage-0.5.4-cp35-cp35m-manylinux2010_x86_64.whl (688.7 kB view details)

Uploaded CPython 3.5m manylinux: glibc 2.12+ x86-64

kwimage-0.5.4-cp27-cp27mu-manylinux2010_x86_64.whl (718.0 kB view details)

Uploaded CPython 2.7mu manylinux: glibc 2.12+ x86-64

File details

Details for the file kwimage-0.5.4-py2.py3-none-any.whl.

File metadata

  • Download URL: kwimage-0.5.4-py2.py3-none-any.whl
  • Upload date:
  • Size: 155.6 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.40.2 CPython/3.7.5

File hashes

Hashes for kwimage-0.5.4-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 b8b95ccadd9335ce969f1163319bddb77cdc29f02b92deee2b932837f7f5e642
MD5 2e6d6a60bad134e0185281cd95542f3d
BLAKE2b-256 f689b3f530776fdd523004fecf2c5800a7a8f2459d1e7249de8208157d3e9ba2

See more details on using hashes here.

File details

Details for the file kwimage-0.5.4-cp37-cp37m-manylinux2010_x86_64.whl.

File metadata

  • Download URL: kwimage-0.5.4-cp37-cp37m-manylinux2010_x86_64.whl
  • Upload date:
  • Size: 696.2 kB
  • Tags: CPython 3.7m, manylinux: glibc 2.12+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.40.2 CPython/3.7.5

File hashes

Hashes for kwimage-0.5.4-cp37-cp37m-manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 55e805cf5e55d20426536002fecd65ae1b97a00514a83d581e6459a609b60cb7
MD5 e6b015c3a571084852bc2cd290533989
BLAKE2b-256 95fecee96054f3be2e7bc4d5762022983b6df44094fbcc441f5e773df6bdb513

See more details on using hashes here.

File details

Details for the file kwimage-0.5.4-cp36-cp36m-manylinux2010_x86_64.whl.

File metadata

  • Download URL: kwimage-0.5.4-cp36-cp36m-manylinux2010_x86_64.whl
  • Upload date:
  • Size: 698.1 kB
  • Tags: CPython 3.6m, manylinux: glibc 2.12+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.40.2 CPython/3.6.9

File hashes

Hashes for kwimage-0.5.4-cp36-cp36m-manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 79c4256a72ff5e7e4d4dc962d69f4f2b26e4266815e0c315f7a9135753aa743c
MD5 ea0fb6578564430208036a90be013028
BLAKE2b-256 6177c68a6da70b9da4dcd3678736ededbb818dfbd381363d0328e45688c9abc3

See more details on using hashes here.

File details

Details for the file kwimage-0.5.4-cp35-cp35m-manylinux2010_x86_64.whl.

File metadata

  • Download URL: kwimage-0.5.4-cp35-cp35m-manylinux2010_x86_64.whl
  • Upload date:
  • Size: 688.7 kB
  • Tags: CPython 3.5m, manylinux: glibc 2.12+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.15.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.40.2 CPython/3.5.9

File hashes

Hashes for kwimage-0.5.4-cp35-cp35m-manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 c2b3cfb721ed827522ae9dced406a8069d52726e6643dce7969ce8c86d1fa726
MD5 b63f9eb83cfda57f4f8d70888f42ed9b
BLAKE2b-256 b6e0b298e29697d76480470da500b82294a4d19fe611cd0882809e254f59114b

See more details on using hashes here.

File details

Details for the file kwimage-0.5.4-cp27-cp27mu-manylinux2010_x86_64.whl.

File metadata

  • Download URL: kwimage-0.5.4-cp27-cp27mu-manylinux2010_x86_64.whl
  • Upload date:
  • Size: 718.0 kB
  • Tags: CPython 2.7mu, manylinux: glibc 2.12+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.15.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.40.2 CPython/2.7.17

File hashes

Hashes for kwimage-0.5.4-cp27-cp27mu-manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 3bc333d4f8f25cdff21c36529ea929e963655974b9bcbcdfe381755949289ae8
MD5 d9bb15b369a3a02128fa383e61c28c8e
BLAKE2b-256 c29bcc57da8a8087bc370c68f7c478232b128d6fceec9905c7f60cc47582b262

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page