Mahotas: Image Processing for numpy
Jump to full API Documentation
Contents:
Image Processing Library for Python.
It includes a couple of algorithms implemented in C++ for speed while operating
in numpy arrays.
- Notable algorithms:
- watershed.
- convex points calculations.
- hit & miss. thinning.
- Zernike & Haralick, LBP, and TAS features.
- freeimage based numpy image loading (requires freeimage libraries to be
installed).
- Speeded-Up Robust Features (SURF), a form of local features.
- thresholding.
- convolution.
- Sobel edge detection.
Examples
This is a simple example of loading a file (called test.jpeg) and calling
watershed using above threshold regions as a seed (we use Otsu to define
threshold).
import numpy as np
from scipy import ndimage
import mahotas
import pylab
img = mahotas.imread('test.jpeg')
T_otsu = mahotas.thresholding.otsu(img)
seeds,_ = ndimage.label(img > T_otsu)
labeled = mahotas.cwatershed(img.max() - img, seeds)
pylab.imshow(labeled)
Recent Changes
0.8 (May 7 2012)
- Move features to submodule
- Add morph.open function
- Add morph.regmax & morph.regmin functions
- Add morph.close function
- Fix morph.dilate crash
0.7.3 (March 14 2012)
- Fix installation of test data
- Greyscale erosion & dilation
- Use imread module (if available)
- Add output argument to erode() & dilate()
- Add 14th Haralick feature (patch by MattyG) — currently off by default
- Improved zernike interface (zernike_moments)
- Add remove_bordering to labeled
- Faster implementation of bwperim
- Add roundness shape feature
0.7.2 (February 13 2012)
There were two minor additions:
- Add as_rgb (especially useful for interactive use)
- Add Gaussian filtering (from scipy.ndimage)
And a few bugfixes:
- Fix type bug in 32 bit machines (Bug report by Lech Wiktor Piotrowski)
- Fix convolve1d
- Fix rank_filter
0.7.1 (January 6 2012)
The most important change fixed compilation on Mac OS X
Other changes:
- Add convolve1d
- Check that convolution arguments have right dimensions (instead of
crashing)
- Add descriptor_only argument to surf.descriptors
- Specify all function signatures on freeimage.py
For version 0.7 (Dec 5 2011):
The big change was that the dependency on scipy was removed. As part of this
process, the interpolate submodule was added. A few important bug fixes as
well.
- Allow specification of centre in Zernike moment computation
- Fix Local Binary Patterns
- Remove dependency on scipy
- Add interpolate module (from scipy.ndimage)
- Add labeled_sum & labeled_sizes
- gvoronoi no longer depends on scipy
- mahotas is importable without scipy
- Fix bugs in 2D TAS (reported by Jenn Bakal)
- Support for 1-bit monochrome image loading with freeimage
- Fix GIL handling on errors (reported by Gareth McCaughan)
- Fix freeimage for 64-bit computers
For version 0.6.6 (August 8 2011):
- Fix fill_polygon bug (fix by joferkington)
- Fix Haralick feature 6 (fix by Rita Simões)
- Implement morph.get_structuring_element for ndim > 2. This implies that
functions such as label() now also work in multiple dimensions
- Add median filter & rank_filter functions
- Add template_match function
- Refactor by use of mahotas.internal
- Better error message for when the compiled modules cannot be loaded
- Update contact email. All docs in numpydoc format now.
For version 0.6.5:
- Add max_points & descriptor_only arguments to mahotas.surf
- Fix haralick for 3-D images (bug report by Rita Simões)
- Better error messages
- Fix hit&miss for non-boolean inputs
- Add label() function
For version 0.6.4:
- Fix bug in cwatershed() when using return_lines=1
- Fix bug in cwatershed() when using equivalent types for image and markers
- Move tests to mahotas.tests and include them in distribution
- Include ChangeLog in distribution
- Fix compilation on the Mac OS
- Fix compilation warnings on gcc
For version 0.6.3:
- Improve mahotas.stretch() function
- Fix corner case in surf (when determinant was zero)
- threshold argument in mahotas.surf
- imreadfromblob() & imsavetoblob() functions
- max_points argument for mahotas.surf.interest_points()
- Add mahotas.labeled.borders function
For version 0.6.2:
Bugfix release:
- Fix memory leak in _surf
- More robust searching for freeimage
- More functions in mahotas.surf() to retrieve intermediate results
- Improve compilation on Windows (patches by Christoph Gohlke)
For version 0.6.1:
- Release the GIL in morphological functions
- Convolution
- just_filter option in edge.sobel()
- mahotas.labeled functions
- SURF local features
For version 0.6:
- Improve Local Binary patterns (faster and better interface)
- Much faster erode() (10x faster)
- Faster dilate() (2x faster)
- TAS for 3D images
- Haralick for 3D images