Mahotas

Python Computer Vision Library

This library of fast computer vision algorithms (all implemented in C++) operates over numpy arrays for convenience.

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.
• spline interpolation

Contacts

For bugfixes, feel free to use my email: [email protected]

For more general with achieving certain tasks in Python, the pythonvision mailing list is a much better venue and generates a public discussion log for others in the future.

Recent Changes

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

0.7 (December 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

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)

0.6.1 (Dec 13 2010)

• SURF local features
• Convolution
• mahotas.labeled functions
• just_filter option in edge.sobel()
• Release the GIL in morphological functions

0.6 (Nov 22 2010)

• 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
• Fix mahotas.imread for RGBA images

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.

Author: Luis Pedro Coelho (with code by Zachary Pincus [from scikits.image], Peter J. Verveer [from scipy.ndimage], and Davis King [from dlib])