File Exchange

image thumbnail


version (2.86 KB) by

Performs LOCAL Otsu thresholding on an image, with a user-specified blocksize.



View License

Performs LOCAL Otsu thresholding on an image; user can specify blocksize. Facilitates the threshold-segmentation of images with uneven illumination, without the need for background normalization.

SYNTAX: B = thresholdLocally(A,blksz,varargin)

THRESHOLDLOCALLY processes an image, calling graythresh on LOCAL blocks in an image. This facilitates easy thresholding of images with uneven background illumination, for which global thresholding is inadequate. Uses the Image Processing Toolbox function BLOCKPROC (R2009b).

A: Any image (or path/name of an image) suitable for processing with im2bw()
BLKSZ: (Optional) Block size of A, for determination of Otsu thresholding using graythresh(). In the form or [M,N]. Default is as determined by BESTBLK.
1) Any P-V pair accepted by BLOCKPROC.
2) FudgeFactor: a scalar value by which to multiply the local value returned by graythresh.

B: Output image

img = imread('rice.png');
thresholded = thresholdLocally(img);

Comments and Ratings (7)

jia zheng

Brett Shoelson

Brett Shoelson (view profile)

There's no paper to steer you to, except for the same one cited in the <graythresh> doc. I simply used the architecture of blockproc, and called graythresh (Otsu's method) on each local block.


Chad (view profile)

Could you tell me that your code is related to which paper?


sara (view profile)


Nad (view profile)

Brett Shoelson

Brett Shoelson (view profile)

The NEW version is now available; have at it! Comments/suggestions welcome.

Brett Shoelson

Brett Shoelson (view profile)

Please note: I've submitted a semi-major revision, and am waiting for it to clear. The function will soon accept as optional arguments all PV pairs accepted by BLOCKPROC, and a "fudge factor," by which to multiply the local value returned by graythresh. You may want to wait until the new version is up to download this.


Updated license


Minor change to replace default blocksize of [32 32] by that returned by function BESTBLK.


Fixed problem with screenshot. (Image was inappropriately rotated.)


Modified significantly to accept as optional inputs all parameter-value pairs accepted by BLOCKPROC, as well as an additional "fudge factor" parameter that allows one to scale the local graythresh value by a scalar multiple.

MATLAB Release
MATLAB 7.11 (R2010b)

Download apps, toolboxes, and other File Exchange content using Add-On Explorer in MATLAB.

» Watch video