Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
6.0.0 - English

Change language to:
Français - 日本語 - Português - Русский

Please note that the recommended version of Scilab is 2025.0.0. This page might be outdated.
See the recommended documentation of this function

Scilab Help >> Signal Processing > Correlation Convolution > xcorr

xcorr

Computes discrete auto or cross correlation

Syntax

[c [,lagindex]] = xcorr(x [,maxlags [,scaling]])
[c [,lagindex]] = xcorr(x,y [,maxlags [,scaling]])

Parameters

x

a vector of real or complex floating point numbers.

y

a vector of real or complex floating point numbers. The default value is x.

maxlags

a scalar with integer value greater than 1. The default value is n. Where n is the maximum of the x and y vector length.

scaling

a character string with possible value: "biased", "unbiased", "coeff", "none". The default value is "none".

c

a vector of real or complex floating point numbers with same orientation as x.

lagindex

a row vector, containing the lags index corresponding to the c values.

Description

  • c=xcorr(x) computes the un-normalized discrete auto correlation: and return in c the sequence of auto correlation lags with n is the length of x
  • xcorr(x,y) computes the un-normalized discrete cross correlation: and return in c the sequence of auto correlation lags with n is the maximum of x and y length's.

If the maxlags argument is given xcorr returns in c the sequence of auto correlation lags . If maxlags is greater than length(x), the first and last values of c are zero.

The scaling argument describes how is normalized before being returned in c:

  • "biased":c=/n.
  • "unbiased":c=./(n-(-maxlags:maxlags)).
  • "coeff":c=/(norm(x)*norm(y)).

Remark

The corr function computes the "biased" covariance of x and y and only return in c the sequence of auto correlation lags .

Method

This function computes using ifft(fft(x).*conj(fft(y))).

Examples

t = linspace(0, 100, 2000);
                y = 0.8 * sin(t) + 0.8 * sin(2 * t);
                [c, ind] = xcorr(y, "biased");
                plot(ind, c)

See also

Authors

  • Serge Steer, INRIA

Used Functions

fft

History

VersionDescription
5.4.0 xcorr added.
Report an issue
<< hank Correlation Convolution Filters >>

Copyright (c) 2022-2024 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Tue Feb 14 15:02:46 CET 2017