Skip to main content

Visualization toolbox for income distribution

Project description

License: MIT Python Versions PyPI Version Downloads

Paper | Step-by-step Notebook | Documentation | PyPI package |External Resources

Are you a policy-maker who wants to see the dynamics of national income inequality? Are you a researcher who wants to visualize economic growth puzzles such as convergence? Or are you simply a curious individual who wants to see your position in the national income distribution? Wonder no more because we present incomevis, a library for income visualization (and more)!

Comparing incomes is complicated. We offer three default deflators (consumer price index, household size, and regional price parities) to adjust nominal household income. The income adjustment process is automatically handled for you. You can further adjust our deflated incomes if you have additional variables that you want to incorporate. Also, if you like interactive visualization, our graph can be displayed using JavaScript's amChart library. If you prefer an animated visualization, we offer a dynamically controlled animation of our graph based on Python Matplotlib library.

Happy visualizing economic complexity!


incomevis can be installed via pip:

$ pip install incomevis


Interactive graph (top) and dynamic graph (bottom) is implement in JavaScript AmChart and Python Matplotlib, respectively. More instant examples of interactive graphs can be found at Animated graphs with better control can be generated in a (preferably local) Python environment (for example, see this notebook).

4 levels of deflating income.

Bellow are bootstrap resampling of 50p of DC in 1977 10000 times (bottom right) and 1 million times (bottom left). We also show the relative growth of CA and DC overtime.

A completed and separated page for gallery will be available soon!


Any question, feedback, or comment can be directed to or

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

incomevis-1.0.tar.gz (8.8 kB view hashes)

Uploaded source

Built Distribution

incomevis-1.0-py3-none-any.whl (9.3 kB view hashes)

Uploaded py3

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