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.5-py2.py3-none-any.whl (156.7 kB view details)

Uploaded Python 2 Python 3

kwimage-0.5.5-cp37-cp37m-manylinux2010_x86_64.whl (697.2 kB view details)

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

kwimage-0.5.5-cp36-cp36m-manylinux2010_x86_64.whl (699.2 kB view details)

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

kwimage-0.5.5-cp35-cp35m-manylinux2010_x86_64.whl (689.8 kB view details)

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

kwimage-0.5.5-cp27-cp27mu-manylinux2010_x86_64.whl (719.0 kB view details)

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

File details

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

File metadata

  • Download URL: kwimage-0.5.5-py2.py3-none-any.whl
  • Upload date:
  • Size: 156.7 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/42.0.2 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/3.7.6

File hashes

Hashes for kwimage-0.5.5-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 e026bf99c19aa83154914f74b5f755f3b1de39ba95968e97b902b0f31b12f384
MD5 364cab9556198eaeed19cc84c95c08a4
BLAKE2b-256 ab4db5de6cc61933991bb607365a05f8df99aa8923722bdce17bf1cbac0b9332

See more details on using hashes here.

File details

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

File metadata

  • Download URL: kwimage-0.5.5-cp37-cp37m-manylinux2010_x86_64.whl
  • Upload date:
  • Size: 697.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/42.0.2 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/3.7.6

File hashes

Hashes for kwimage-0.5.5-cp37-cp37m-manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 de0873f097b2d05118caf9c41497c1eddf957eb81af8cf51d4f1a8fed7042956
MD5 b8efd41de4830f19d6c0f7f6aa02ec5e
BLAKE2b-256 4326588192c9466c8e2ee3d38edbe311d388a26155020ce12adf88fdb9a9b843

See more details on using hashes here.

File details

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

File metadata

  • Download URL: kwimage-0.5.5-cp36-cp36m-manylinux2010_x86_64.whl
  • Upload date:
  • Size: 699.2 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/42.0.2 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/3.6.10

File hashes

Hashes for kwimage-0.5.5-cp36-cp36m-manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 45e254eedb3b21e66f76839201f6ce1e23f169821bb96ac1753500d77044d7d0
MD5 d5e231ff8b8d15471f475cfe3113cbf3
BLAKE2b-256 b80dbcdded397668ec333a6611c71aba3a31274abe6322c316ce7ebc03d2d89a

See more details on using hashes here.

File details

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

File metadata

  • Download URL: kwimage-0.5.5-cp35-cp35m-manylinux2010_x86_64.whl
  • Upload date:
  • Size: 689.8 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/42.0.2 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/3.5.9

File hashes

Hashes for kwimage-0.5.5-cp35-cp35m-manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 45bd75ca3164ccea54fdb8912a73cfaa3d144bf586419a098256ab2c0c54a271
MD5 9dfc0e9bfc32ca33ba6f4500a77e4c94
BLAKE2b-256 5578660b4a8164fb054f1733823358f38c32fba45ac3f3933ced3e0538645cc0

See more details on using hashes here.

File details

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

File metadata

  • Download URL: kwimage-0.5.5-cp27-cp27mu-manylinux2010_x86_64.whl
  • Upload date:
  • Size: 719.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/42.0.2 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/2.7.17

File hashes

Hashes for kwimage-0.5.5-cp27-cp27mu-manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 80356b19bea31357fed9cc15a1e8d55ec59e2241fdb93d2796edd0d61a90a68e
MD5 dbbddfbac7d375795c9cb49d7b19166a
BLAKE2b-256 e0d9784b80719e9c3a0fba1fc031108f5fb7ff26df2119bdedf906d27e15ed65

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