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:

1 2 3

>>> 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)://):

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

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

1	>>> 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):

1 2 3 4

>>> 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:

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

Get the top row of the picture:

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

Set the bottom-left pixel to black:

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

Set the top row to red:

1	>>> 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.