Documentation |
Package: dsp
Find mean value of input or sequence of inputs
The Mean object finds the mean of an input or sequence of inputs.
To compute the mean of an input or sequence of inputs:
Define and set up your System object™. See Construction.
Call step to compute the mean according to the properties of dsp.Mean. The behavior of step is specific to each object in the toolbox.
H = dsp.Mean returns an object, H, that computes the mean of an input or a sequence of inputs.
H = dsp.Mean('PropertyName',PropertyValue,...) returns a mean-finding object, H, with each specified property set to the specified value.
RunningMean |
Calculate over single input or multiple inputs When you set this property to true, the object calculates the mean over successive calls to the step method. When you set this property to false, the object computes the mean over the current input. The default is false. |
ResetInputPort |
Additional input to enable resetting of running mean Set this property to true to enable resetting of the running mean. When you set this property to true, you must specify a reset input to the step method to reset the running mean. This property applies only when you set the RunningMean property to true. The default is false. |
ResetCondition |
Condition that triggers resetting of running mean Specify the event that resets the running maximum as one of | Rising edge | Falling edge | Either edge | Non-zero |. This property applies only when you set the ResetInputPort property to true. The default is Non-zero. |
Dimension |
Dimension to operate along Specify how the mean calculation is performed over the data as one of | All | Row | Column | Custom |. This property applies when you set the RunningMean property to false. The default is Column. |
CustomDimension |
Numerical dimension to calculate over Specify the integer dimension, indexed from one, of the input signal over which the object calculates the mean. The value cannot exceed the number of dimensions in the input signal. This property only applies when you set the Dimension property to Custom. The default is 1. |
ROIProcessing |
Enable region-of-interest processing Set this property to true to enable calculation of the mean within a particular region of an image. This property applies when you set the Dimension property to All and the RunningMean property to false. The default is false. For full ROI processing support, install the Computer Vision System Toolbox™ product. If you only have the DSP System Toolbox™ product installed, you can only specify the value of the ROIForm property as Rectangles. |
ROIForm |
Type of region of interest Specify the type of region of interest as one of | Rectangles | Lines | Label matrix |. This property applies only when you set the ROIProcessing property to true. The default is Rectangles. For full ROI processing support, install the Computer Vision System Toolbox product. If you have only the DSP System Toolbox product installed, you can only specify the as Rectangles. |
ROIPortion |
Calculate over entire ROI or just perimeter Specify whether to calculate the mean over the Entire ROI or the ROI perimeter. This property applies only when you set the ROIForm property to Rectangles. The default is Entire ROI. |
ROIStatistics |
Calculate statistics for each ROI or one for all ROIs Specify whether to calculate Individual statistics for each ROI or a Single statistic for all ROIs. This property applies only when you set the ROIForm property to Rectangles, Lines, or Label matrix. The default is Individual statistics for each ROI. |
ValidityOutputPort |
Output flag indicating if any part of ROI is outside input image When you set the ROIForm property to one of | Lines | Rectangles | Binary mask |, set this property to true to return the validity of the specified ROI being completely inside of the image. When you set the ROIForm property to Label Matrix, set this property to true to return the validity of the specified label numbers. The default is false. |
FrameBasedProcessing |
Process input as frames or samples Set this property to true to enable frame-based processing for 2-D inputs. Set this property to false to enable sample-based processing. The object always performs sample-based processing for N-D inputs where N is greater than 2. This property applies when you set the RunningMean to true. The default is true. |
clone | Create mean object with same property values |
getNumInputs | Number of expected inputs to step method |
getNumOutputs | Number of outputs of step method |
isLocked | Locked status for input attributes and nontunable properties |
release | Allow property value and input characteristics changes |
reset | Reset internal states of mean-finding object |
step | Mean value |
Compute the mean of a signal:
hmean1 = dsp.Mean; x = randn(100,1); y = step(hmean1, x);
Compute the running mean of a signal:
hmean2 = dsp.Mean; hmean2.RunningMean = true; x = randn(100,1); y = step(hmean2, x); % y(i) is the mean of all values in the vector x(1:i)
This object implements the algorithm, inputs, and outputs described on the Mean block reference page. The object properties correspond to the block parameters, except:
Treat sample-based row input as a column block parameter is not supported by the dsp.Mean object. |
Both this object and its corresponding block let you specify whether to process inputs as individual samples or as frames of data. The object uses the FrameBasedProcessing property. The block uses the Input processing parameter. See Set the FrameBasedProcessing Property of a System object for more information.