Mahotas: Computer Vision Library
Project description
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
Support
Website: http://luispedro.org/software/mahotas
API Docs: http://packages.python.org/mahotas/
Mailing List: Use the pythonvision mailing list for questions, bug submissions, etc.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
