ImageTools - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Graphics : Image Processing : ImageTools Package : ImageTools/PlotHistogram

ImageTools

  

PlotHistogram

  

compute and plot the intensity distribution histogram for each layer (color channel) of an image

 

Calling Sequence

Parameters

Options

Description

Examples

Calling Sequence

PlotHistogram( img, buckets, opts )

Parameters

img

-

Image; input image

buckets

-

(optional) posint; number of buckets/bins

opts

-

(optional) equation(s) of the form option = value; specify options for the PlotHistogram command

Options

• 

autorange = truefalse

  

If true, set the range to the minimum and maximum values that occur in the image (on all layers).  Overrides the range option. The default is false.

• 

cumulative = truefalse

  

Specifies that the count in each bucket is to include the counts in all the lower numbered buckets.  This is especially useful in conjunction with the normalized option causing each bucket to end up containing a value indicating which fraction of the pixels in the image were less than or equal to the upper bound of the bucket. By selecting an appropriate number of buckets (4, 5, 100), the values correspond to concepts like quartiles, quintiles, and percentiles. The default is false.

• 

decomb = truefalse

  

Specifies that empty buckets are to be smoothed over when plotting the histogram. Image processing manipulations often spread values over a larger range, leaving empty buckets distributed throughout the resulting histogram, making it look somewhat like a comb. Specifying the decomb option makes the resulting plots easier to interpret. The default is false.

• 

normalized = truefalse

  

If true, the value in each bucket of each layer is scaled so that the sum of the values in the buckets in a layer is 1.0. The default is false.

• 

range = numeric .. numeric

  

Assigns the range of values that the buckets cover. The default is 0.0 .. 1.0, which corresponds to the the range of values in an unprocessed image.

Description

• 

The PlotHistogram command plots a histogram for each channel in an image.

• 

The img parameter specifies the image.

• 

The optional buckets parameter specifies the number of buckets per color channel desired. For most images, which were originally read from 8-bit per channel image files, the default of 256 is a suitable value.

Examples

withImageTools:

imgCreate100,200,r,c→evalf0.1+0.3sinr50+0.3sinc30:

PlotHistogramimg,100

PlotHistogramimg,100,autorange

PlotHistogramimg,autorange,normalized

PlotHistogramimg,autorange

PlotHistogramimg,range=0..0.5

See Also

ImageTools

ImageTools[Histogram]

 


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam