picture

Picture

class skimage.novice.Picture(path=None, array=None, xy_array=None) [source]

Bases: object

A 2-D picture made up of pixels.

Examples

Load an image from a file:

>>> from skimage import novice
>>> from skimage import data
>>> picture = novice.open(data.data_dir + '/chelsea.png')

Load an image from a URL (the URL must start with http(s):// or ftp(s)://):

>>> picture = novice.open('http://scikit-image.org/_static/img/logo.png')

Create a blank 100 pixel wide, 200 pixel tall white image:

>>> pic = Picture.from_size((100, 200), color=(255, 255, 255))

Use numpy to make an RGB byte array (shape is height x width x 3):

>>> import numpy as np
>>> data = np.zeros(shape=(200, 100, 3), dtype=np.uint8)
>>> data[:, :, 0] = 255  # Set red component to maximum
>>> pic = Picture(array=data)

Get the bottom-left pixel:

>>> pic[0, 0]
Pixel(red=255, green=0, blue=0, alpha=255)

Get the top row of the picture:

>>> pic[:, pic.height-1]
Picture(100 x 1)

Set the bottom-left pixel to black:

>>> pic[0, 0] = (0, 0, 0)

Set the top row to red:

>>> pic[:, pic.height-1] = (255, 0, 0)

Attributes

path	The path to the picture.
array	Image data stored as numpy array.
xy_array	Image data stored as numpy array with origin at the bottom-left.

__init__(path=None, array=None, xy_array=None) [source]

alpha

The transparency component of the pixel (0-255).

array

Image data stored as numpy array.

blue

The blue component of the pixel (0-255).

compare() [source]

Compare the image to its unmodified version.

format

The image format of the picture.

static from_size(size, color='black') [source]

Return a Picture of the specified size and a uniform color.

Parameters:	size : tuple Width and height of the picture in pixels. color : tuple or str RGB or RGBA tuple with the fill color for the picture [0-255] or a valid key in color_dict.

green

The green component of the pixel (0-255).

height

The height of the picture.

modified

True if the picture has changed.

path

The path to the picture.

red

The red component of the pixel (0-255).

reset() [source]

Reset image to its original state, removing modifications.

rgb

The RGB color components of the pixel (3 values 0-255).

rgba

The RGBA color components of the pixel (4 values 0-255).

save(path) [source]

Saves the picture to the given path.

Parameters:	path : str Path (with file extension) where the picture is saved.

show() [source]

Display the image.

size

The size (width, height) of the picture.

width

The width of the picture.

xy_array

Image data stored as numpy array with origin at the bottom-left.