simulation_model8: Convenience function for generating functional data

Description

This model generates pure shape outliers that are periodic. The main model is of the form: $$X_i(t) = k\sin(r\pi t) + e_i(t),$$ with contamination model of the form: $$X_i(t) = k\sin(r\pi t + v) + e_i(t),$$ where $t\in [0,1]$, and $e_i(t)$ is a Gaussian processes with zero mean and covariance function of the form: $$\gamma(s,t) = \alpha\exp{-\beta|t-s|^\nu}$$ and $k, r, v$ are constants. Please see the simulation models vignette with vignette("simulation_models", package = "fdaoutlier") for more details.

Usage

simulation_model8(
  n = 100,
  p = 50,
  outlier_rate = 0.05,
  pi_coeff = 15,
  sin_coeff = 2,
  constant = 2,
  cov_alpha = 1,
  cov_beta = 1,
  cov_nu = 1,
  deterministic = TRUE,
  seed = NULL,
  plot = F,
  plot_title = "Simulation Model 8",
  title_cex = 1.5,
  show_legend = T,
  ylabel = "",
  xlabel = "gridpoints"
)

Value

A list containing:

data: a matrix of size n by p containing the simulated data set
true_outliers: a vector of integers indicating the row index of the outliers in the generated data.

Arguments

n: The number of curves to generate. Set to $100$ by default.
p: The number of evaluation points of the curves. Curves are usually generated over the interval $[0, 1]$. Set to $50$ by default.
outlier_rate: A value between $[0, 1]$ indicating the percentage of outliers. A value of $0.06$ indicates about $6\%$ of the observations will be outliers depending on whether the parameter deterministic is TRUE or not. Set to $0.05$ by default.
pi_coeff: The coefficient $r$ in the main and contamination model. Set to $15$ by default.
sin_coeff: The coefficient $k$ in the main and contamination model. Set to $2$ by default.
constant: The value of the constant $v$ in the contamination model. Set to $2$ by default.
cov_alpha: A value indicating the coefficient of the exponential function of the covariance matrix, i.e., the $\alpha$ in the covariance function. Set to $1$ by default.
cov_beta: A value indicating the coefficient of the terms inside the exponential function of the covariance matrix, i.e., the $\beta$ in the covariance function. Set to $1$ by default.
cov_nu: A value indicating the power to which to raise the terms inside the exponential function of the covariance matrix, i.e., the $\nu$ in the covariance function. Set to $1$ by default.
deterministic: A logical value. If TRUE, the function will always return round(n*outlier_rate) outliers and consequently the number of outliers is always constant. If FALSE, the number of outliers are determined using n Bernoulli trials with probability outlier_rate, and consequently the number of outliers returned is random. TRUE by default.
seed: A seed to set for reproducibility. NULL by default in which case a seed is not set.
plot: A logical value indicating whether to plot data.
plot_title: Title of plot if plot is TRUE
title_cex: Numerical value indicating the size of the plot title relative to the device default. Set to 1.5 by default. Ignored if plot = FALSE.
show_legend: A logical indicating whether to add legend to plot if plot = TRUE.
ylabel: The label of the y-axis. Set to "" by default.
xlabel: The label of the x-axis if plot = TRUE. Set to "gridpoints" by default.

Examples

Run this code

dt <- simulation_model8(plot = TRUE)
dim(dt$data)
dt$true_outliers

Run the code above in your browser using DataLab