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
Usage
Import imshow
from imshowtools
and use it like:
from imshowtools import imshow
imshow(lenna)
Advanced Usage
Colorspaces
OpenCV lover? imshowtools
can also handle cv2
's BGR images
import cv2
cv2image = cv2.imread('lenna.png')
imshow(cv2image)
cvshow(cv2image) # cvshow convenience function
imshow(cv2image, mode='BGR') # imshow with mode
Tip: imshow
can display [h, w, 1]
shaped images as well
in addition to [h, w]
single channel images.
Show Multiple Images
imshow(image_1, image_2, image_3)
Show Multiple Images from List
imshow(*[my_image_list])
Example:
mnist = tf.keras.datasets.mnist
(x_train, y_train), (x_test, y_test) = mnist.load_data()
x_train, x_test = x_train / 255.0, x_test / 255.0
[x_train.shape, y_train.shape], [x_test.shape, y_test.shape]
imshow(*x_train[:25])
Multiple images with colorspace:
imshow(*x_train[:100], cmap='gray')
Single Row and Single Column
imshow(*x_train[:16], cmap='binary', rows=1)
imshow(*x_train[:4], cmap='binary', columns=1)
Smart Wrapping / Custom Rows and Columns
imhow
chooses the optimal layout:
- Have 6 images? You get 2x3
- Have 12 images? You get 3x4
- Have 20 images? You get 4x5
You can also choose to manually control how many rows and columns you
imshow(*my_image_array, rows=3, columns=4)
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)
Uninstall
To uninstall imshowtools
,
pip uninstall imshowtools
Contributing
Pull requests are very welcome.
- Fork the repo
- Create new branch with feature name as branch name
- Check if things work with a jupyter notebook
- Raise a pull request
Licence
Please see attached Licence
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for imshowtools-0.4.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 02f4f81929169329719e18ee4d69b84b14567183fc96e9c4e65144948cc96cee |
|
MD5 | 4e9ee797c87c7ed1f33f7f8ad0313c79 |
|
BLAKE2b-256 | ed4d86d01c190230f17c67cf94e5a0381f2e5f00c5b28d22da7b518e63c5b9a5 |