/HDR-Boxplot

Functional highest density region boxplot

Primary LanguagePythonMIT LicenseMIT

https://circleci.com/gh/tupui/HDR-Boxplot.svg?style=svg

HDR-Boxplot

What is it?

This project implements the Functional highest density region boxplot technique [Hyndman2009]. When you have functional data, which is to say: a curve, you will want to answer some questions such as:

  • What is the median curve?
  • Can I draw a confidence interval?
  • Or, is there any outliers?

This module allows you to do exactly this:

data = np.loadtxt('data/elnino.dat')
print('Data shape: ', data.shape)

hdr_boxplot(data)

The output is the following figure:

data/hdr-boxplot.png

How does it work?

Behind the scene, the dataset is represented as a matrix. Each line corresponding to a 1D curve. This matrix is then decomposed using Principal Components Analysis (PCA). This allows to represent the data using a finit number of modes, or components. This compression process allows to turn the functional representation into a scalar representation of the matrix. In other words, you can visualize each curve from its components. This is called a bivariate plot:

data/bivariate_pca_scatter.png

This visualization exhibit a cluster of points. It indicate that a lot of curve lead to a common components. The center of the cluster is the mediane curve. An the more you get away from the cluster, the more the curve is unlikely to be similar to the other curves.

Using a kernel smoothing technique, the probability density function (PDF) of the 2D space can be recover. From this PDF, it is possible to compute the density probability linked to the cluster and plot its contours.

data/bivariate_pca.png

Finally, using these contours, the different quantiles are extracted allong with the mediane curve and the outliers.

Requirements

The dependencies are:

Acknowledgement

I am gratefull to the help and support on OpenTURNS Michaël Baudin has provided.

References

[Hyndman2009]Rob J Hyndman and Han Lin Shang. Rainb ow plots , bagplots and b oxplots for functional data. Journal of Computational and Graphical Statistics, 19:29-45, 2009