-
Notifications
You must be signed in to change notification settings - Fork 1
/
README.Rmd
58 lines (46 loc) · 3.77 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "README-"
)
```
# tensr, Because tensor was Already Taken <img src="man/figures/logo.png" align="right" height="138" />
<!-- badges: start -->
[](https://github.com/dcgerard/tensr/actions)
[](https://cran.r-project.org/package=tensr)
[](https://cran.r-project.org/package=tensr)
[](http://www.gnu.org/licenses/gpl-3.0)
<!-- badges: end -->
# Description
This package contains a collection of functions for statistical analysis with tensor(array)-variate data sets. In particular, `tensr` has the following features:
* Basic functions for handling arrays, such as vectorization, matrix unfolding, and multilinear multiplication.
* Functions for calculating (Tucker) tensor decompositions, such as the incredible higher-order LQ decomposition (incredible HOLQ), the incredible singular value decomposition (ISVD), the incredible higher-order polar decomposition (IHOP), the higher-order singular value decomposition (HOSVD), and the low multilinear rank approximation using the higher-order orthogonal iteration (HOOI).
* Perform likelihood inference in mean-zero Kronecker structured covariance models, such as
+ Derive the maximum likelihood estimates of the covariance matrices under the array normal model,
+ Run a likelihood ratio test in separable covariance models, and
+ Calculate AIC's and BIC's for separable covariance models.
* Run a Gibbs sampler to draw from the posterior distribution of the Kronecker structured covariance matrix in the array normal model. This posterior is with respect to a (non-informative) prior induced by the right Haar measure over a product group of lower triangular matrices acting on the space of Kronecker structured covariance matrices. For any invariant loss function, any Bayes rule with respect to this prior will be the uniformly minimum risk equivariant estimator (UMREE) with respect to that loss.
* Calculate the UMREE under a multiway generalization of Stein's loss. This estimator dominates the maximum likelihood estimator uniformly over the entire parameter space of Kronecker structured covariance matrices.
* Calculate a (randomized) orthogonally invariant estimator of the Kronecker structured covariance matrix. This estimator dominates the UMREE under the product group of lower triangular matrices.
This package is also published on [CRAN](https://cran.r-project.org/package=tensr).
Vignettes are available on
[Equivariant Inference](https://cran.r-project.org/package=tensr/vignettes/equivariant_estimation.html) and
[Likelihood Inference](https://cran.r-project.org/package=tensr/vignettes/maximum_likelihood.html).
# Installation
To install from CRAN, run in `R`:
```{r, eval = FALSE}
install.packages("tensr")
```
To install the latest version from Github, run in `R`:
```{r, eval = FALSE}
install.packages("devtools")
devtools::install_github("dcgerard/tensr")
```
# References
**Gerard, D.**, & Hoff, P. (2016). A higher-order LQ decomposition for separable covariance models. _Linear Algebra and its Applications_, 505, 57-84. [[Link to LAA]](https://doi.org/10.1016/j.laa.2016.04.033) [[Link to arXiv]](http://arxiv.org/pdf/1410.1094v1.pdf)
**Gerard, D.**, & Hoff, P. (2015). Equivariant minimax dominators of the MLE in the array normal model. _Journal of Multivariate Analysis_, 137, 32-49. [[Link to JMVA]](https://doi.org/10.1016/j.jmva.2015.01.020) [[Link to arXiv]](http://arxiv.org/pdf/1408.0424.pdf)