Skip to main content

Load and display images and access its content data with one-liners. A PIL wrapper ideal for machine learning and image processing.

Project description


What is ezimage?

Load and display images and access its content data with one-liners. A wrapper for PIL and IPython.display, ideal for machine learning and image processing. Easily load a PNG/JPEG image (or a list of them) from a local machine or the web and use its data in any desired format (e.g. NumPy/PyTorch/TensorFlow/etc). Display or save data arrays from any format or ordering (CHW/WCH). All with one-liners.


pip install ezimage

Example Usage

from ezimage import ezimage
img = ezimage(url='')

Watch this tutorial on YouTube for a walk through.


Enables the user to easily load an image from a path, a url, or by directly providing a data array. If a list is provided, a list of ezimage instances will be retunred. The properties enable the user to access the image data in R, G, B, A, GS (grayscale), HWC, and CHW formats. In IPython environments such as in Jupyter, the display method allows the user to view images. Unlike PIL, this method allows for iterative image display.

Regardless of the ordering, format, or type of data, if directly feeding data arrays, all values must be in a valid PNG range (between 0 and 255).

Versatile Data Type and Data Format

User is free to choose the format of the data arrays specified with format_func.

format_func is a function that converts a PIL image to user's desired format. The output must cast to a NumPy array (i.e. no error when running np.array(format_func(PIL_img))). See examples below.

Note that the internal computations are done using PIL functions or NumPy arrays and format_func is only designated for the user interface.

NumPy uint8 Example:

format_func=lambda PIL_Image: np.array(PIL_Image, dtype=np.uint8)

NumPy float16 Example:

format_func=lambda PIL_Image: np.array(PIL_Image, dtype=np.float16)

PyTorch float32 Example:

import torch
format_func=lambda PIL_Image: torch.tensor(np.array(PIL_Image), dtype=torch.float32)

Example usage for a single image from the web:

img = ezimage(url="")

Example usage for reading all PNG files in a directory:

from ezimage import ezimage
from pathlib import Path
path_parent = Path("path/to/image/folder/")
pathList = list(path_parent.glob("*.png"))
imgList = [ezimage(p) for p in pathList]
for img in imgList:

Project details

Release history Release notifications | RSS feed

This version


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 Distribution

ezimage-0.8-py3-none-any.whl (5.5 kB view hashes)

Uploaded py3

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