Store 
| Products & Services | Solutions | Academia | Support | User Community | Company |
 |
Download Product Updates | | |  |
Get Pricing | | | |
Trial Software |
| Documentation → Signal Processing Blockset |
| Products & Services | Solutions | Academia | Support | User Community | Company |
|
Download Product Updates | | | |
Get Pricing | | | |
Trial Software |
| Documentation → Signal Processing Blockset |
| Contents | Index |
| Learn more about Signal Processing Blockset |
Statistics
dspstat3
The Correlation block computes the cross-correlation of the first dimension of a sample-based N-D input array u, and the first dimension of a sample-based N-D input array v. The block can also independently cross-correlate a sample-based vector with the first-dimension of an N-D input array. For frame-based inputs, the Correlation block computes the cross-correlation of analogous columns of an Mu-by-N input matrix u and an Mv-by-N input matrix v. The Correlation block can also independently cross-correlate a single-channel frame-based column vector with each column of a multiple-channel frame-based matrix.
The frame status of both inputs to the Correlation block must be the same. The output of the block is always sample-based.
The Correlation block accepts real and complex floating-point and fixed-point inputs except for complex unsigned fixed-point inputs. Fixed-point signals are not supported for the frequency domain.
When the inputs to the Correlation block are an Mu-by-N frame-based input matrix u and an Mv-by-N frame-based input matrix v, the output, y, is a sample-based (Mu+Mv–1)-by-N matrix whose jth column has elements
where * denotes the complex conjugate. Inputs u and v are zero when indexed outside of their valid ranges. When both inputs are real, the output is real; when one or both inputs are complex, the output is complex.
When one input is a column vector (single channel) and the other is a matrix (multiple channels), the single-channel input is independently cross-correlated with each channel of the multichannel input. Each column of the input represents a separate channel. For example, when u is a Mu-by-1 column vector and v is an Mv-by-N matrix, the output is an (Mu+Mv–1)-by-N matrix whose jth column has elements
The Correlation block supports sample-based N-D array input. The cross-correlation for sample-based N-D inputs is always computed across the first dimension. If both inputs are N-D arrays, the size of their first dimensions can differ, but the size of all other dimensions must be equal. For example, when u is an Mu-by-N-by-P array and v is an Mv-by-N-by-P array, the output, y, is a sample-based (Mu+Mv–1)-by-N-by-P array.
When one input is an N-D sample-based array and the other is a vector, the vector is independently cross-correlated with each column of the N-D input. For example, when u is a Mu-by-1 column vector and v is an Mv-by-N-by-P array, the output is an (Mu+Mv-1)-by-N-by-P array.
The Correlation block also accepts two vector inputs. When u and v are sample-based column vectors with lengths Mu and Mv, the Correlation block performs the vector cross-correlation according to the following equation:
The dimensions of the sample-based output vector are determined by the dimensions of the input vectors:
When both inputs are column vectors, or when one input is a column vector and the other is a 1-D vector, the output is a (Mu+Mv–1)-by-1 column vector.
When both inputs are row vectors, or when one input is a row vector and the other is a 1-D vector, the output is a 1-by-(Mu+Mv–1) row vector.
When both inputs are 1-D vectors, the output is a 1-D vector of length Mu+Mv–1.
The following diagram shows the data types used within the Correlation block for fixed-point signals (time domain only).
You can set the product output, accumulator, and output data types in the block dialog as discussed in the next section.
The output of the multiplier is in the product output data type when the input is real. When the input is complex, the result of the multiplication is in the accumulator data type. For details on the complex multiplication performed, see Multiplication Data Types.
The Main pane of the Correlation block dialog appears as follows.
Set the domain in which the block computes correlations:
Time — The block computes in the time domain, which minimizes memory use.
Frequency — The block computes in the frequency domain, which might require fewer computations than computing in the time domain, depending on the input length.
Fastest — The block computes in the domain, which minimizes the number of computations.
The Data type attributes pane of the Correlation block dialog appears as follows.
Note Fixed-point signals are only supported for the time domain. To use the parameters on this pane, make sure Time is selected for the Computation domain parameter on the Main pane. |
Select the rounding mode for fixed-point operations.
Select the overflow mode for fixed-point operations.
Specify the product output data type. See Fixed-Point Data Types and Multiplication Data Types for illustrations depicting the use of the product output data type in this block. You can set it to:
A rule that inherits a data type, for example, Inherit: Inherit via internal rule
An expression that evaluates to a valid data type, for example, fixdt([],16,0)
Click the Show data type assistant button
to display the Data
Type Assistant, which helps you set the Product
output data type parameter.
See Using the Data Type Assistant for more information.
Specify the accumulator data type. See Fixed-Point Data Types for illustrations depicting the use of the accumulator data type in this block. You can set this parameter to:
A rule that inherits a data type, for example, Inherit: Inherit via internal rule
An expression that evaluates to a valid data type, for example, fixdt([],16,0)
Click the Show data type assistant button
to display the Data
Type Assistant, which helps you set the Accumulator
data type parameter.
See Using the Data Type Assistant for more information.
Specify the output data type. See Fixed-Point Data Types for illustrations depicting the use of the output data type in this block. You can set it to:
A rule that inherits a data type, for example, Inherit: Same as accumulator
An expression that evaluates to a valid data type, for example, fixdt([],16,0)
Click the Show data type assistant button
to display the Data
Type Assistant, which helps you set the Output
data type parameter.
See Specifying Block Output Data Types for more information.
Specify the minimum value that the block should output. The default value, [], is equivalent to -Inf. Simulink software uses this value to perform:
Simulation range checking (see Checking Signal Ranges)
Automatic scaling of fixed-point data types
Specify the maximum value that the block should output. The default value, [], is equivalent to Inf. Simulink software uses this value to perform:
Simulation range checking (see Checking Signal Ranges)
Automatic scaling of fixed-point data types
Select this parameter to prevent any fixed-point scaling you specify in this block mask from being overridden by the autoscaling tool in the Fixed-Point Tool.
| Port | Supported Data Types |
|---|---|
Input |
|
Output |
|
| Autocorrelation | Signal Processing Blockset |
| Convolution | Signal Processing Blockset |
| xcorr | Signal Processing Toolbox |
 | Convolution | Counter |  |
Learn more about Simulink through this collection of videos, articles, technical literature and the Getting Started with Simulink Guide.
| © 1984-2009- The MathWorks, Inc. - Site Help - Patents - Trademarks - Privacy Policy - Preventing Piracy - RSS |
