supsmu

supsmu smooths scatterplots using Friedman's supersmoother algorithm.

expand all in page

Syntax

Description

This function implements the supersmoother. This is basically the function supsmu written in MALTAB by Douglas M. Schwarz.

Email: dmschwarz=ieee*org, dmschwarz=urgrad*rochester*edu Real_email = regexprep(Email,{'=','*'},{'@','.'}) See the section "More About" of this file for the details of the modifications that have been made.

example

smo =supsmu(x, y) Example of use of supsmu with all the default options.

example

smo =supsmu(x, y, Name, Value) An example of the use of the option Span.

Examples

expand all

  • Example of use of supsmu with all the default options.

    • x = linspace(0,1,201);
y = sin(2.5*x) + 0.05*randn(1,201);
smo = supsmu(x,y);
plot(x,y,'o',x,smo)

  • An example of the use of the option Span.

    • x = linspace(0,1,201);
y = sin(2.5*x) + 0.05*randn(1,201);
smo = supsmu(x,y,'Span',0.3);
smo1 = supsmu(x,y,'Span',0.5);
smo2 = supsmu(x,y,'Span',0.7);
plot(x,y,'o',x,[smo; smo1; smo2])
legend({'Original data' 'span=0.3' 'span=0.5' 'span=0.7'},'Location','best')
    Click here for the graphical output of this example (link to Ro.S.A. website).

    Input Arguments

    expand all

    x — x values for smoothing. Vector.

    Predictor variable containing the abscissa values specified as a vector of length n, where n is the number of observations.

    Data Types: single| double

    y — y values for smoothing. Vector.

    The response variable, which has to be smoothed, is specified as a vector of length n, where n is the number of observations.

    Data Types: single| double

    Name-Value Pair Arguments

    Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside single quotes (' '). You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

    Example: 'Weights',1:n , 'Span',0.2 , 'Period',1 , 'Alpha',5 , 'Unsorted',5

    Weights —weights for the observations.vector.

    Row or column vector of positive numbers of length n containing the weights associated to each observations. If w is not specified, we assume $w=1$ for $i=1, 2, \ldots, n$.

    Example: 'Weights',1:n

    Data Types: double

    Span —fraction of the observations in the span.scalar.

    This option sets the width of a fixed-width smoothing operation relative to the number of data points, 0 < Span < 1.

    Setting this to be non-zero disables the supersmoother algorithm. Default is 0 (use supersmoother).

    Example: 'Span',0.2

    Data Types: double

    Period —Sets the period of periodic data.scalar.

    The default is Inf (infinity), which implies that the data is not periodic.

    Can also be set to zero for the same effect.

    Example: 'Period',1

    Data Types: double

    Alpha —Sets a small-span penalty to produce a greater smoothing effect.0 < Alpha < 10, where 0 does nothing and 10 produces the maximum effect.

    Default = 0. This parameter controls the smoothness of the fitted curve. Values up to 10 indicate increasing smoothness.

    Example: 'Alpha',5

    Data Types: double

    Unsorted —Sorted or unsorted data.boolean.

    If the data points are not already sorted in order of the x values, then setting this to true will sort them.

    Default is false.

    Example: 'Unsorted',5

    Data Types: true

    Output Arguments

    expand all

    smo —smoothed values. Vector

    A vector with the same dimension of y containing smoothed values, that is the y values on the fitted curve.

    More About

    expand all

    Additional Details

    The supersmoother algorithm computes three separate smooth curves from the input data with symmetric spans of 0.05*n, 0.2*n, and 0.5*n, where n is the number of data points. The best of the three smooth curves is chosen for each predicted point using leave-one-out cross validation. The best spans are then smoothed by a fixed-span smoother (span = 0.2*n), and the prediction is computed by linearly interpolating between the three smooth curves. This final smooth curve is then smoothed again with a fixed-span smoother (span = 0.05*n).

    According to comments by Friedman, "for small samples (n < 40) or if there are substantial serial correlations between observations close in x-value, then a prespecified fixed span smoother (span > 0) should be used. Reasonable span values are 0.2 to 0.4." This function is basically equal to the function supsmu written in MALTAB by Douglas M. Schwarz.

    Email: dmschwarz=ieee*org, dmschwarz=urgrad*rochester*edu Real_email = regexprep(Email,{'=','*'},{'@','.'}) The following modifications with respect to the original function have been made:

    [1] In case of constant values of x over a span program was producing NA. Modifications have been done in the subroutines to cope with this case.

    [2] The formula for the cross validation residuals in presence of constant values has been introduced.

    [3] All the Mlint suggestions have been incorporated.

    [4] The help has been put inside the FSDA style.

    [5] A series of examples that explore the different options have been added.

    References

    Friedman, J. H. (1984). A Variable Span Smoother. Tech. Rep. No. 5, Laboratory for Computational Statistics, Dept. of Statistics, Stanford Univ., California.

    See Also

    | |

    This page has been automatically generated by our routine publishFS