File Exchange

image thumbnail

CircHist - circular / polar / angle histogram

version (1.38 MB) by Frederick Zittrell
Creates circular / polar / angle histograms


Updated 27 Jan 2021

From GitHub

View Version History

View license on GitHub

CircHist creates circular (polar) histograms from angle data, either distribution data or already-binned data. Works with circular and axial (bimodal) data. Circular statistics (average angle, 95 % confidence interval, resultant vector length, Rayleigh test of uniformity and circular-linear correlation) are automatically calculated using the CircStat Toolbox ( and are graphically included. All visual properties can be dynamically adjusted; see @CircHist/html/exampleCircHist.html for usage examples. This function is conceptually similar to MATLAB's ROSE and POLARHISTOGRAM functions, but differs from them in several respects:
- Instead of plotting the histogram bins as wedges, they are plotted as straight bars.
- The histogram bins can have error bars.
- The radius-axis scale is shown as a straight scale next to the plot.
- Circular statistics are automatically computed.
- Arrows with specific direction and length can be overlayed.

Cite As

Frederick Zittrell (2021). CircHist - circular / polar / angle histogram (, GitHub. Retrieved .

Frederick Zittrell (2019). CircHist (, GitHub. Retrieved March 27, 2019.

Comments and Ratings (7)


Zhanchao Li

Frederick Zittrell

Thank you for your reply -- I checked (hopefully) all functions that are called by the code and determined the minimum MATLAB version required: R2017a.
It would be possible to reduce it to R2016a, where POLARAXES was introduced, but this is a fundamental part of the code, so I cannot provide a fix -- sorry for the inconvenience.

requires polaraxes that I don't have

Basil el Jundi

Frederick Zittrell

The function THETATICKFORMAT was introduced in MATLAB R2016b, is it possible that you use an older version than this?
In any case, this function is just a shortcut to change the respective axes-property, so I might just change my code to refer to this property directly, then older MATLAB versions without THETATICKFORMAT will be supported.

Aaron Johnson

There is an error when running this:
Undefined function or variable 'thetatickformat'.

Error in CircHist (line 624)

Error in exampleCircHist (line 9)
obj1 = CircHist(sDist,nBins);

MATLAB Release Compatibility
Created with R2019a
Compatible with R2017a and later releases
Platform Compatibility
Windows macOS Linux

Community Treasure Hunt

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

Start Hunting!