Skip to main content

Toolbox for testing if a probability distribution fits a power law

Project description

powerlaw: A Python Package for Analysis of Heavy-Tailed Distributions

`powerlaw` is a toolbox using the statistical methods developed in
`Clauset et al. 2007`__ and `Klaus et al. 2011`__ to determine if a
probability distribution fits a power law. Academics, please cite as:

Jeff Alstott, Ed Bullmore, Dietmar Plenz. (2014). powerlaw: a Python package
for analysis of heavy-tailed distributions. `PLoS ONE 9(1): e85777`__

Also available at `arXiv:1305.0215 []`__


Basic Usage
For the simplest, typical use cases, this tells you everything you need to

import powerlaw
data = array([1.7, 3.2 ...]) # data can be list or numpy array
results = powerlaw.Fit(data)
print results.power_law.alpha
print results.power_law.xmin
R, p = results.distribution_compare('power_law', 'lognormal')

For more explanation, understanding, and figures, see the working paper,
which illustrates all of powerlaw's features. For details of the math,
see Clauset et al. 2007, which developed these methods.

Quick Links

`Paper illustrating all of powerlaw's features, with figures`__

`Code examples from manuscript, as an IPython Notebook`__


`Known Issues`__

`Update Notifications, Mailing List, and Contacts`__

This code was developed and tested for Python 2.x with the
`Enthought Python Distribution`__, and later amended to be
compatible with 3.x. The full version of Enthought is
`available for free for academic use`__.


Further Development
`powerlaw` is open for further development. If there's a feature you'd like to see in `powerlaw`, `submit an issue <>`_.
Pull requests and offers for expansion or inclusion in other projects are welcomed and encouraged. The original author of `powerlaw`, Jeff Alstott, is now only writing minor tweaks, so contributions are very helpful.

Many thanks to Andreas Klaus, Mika Rubinov and Shan Yu for helpful
discussions. Thanks also to `Andreas Klaus <>`_,
`Aaron Clauset, Cosma Shalizi <>`_,
and `Adam Ginsburg <>`_ for making
their code available. Their implementations were a critical starting point for
making powerlaw.

Project details

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page