Circular Statistics Toolbox (Directional Statistics)

Compute descriptive and inferential statistics for circular or directional data.
37.3K Downloads
Updated 8 Jun 2012

View License

Editor's Note: This file was selected as MATLAB Central Pick of the Week

CircStat for Matlab
=======================

Toolbox for circular statistics with Matlab.

Authors: Philipp Berens
Email: philipp@bethgelab.org
Homepage: http://philippberens.wordpress.com/code/circstats/

Contributors:
Marc Velasco, Tal Krasovsky

Reference:
P. Berens, CircStat: A Matlab Toolbox for Circular Statistics, Journal of Statistical Software, Volume 31, Issue 10, 2009
http://www.jstatsoft.org/v31/i10

Please cite this paper when the provided code is used (not the technical report!). See licensing terms for details.

Contents:
circ_r Resultant vector length
circ_mean Mean direction of a sample of circular data
circ_axial Mean direction for axial data
circ_median Median direction of a sample of circular data
circ_std Dispersion around the mean direction (std, mardia)
circ_var Circular variance
circ_skewness Circular skewness
circ_kurtosis Circular kurtosis
circ_moment Circular p-th moment
circ_dist Distances around a circle
circ_dist2 Pairwise distances around a circle
circ_confmean Confidence intervals for mean direction
circ_stats Summary statistics

circ_rtest Rayleigh's test for nonuniformity
circ_otest Hodges-Ajne test (omnibus test) for nonuniformity
circ_raotest Rao's spacing test for nonuniformity
circ_vtest V-Test for nonuniformity with known mean direction
circ_medtest Test for median angle
circ_mtest One-sample test for specified mean direction
circ_wwtest Multi-sample test for equal means, one-factor ANOVA
circ_hktest Two-factor ANOVA
circ_ktest Test for equal concentration parameter
circ_symtest Test for symmetry around median angle
circ_kuipertest Test whether two distributions are identical (like KS test)

circ_corrcc Circular-circular correlation coefficient
circ_corrcl Circular-linear correlation coefficient

circ_kappa Compute concentration parameter of a vm distribution

circ_plot Visualization for circular data
circ_clust Simple clustering for circular data
circ_samplecdf Evaluate CDF of a sample of angles

rad2ang Convert radian to angular values
ang2rad Convert angular to radian values

All functions take arguments in radians (expect for ang2rad). For a detailed description of arguments and outputs consult the help text in the files.

Since 2010, most functions for descriptive statistics can be used in Matlab style matrix computations. As a last argument, add the dimension along which you want to average. This changes the behavior slightly from previous relaeses, in that input is not reshaped anymore into vector format. Per default, all computations are performed columnwise (along dimension 1).

References:
- E. Batschelet, Circular Statistics in Biology, Academic Press, 1981
- N.I. Fisher, Statistical analysis of circular data, Cambridge University Press, 1996
- S.R. Jammalamadaka et al., Topics in circular statistics, World Scientific, 2001
- J.H. Zar, Biostatistical Analysis, Prentice Hall, 1999

If you have suggestions, bugs or feature requests or want to contribute code, please email me.

Cite As

Philipp Berens (2024). Circular Statistics Toolbox (Directional Statistics) (https://www.mathworks.com/matlabcentral/fileexchange/10676-circular-statistics-toolbox-directional-statistics), MATLAB Central File Exchange. Retrieved .

MATLAB Release Compatibility
Created with R2012a
Compatible with any release
Platform Compatibility
Windows macOS Linux

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!
Version Published Release Notes
1.21.0.0

Update on median, wwtest, hktest, kuiper. Also added examples from paper.

1.20.0.0

Bugfixes in wwtest, kuiper, median, hktest and added example files from paper.

1.19.0.0

Updates fixing the bugs reported in the last few months.

Touched files:
kuipertest, plot, kurtosis, clust, axialmean, vmrnd, skewness, moment, median

1.18.0.0

Bugfixes and updates

1.17.0.0

Bug in circ_clust fixed.

1.16.0.0

Bugfix in circ_hktest: lines 159 and 163 were switched.

1.15.0.0

Small bugfixes, mainly in the help sections

1.14.0.0

Various bugfixes. Added Matlab-style computations.

1.13.0.0

Bug fix in circ_stats.

1.12.0.0

Bug fix in circ_skewness and circ_kurtosis. Thanks to Shiquan Wang.

1.11.0.0

Bug fix in circ_dist and circ_clust.

1.10.0.0

Bug fix.

1.9.0.0

Two new tests

1.8.0.0

Updated reference for paper

1.7.0.0

Added reference.

Removed some bugs.

Added new, more complicated tests (ANOVA like testing).

1.6.0.0

A number of small bug fixes.

1.5.0.0

Changed licensing