Description

The Complex Multivariate Gaussian Distribution.

Description

Various utilities for the complex multivariate Gaussian distribution and complex Gaussian processes.

README.md

The complex multivariate Gaussian distribution in R

Overview

# install.packages("mvp")  # uncomment this to install the package
library("cmvnorm")

Consider the (zero mean) multivariate Gaussian distribution

$f\left({\mathbf x};\Sigma\right) =\frac{\exp\left(-\frac{1}{2}{\mathbf x}^T\Sigma^{-1}{\mathbf x}\right)}{\sqrt{\left|2\pi\Sigma\right|}}\qquad{\mathbf x}\in{\mathbb R}^n$

where $\Sigma$ is an $n\times n$ positive-definite variance matrix. Now compare the complex version with $\Gamma$ Hermitian positive-definite:

$f\left({\mathbf z};\Gamma\right) =\frac{\exp\left( -{\mathbf z}^\dag\Gamma^{-1}{\mathbf z}\right)}{\left|\pi\Gamma\right|}\qquad{\mathbf z}\in\mathbb{C}^n$

See how much nicer the complex version is! No awkward, unsightly factors of two and no inconvenient square roots. This is essentially due to Gauss’s integral operating more cleanly over the complex plane than the real line:

${\int_\mathbb{C}e^{-z^\dag z}\,dz=\iint_{(x,y)\in\mathbb{R}^2}\!\!\!\!\!\!\!\!\!\!\!\!\!\!e^{-(x^2+y^2)}\,dx\,dy=\int_{\theta=0}^{2\pi}\int_{r=0}^\infty e^{-r^2}r\,dr\,d\theta=2\pi\int_{r=0}^\infty e^{-r^2}r\,dr=\pi.}$

It can be shown that ${\mathbb E}({\mathbf z}{\mathbf z}^\dag)=\Gamma$ , so $\Gamma$ really is the variance of the distribution. We can also introduce a nonzero mean, ${\mathbf m}\in{\mathbb C}^n$ in the natural way.

The cmvnorm package furnishes some R functionality for dealing with the complex multivariate Gaussian distribution.

The package in use

The simplest case would be the univariate standard normal distribution, that is is a complex random variable $z$ with PDF $\exp(z^*z)/\pi$ . Random samples are given by rcnorm():

rcnorm(10)
#>  [1]  0.6181509+0.0783307i -0.2617821-1.1716151i  0.4188516+0.9129822i
#>  [4] -0.0499387-0.6009572i  0.4166873-0.2954984i  0.1986088-0.5429393i
#>  [7]  0.5185832+0.6300364i  0.7295693-0.3090116i -1.4870623+0.7090736i
#> [10] -0.0452294-0.1559835i

Observations are circularly symmetric in the sense that $z$ has the same distribution as $e^{i\theta}z$ for any $\theta\in{\mathbb R}$ , as we may verify visually:

par(pty="s")
plot(rcnorm(10000),asp=1,xlim=c(-3,3),ylim=c(-3,3),pch=16,cex=0.2)

We may sample from this distribution and verify that it has zero mean and unit variance:

z <- rcnorm(1e6)
mean(z)   # zero, subject to sample error
#> [1] -9.71348e-05+6.269418e-04i
var(z)    # one, subject to sample error
#> [1] 1.000525

Note that the real and imaginary components of $z$ have variance $0.5$ :

z <- rcnorm(1e6)

var(Re(z))
#> [1] 0.4991952
var(Im(z))
#> [1] 0.4999403

We may sample from the multivariate case similarly. Suppose ${\mathbf m}=(1,i)^T$ and $\Gamma=\left(\begin{array}{cc}3&i\\-i&2\end{array}\right)$ :

tm <- c(1,1i)  # true mean
tS <- matrix(c(3,1i,-1i,2),2,2)  # true variance
rcmvnorm(10,mean=tm, sigma=tS)
#>                        [,1]                  [,2]
#>  [1,]  3.2217513+1.6826868i -1.1991170+2.5806750i
#>  [2,]  2.2866000-1.0382517i  0.1287602-0.3371253i
#>  [3,]  2.9225545+1.0450105i -2.0117682+1.3707301i
#>  [4,]  2.8709187+1.1591237i  1.3770551+0.1685449i
#>  [5,]  2.6686119+2.0988344i -1.5598805+1.7444876i
#>  [6,] -0.3600905+0.1005174i  0.9452877+0.5510341i
#>  [7,]  1.8070602+1.0582978i  0.2338880+0.2351671i
#>  [8,]  0.5616892-0.4861250i  0.3593575-0.6405177i
#>  [9,]  1.5572701+0.3994906i -1.6689283-0.0957045i
#> [10,] -0.7120009+1.2346053i -0.6296520+1.6596427i

We may perform elementary inference. For the mean, we would calculate the

n <- 1e6  # sample size
z <- rcmvnorm(n,mean=tm, sigma=tS)
colMeans(z)   # should be close to tm=[1,i]
#> [1]  1.000704-0.000501i -0.000205+1.001046i
z <- scale(z,scale=FALSE) # sweep out the mean
cprod(z)/n  # should be close to tS
#>                     [,1]                [,2]
#> [1,]  3.001797+0.000000i -0.002471+1.000779i
#> [2,] -0.002471-1.000779i  1.999561+0.000000i

Further information

For further information, see the package vignette: type

vignette("cmvnorm")

at the R command line.

r-cmvnorm

The complex multivariate Gaussian distribution in R

Overview

The package in use

Further information

Version

License

Status

Source

Homepage

Platforms (75)

The complex multivariate Gaussian distribution in R

Overview

The package in use

Further information

Version

License

Status

Source

Homepage

Platforms75 (75)

Platforms (75)