Description Usage Arguments Details Value

View source: R/change_distributions.R

This function is used to specify a change distribution to be used in
conjuction with the function `tpca`

. All components of the distribution
(marginal and conditional distributions) are uniform, but the
probability/importance of each type of change can be specified, along with
the range of sparsity of the change, as well as ranges for the sizes and
directions of the different change types. In each simulation run, after a
change sparsity has been drawn, which dimensions that are affected by a
change is always randomized. Choices for the distribution should reflect
prior knowledge about which changes that are of interest to detect.

1 2 3 |

`data_dim` |
An integer specifying the dimension of the data. |

`prob` |
A numeric vector of length 3 specifying the probability of a change in the mean, variance or correlation, respectively. |

`sparsities` |
An integer vector containing values between 2 (minimum sparsity for changes in the correlation) and data_dim. |

`mean_int` |
A vector of length 2 specifying the lower and upper bound of the interval that changes in the mean components are drawn uniformly from. |

`sd_int` |
A vector of length 2 specifying the lower and upper bound
of the interval that multiplicative changes in the standard deviations
are drawn from. Must be between |

`sd_inc_prob` |
A numeric between 0 and 1 indicating the probability of a change in the standard deviation being an increase. |

`cor_int` |
A vector of length 2 specifying the lower and upper bound of the interval that multiplicative changes in the correlations are drawn from. Only values between 0 and 1 are allowed, i.e. a jump towards 0 of the correlation coefficients. |

`change_equal` |
A logical for whether all affected dimensions should
change by the same amount, or by amounts independent of eachother.
For example, if TRUE and the mean changes, |

See references.

`set_uniform_cd`

returns an S3 object of class "change_distr".
This is a list containing the following functions:

`draw_types(n_sim)`

A function that draws

`n_sim`

change types among ('mean', 'sd', 'cor') with probabilities`prob`

.`draw_sparsities(n_sim)`

A function that draws

`n_sim`

change sparsities uniformly from`sparsities`

.`draw_dims(k)`

A function that uniformly draws a size k subset of affected dimensions.

`draw_mean(k)`

A function that draws k values uniformly from

`mean_int`

.`draw_sd(k)`

A function that draws an increase in the standard deviation uniformly from [0,

`sd_int[2]`

] with probability`sd_inc_prob`

, and a decrease in standard deviation uniformly from [`sd_int[1]`

, 1] with probability 1 -`sd_inc_prob`

.`draw_cor(k)`

A function that draws k values uniformly from

`cor_int`

The functions with argument `n_sim`

are called with the number of
simulations as arguments, while the ones with argument `k`

are called
in each simulation run with a number depending on the change sparsity.

Tveten/tpca documentation built on June 10, 2021, 8:43 p.m.

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.