This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materials including this page, select Japan from the country navigator on the bottom of this page.

dsp.Normalizer System object

Vector normalization along specified dimension


The Normalizer object performs vector normalization along rows, columns, or specified dimension.

To perform vector normalization:

  1. Define and set up your normalization object. See Construction.

  2. Call step to perform vector normalization according to the properties of dsp.Normalizer. 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.


norm = dsp.Normalizer returns a normalization object, norm, that normalizes the input over each column by the squared 2-norm of the column plus a bias term of 1e-10 used to protect against divide-by-zero.

norm = dsp.Normalizer('PropertyName',PropertyValue, ...) returns a normalization object, norm, with each property set to the specified value.



Type of normalization to perform

Specify the type of normalization to perform as 2-norm or Squared 2-norm. The 2-norm mode supports floating-point signals only. The Squared 2-norm supports both fixed-point and floating-point signals. The default is Squared 2-norm.


Real number added in denominator to avoid division by zero

Specify the real number to add in the denominator to avoid division by zero. The default is 1e-10. This property is tunable.


Dimension to operate along

Specify whether to normalize along Column , Row, or Custom. The default is Column.


Numerical dimension to operate along

Specify the one-based value of the dimension over which to normalize. The value of this parameter cannot exceed the number of dimensions in the input signal. This property applies when Dimension property is Custom. The default is 1.

 Fixed-Point Properties


stepNormalize input along specified dimension
Common to All System Objects

Create System object with same property values


Expected number of inputs to a System object


Expected number of outputs of a System object


Check locked states of a System object (logical)


Allow System object property value changes


expand all

Note: This example runs only in R2016b or later. If you are using an earlier release, replace each call to the function with the equivalent step syntax. For example, myObject(x) becomes step(myObject,x).

norm = dsp.Normalizer;
x = magic(3);
y = norm(x);


This object implements the algorithm, inputs, and outputs described on the Normalization block reference page. The object properties correspond to the block parameters, except:

  • Treat sample-based row input as column — The block allows you to input a row vector and normalize the row vector as a column vector. The normalization object always normalizes along the value of the Dimension property.

  • The normalization object does not support the Minimum and Maximum options for data output.

Extended Capabilities

Introduced in R2012a

Was this topic helpful?