Histogram of input or sequence of inputs
The Histogram
object generates a histogram
for an input or a sequence of inputs.
To generate a histogram for an input or a sequence of inputs:
Define and set up your histogram object. See Construction.
Call step
to generate the histogram
for an input according to the properties of dsp.Histogram
.
The behavior of step
is specific to each object in
the toolbox.
Starting in R2016b, instead of using the step
method
to perform the operation defined by the System
object™, you can
call the object with arguments, as if it were a function. For example, y
= step(obj,x)
and y = obj(x)
perform
equivalent operations.
hist = dsp.Histogram
returns
a histogram object, hist
, that computes the frequency
distribution of the elements in each input matrix.
hist = dsp.Histogram('
returns a histogram object, PropertyName
',PropertyValue
,
...)hist
,
with each specified property set to the specified value.
hist = dsp.Histogram(
returns
a histogram object, MIN
,MAX
,NUMBINS
,'PropertyName
',PropertyValue
,...)hist
, with the LowerLimit
property
set to MIN
, UpperLimit
property
set to MAX
, NumBins
property
set to NUMBINS
and other specified properties
set to the specified values.

Lower boundary Specify the lower boundary of the lowestvalued bin as a realvalued
scalar. 

Upper boundary Specify the upper boundary of the highestvalued bin as a realvalued
scalar. 

Number of bins in histogram Specify the number of bins in the histogram. The default is 

Specify how the histogram calculation is performed over the
data as one of  

Enable output vector normalization Specify whether the histogram object normalizes the output vector, v,
so that $$sum(v)=1$$.
When you set this property to 

Enable calculation over successive Set this property to 

Enable resetting in running histogram mode Set this property to 

Reset condition for running histogram mode Specify the event that resets the running histogram as one of
 
reset  Reset histogram bin values to zero 
step  Histogram for input data 
Common to All System Objects  

clone  Create System object with same property values 
getNumInputs  Expected number of inputs to a System object 
getNumOutputs  Expected number of outputs of a System object 
isLocked  Check locked states of a System object (logical) 
release  Allow System object property value changes 
This object implements the algorithm, inputs, and outputs described on the Histogram block reference page. The object properties correspond to the block parameters, except:
The Reset port block parameter
corresponds to both the ResetCondition
and the ResetInputPort
object
properties.
The Find histogram over block parameter corresponds to the Dimension property of the object.