Module: novice¶

skimage.novice¶

A special Python image submodule for beginners.

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

>>> picture.show()  

>>> picture.format
'png'

>>> picture.path.endswith('chelsea.png')
True

>>> picture.size
(451, 300)
>>> picture.width
451

>>> picture.show()  

>>> picture.size = (45, 30)

>>> picture.compare()  

>>> for pixel in picture:
...     if (pixel.red > 128) and (pixel.x < picture.width):
...         pixel.red = pixel.red / 2

>>> picture.modified
True
>>> print(picture.path)
None

>>> picture[0:20, 0:20] = (0, 0, 0)

>>> picture.save('save-demo.jpg')
>>> picture.path.endswith('save-demo.jpg')
True
>>> picture.format
'jpeg'
>>> picture.modified
False

>>> picture[0:20, 0:20] = (0, 0, 0)
>>> picture.compare()  
>>> picture.reset()
>>> picture.compare()  

open¶

skimage.novice.open(path)[source]¶

Return Picture object from the given image path.

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.