mirror of
https://github.com/wassname/scikit-image.git
synced 2026-06-29 16:16:07 +08:00
Steven Silvester
a939eb4ce6
Use container and pip cache Add the sudo calls back in Try removing sudo and the tk install Skip show() call in novice doctest Try not building docs and no libqt4-dev Try the optional installs right away Do not install PyQt4 or imread Try without libfreeimage Try and install libfreeimage outside of root Another attempt at libfreeimage Yet another attempt at libfreeimage Use the travis whitelist Try adding the sudo command Try and build the docs Install scikit-image first Restore full build functionality Fix whitespace Remove unused tk import
96 lines
2.1 KiB
Python
96 lines
2.1 KiB
Python
"""
|
|
skimage.novice
|
|
==============
|
|
A special Python image submodule for beginners.
|
|
|
|
Description
|
|
-----------
|
|
``skimage.novice`` provides a simple image manipulation interface for
|
|
beginners. It allows for easy loading, manipulating, and saving of image
|
|
files.
|
|
|
|
This module is primarily intended for teaching and differs significantly from
|
|
the normal, array-oriented image functions used by scikit-image.
|
|
|
|
.. note::
|
|
|
|
This module uses the Cartesian coordinate system, where the origin is at
|
|
the lower-left corner instead of the upper-right and the order is x, y
|
|
instead of row, column.
|
|
|
|
|
|
Example
|
|
-------
|
|
We can create a Picture object open opening an image file:
|
|
|
|
>>> from skimage import novice
|
|
>>> from skimage import data
|
|
>>> picture = novice.open(data.data_dir + '/chelsea.png')
|
|
|
|
We can display pictures (after running this command, close the window to access the prompt again):
|
|
|
|
>>> picture.show() # doctest: +SKIP
|
|
|
|
Pictures know their format:
|
|
|
|
>>> picture.format
|
|
'png'
|
|
|
|
... and where they came from:
|
|
|
|
>>> picture.path.endswith('chelsea.png')
|
|
True
|
|
|
|
... and their size:
|
|
|
|
>>> picture.size
|
|
(451, 300)
|
|
>>> picture.width
|
|
451
|
|
|
|
As a reminder, we can preview the picture with our earlier command:
|
|
|
|
>>> picture.show() # doctest: +SKIP
|
|
|
|
Changing `size` resizes the picture.
|
|
|
|
>>> picture.size = (45, 30)
|
|
|
|
We can preview the changes we made to the picture with our earlier command:
|
|
|
|
>>> picture.show() # doctest: +SKIP
|
|
|
|
You can iterate over pixels, which have RGB values between 0 and 255,
|
|
and know their location in the picture.
|
|
|
|
>>> for pixel in picture:
|
|
... if (pixel.red > 128) and (pixel.x < picture.width):
|
|
... pixel.red = pixel.red / 2
|
|
|
|
Pictures know if they've been modified from the original file
|
|
|
|
>>> picture.modified
|
|
True
|
|
>>> print(picture.path)
|
|
None
|
|
|
|
Pictures can be indexed like arrays
|
|
|
|
>>> picture[0:20, 0:20] = (0, 0, 0)
|
|
|
|
Saving the picture updates the path attribute, format, and modified state.
|
|
|
|
>>> picture.save('save-demo.jpg')
|
|
>>> picture.path.endswith('save-demo.jpg')
|
|
True
|
|
>>> picture.format
|
|
'jpeg'
|
|
>>> picture.modified
|
|
False
|
|
|
|
"""
|
|
from ._novice import Picture, open, colors, color_dict
|
|
|
|
|
|
__all__ = ['Picture', 'open', 'colors', 'color_dict']
|