Interactive Show Image

Display images in Jupyter web UI, that is JupyterLab and Jupyter Notebook.

Encodes the image directly into HTML (base64) without going through matplotlib.

The compression format is customizable. A single function call can show multiple images in a grid.

• show(img_1, img_2) will draw each image on a separate row
• show([img_1, img_2]) will draw both images in one row
• show([img_1, img_2], [img_3, img_4]) will draw two rows of two images

Specifying the format:

• show(..., fmt='webp'): image format, usually png jpeg webp
• show.set_default_image_format('webp')
• The default is png, please use webp or jpeg to reduce notebook file size

Whether to try converting unusual shapes and datatypes to the needed RGB:

• show(..., adapt=True or False)

Convenience functions imread, imwrite are also provided (based on PIL).

Demo

Try the demo notebook.

Installation

• pip install show-image

or

• Include the file show_image.py in your project
• Ensure libraries are installed: Pillow numpy matplotlib ipython