Skip to main content

imshowtools contains simplified imshow functions to show multiple images and with other options

Project description

imshowtools

This library lets you view images in Jupyter notebooks in a much simpler and intuitive way. Ships with a better 'imshow' function with Multi Images, Smart Wrap and BGR support!.

Installation

To install imshowtools, simply do

pip install imshowtools

Quick Plot

Import imshow from imshowtools and use it:

from imshowtools import imshow
import tensorflow as tf
(x_train, y_train), (x_test, y_test) = tf.keras.datasets.mnist.load_data()

imshow(x_train[0])
imshow(x_train[0], x_train[1], x_train[2])
imshow(*x_train[:20], cmap='binary')
imshow(*x_train[:100], cmap='binary', size=(10, 10))

You can use any matplotlib compatible cmap

mnist

Example ipynb notebook and Python along with test images provided in the example folder.

Get Numpy Image

You can use obtain numpy image in any of ['RGB', 'RGBA', 'ARGB', 'BW', 'L', "BGR", "BGRA", "ABGR"] colorspaces.

image = imshow(*x_train[:100], return_image=True)
image = imshow(*x_train[:100], return_image="RGBA")
image = imshow(*x_train[:100], return_image="RGB")
image = imshow(*x_train[:100], return_image="BW")
print(image.shape)

# cv2.imwrite("saved_sample.png", image)
# do stuff with 'image' or even
# imshow(image)

Output:

(288, 432, 3)
(288, 432, 4)
(288, 432, 3)
(288, 432)

Rows and Columns

imshow(*x_train[:15], cmap='Purples', rows=1)
imshow(*x_train[:24], cmap='Greens', columns=4)

mnist

Open CV Images

lenna = cv2.imread('example/lenna.png')
imshow(lenna)
cvshow(lenna)
imshow(lenna, mode='BGR')

image = imshow(*[lenna for _ in range(12)], return_image="BW")
print(image.shape)
imshow(image)

lenna

Namespaces

If you do not want to use imshow directly in your app (maybe you have another function named imshow), you shall use it like

import imshowtools
imshowtools.imshow(your_image)

or if you like to use a custom namespace

import imshowtools as my_namespace
my_namespace.imshow(your_image)

Contributing

Pull requests are very welcome.

  1. Fork the repo
  2. Create new branch with feature name as branch name
  3. Check if things work with a jupyter notebook
  4. Raise a pull request

Licence

Please see attached Licence

Project details


Download files

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

Source Distribution

imshowtools-0.6.5.tar.gz (5.8 kB view details)

Uploaded Source

Built Distribution

imshowtools-0.6.5-py3-none-any.whl (7.4 kB view details)

Uploaded Python 3

File details

Details for the file imshowtools-0.6.5.tar.gz.

File metadata

  • Download URL: imshowtools-0.6.5.tar.gz
  • Upload date:
  • Size: 5.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.4

File hashes

Hashes for imshowtools-0.6.5.tar.gz
Algorithm Hash digest
SHA256 84120ff5c93b74a9740c0a5135ca4e9dfd765021342deedc1f65b50366e6e9d0
MD5 7e86a5399b6c3a3e09c8c13d84a6d3e7
BLAKE2b-256 6a6573a495e6598cf0842fda16ff597354e767393698d159677e94650e63ba4b

See more details on using hashes here.

File details

Details for the file imshowtools-0.6.5-py3-none-any.whl.

File metadata

  • Download URL: imshowtools-0.6.5-py3-none-any.whl
  • Upload date:
  • Size: 7.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.4

File hashes

Hashes for imshowtools-0.6.5-py3-none-any.whl
Algorithm Hash digest
SHA256 99da2bda708182b0c1a80e41f0647f4a2f2a3f8b28b8c08df3f8a3d96c207060
MD5 5b0d244bb20a6ef46b695a5554b1c879
BLAKE2b-256 7fa06a86b0333ad87fe27aeb00c1432eb45720a07f4e362b0cccad389a4cabe9

See more details on using hashes here.

Supported by

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