shape.fd.outliers {ddalpha} | R Documentation

## Functional Depth-Based Shape Outlier Detection

### Description

Detects functional outliers of first three orders, based on the order extended integrated depth for functional data.

### Usage

    shape.fd.outliers(dataf, range = NULL, d = 101, q = 0.05,
      method = c("halfspace", "simplicial"), approx = 100, print = FALSE,
      plotpairs = FALSE, max.order = 3, exclude.out = TRUE,
      output = c("matrix", "list"), identifiers = NULL)

### Arguments

`dataf` | Functional dataset, represented by a `dataf` object of their arguments and functional values. `n` stands for the number of functions.
`range` | The common range of the domain where the fucntions `dataf` are observed. Vector of length 2 with the left and the right end of the interval. Must contain all arguments given in `dataf`.
`d` | Grid size to which all the functional data are transformed. For depth computation, all functional observations are first transformed into vectors of their functional values of length `d` corresponding to equi-spaced points in the domain given by the interval `range`. Functional values in these points are reconstructed using linear interpolation, and extrapolation.
`q` | The quantile presenting a threshold for the first order outlier detection. Functions with first order integrated depth smaller than the `q` quantile of this sample of depths are flagged as potential outliers. If set to `NULL`, the the outliers are detected from the first order integrated depth after the log-transformation, as for higher order outliers.
`method` | The depth that is used in the diagnostic plot. possible values are `halfspace` for the halfspace depth, or `simplicial` for the simplicial depth.

`approx`

For the computation of the third order integrated depth, the number of approximations used in the computation of the order extended depth. By default this is set to `100`, meaning that `100` trivariate points are randomly sampled in unit cube, and at these points the trivariate depths of the corresponding functional values. May be set to `0` to compute the depth at all possible `d^3` combinations of the points in the domain. This choice may result in very slow computation, see also `depthf.fd1`.

`print` | If the rows of `X` are named, `print=TRUE` enables a graphical output when the names of the outlying curves are displayed.
`plotpairs` | If set to `TRUE`, the scatter plot of the computed depths for orders `1`, `2` and `3` is is displayed. Here, the depths corresponding to the flagged outliers are plotted in colour.
`max.order` | Maximal order of shape outlyingness to be computed, can be set to `1`, `2`, or `3`.
`exclude.out` | Logical variable; exclude the detected lower order outliers in the flagging process? By default `TRUE`.
`output` | Output method, can be set to `matrix` for a matrix with logical entries (`TRUE` for outliers), or `list` for a list of outliers.
`identifiers` | A vector of names for the data observations. Facilitates identification of outlying functions.

### Details

Using the procedure described in Nagy et al. (2016), the function uses the order extended integrated depths for functions, see `depthf.fd1` and `shape.fd.analysis`, to perform informal functional shape outlier detection. Outliers of the first order (horizontal shift outliers) are found as the functions with `q` % of smallest (first order) integrated depth values. Second and third order outliers (shape outliers) are found using the extension of the boxplot method for depths as described in the paper Nagy et al. (2016).

### Value

A matrix of logical values of size `n*4`, where `n` is the sample size. In the first three rows indicators of outlyingness of the corresponding functions for orders `1`, `2` and `3` are given, in the fourth row the indicator of outlyingness with respect to the comparison of the first, and third order depths is given. That is, the fist row corresponds to the first order outliers, the second row to the second order outliers, and the last two rows formally to the third order outliers. Please consult Nagy et al. (2016) to interpret the notion of shape outlyingness.

### Author(s)

Stanislav Nagy, nagy at karlin.mff.cuni.cz

### References

Nagy, S., Gijbels, I. and Hlubinka, D. (2017). Depth-based recognition of shape outlying functions. Journal of Computational and Graphical Statistics. To appear.

### See Also

`depthf.fd1`, `shape.fd.analysis`

### Examples

    n = 30
    dataf = dataf.population()$dataf[1:n]
    shape.fd.outliers(dataf,print=TRUE,plotpairs=TRUE,
    identifiers=unlist(dataf.population()$identifier)[1:n])

[Package ddalpha version 1.3.1 Index]