Skip to content
Bingham Statistics Library (BSL)
Branch: master
Clone or download
Jared Glover
Latest commit 15f764a Dec 22, 2016
Type Name Latest commit message Commit time
Failed to load latest commit information.
matlab install the matlab folder in /usr/lib/bingham/matlab Mar 10, 2016
.gitignore add .gitignore Nov 4, 2015
LICENSE added statement about old google code repo Jun 10, 2015
TODO No commit message Apr 12, 2012

Bingham Statistics Library (BSL)

The Bingham statistics library contains implementations of the Bingham distribution for directional (axial) statistics on the unit spheres S1, S2, and S3. In addition, finite element approximations are available via tessellations of S2 and S3.

This repository was exported from the original and now to be abandoned SVN repository on google code with consent of the original author Jared Glover.


[2013-12-14] Created libbingham Tutorials

  • See the Tutorials section below for Matlab and C tutorials.

[2013-05-20] Released libbingham v0.3

  • Added matlab functions bingham_fit() and bingham_fit_scatter().
  • Added several utility functions.

[2012-04-18] Released libbingham v0.2.1

  • Fixed a bug in bingham_mult() caused by eigen_symm() returning eigenvalues in the wrong order (compared to the GSL version).
  • Also added more matlab functions.

[2012-04-12] Released libbingham v0.2

  • Enlarged Bingham lookup tables to handle concentration params up to -900.
  • More MATLAB support.
  • Removed dependency on GSL.
  • Switched from GPL to BSD license.


See the wiki for more information.

Quick Usage / Installation

The preferred method for download is checking out the latest code in this repository.

The library contains both C and Matlab code, but only the C code is currently supported. (The Matlab functions are mostly used for plotting figures, and do not contain a complete implementation of the Bingham distribution. Use with caution!)

In the folder bingham/c, run:

make install

This will install the C library, libbingham.a, on your machine. To use the library in your own project, simply add "-lbingham" to your linker flags and include the appropriate headers as you would with any other C library.

Documentation is still sparse, but there are many examples in the bingham/c directory in test_bingham.c, test_util.c, fit_bingham.c, bingham_lookup.c, bingham_sample.c, and cluster_bingham.c.

You can’t perform that action at this time.