Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/klieret/sunburst
Draw sunburst charts/hierarchical pie plots ("multi-level" pie plots of hierarchical data as e.g., in disk usage diagrams)
https://github.com/klieret/sunburst
chart hierarchical-data pie-chart plot plotting pyplot python visualization
Last synced: about 3 hours ago
JSON representation
Draw sunburst charts/hierarchical pie plots ("multi-level" pie plots of hierarchical data as e.g., in disk usage diagrams)
- Host: GitHub
- URL: https://github.com/klieret/sunburst
- Owner: klieret
- License: bsd-3-clause
- Created: 2016-10-30T18:37:36.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-07-02T01:31:50.000Z (3 months ago)
- Last Synced: 2024-09-08T13:42:46.738Z (25 days ago)
- Topics: chart, hierarchical-data, pie-chart, plot, plotting, pyplot, python, visualization
- Language: Python
- Homepage: https://sunburst.rtfd.io
- Size: 228 KB
- Stars: 13
- Watchers: 2
- Forks: 2
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Sunburst Charts
[](https://github.com/klieret/sunburst/actions)
[](https://results.pre-commit.ci/latest/github/klieret/sunburst/master)
[](http://sunburst.readthedocs.io/en/latest/)
[](https://pypi.org/project/sunburst/)
[](https://git-scm.com/book/en/v2/GitHub-Contributing-to-a-Project)
[](https://github.com/python/black)
[](https://github.com/klieret/sunburst/blob/master/LICENSE.txt)
🔖 **Check out the [full documentation](https://sunburst.readthedocs.io/en/latest/)!**
🚧 **This is an older project that is currently being brushed up** 🚧
## Introduction
`sunburst` creates "sunburst charts" (also called "Ring Charts", "Hierarchical Pie Chargs" or "Multilevel Pie Charts") together with the `matplotlib` package.
Quoting [Wikipedia](https://en.wikipedia.org/wiki/Pie_chart#Ring_chart_.2F_Sunburst_chart_.2F_Multilevel_pie_chart):
> A ring chart, also known as a sunburst chart or a multilevel pie
> chart, is used to visualize hierarchical data, depicted by concentric circles. The circle in the centre represents the root node, with the
> hierarchy moving outward from the center. A segment of the inner
> circle bears a hierarchical relationship to those segments of the
> outer circle which lie within the angular sweep of the parent segment.
A prominent example are disk usage charts (see
`examples/disk_usage_plot.py` for this example):
## ✨ Features
`sunburst` tries to be
- Intuitive & Easy to use: After setting up your data and
`matplotlib`, not more than two lines are necessary to generate
first plots ([minimal
example](https://github.com/klieret/sunburst/blob/master/examples/minimal_example_sunburst.py)).
- Flexible & Robust: Wherever it makes sense, the methods of the
`SunburstPlot` class are intended to be overwritten. Methods that
are responsible for spacing, coloring, styling etc. of the `wedges`
take the corresponding data point (`path`) as an argument, allowing to set most properties independently for each `wedge`.
More specifically:
- Clever positioning of labels, which - depending on space constraints are positioned in a tangentially or radially.
- An easy way to "explode" the plot by redefining
`sunburst.wedge_spacing`
([example](https://github.com/klieret/sunburst/blob/master/examples/minimal_example_exploded.py),
[example](https://github.com/klieret/sunburst/blob/master/examples/disk_usage_exploded.py)).
## 📦 Installation
To install, run
```bash
pip3 install sunburst
```
## 🚧 Migration notice
For more information about recent changes, see the [changelog](https://sunburst.readthedocs.io/en/latest/changelog.html).
* The 2.0 version will have a different API without the `Path` class
* Before the first release to pypi, this package was called `hpie`.
* There have since bean many non-backwards compatible changes to the API: Most importantly, the `HPie` class is now `SunburstPlot` and the package is called `sunburst`
* To get the old version back, check out the `old-hpie` branch. It will however not be maintained any longer.
## 🔥 Minimal example
You can find several examples at `examples/`. The most basic example is
`minimal_example_sunburst.py`:
```python
import matplotlib.pyplot as plt
from sunburst import SunburstPlot, stringvalues_to_pv
# set up some data
data = stringvalues_to_pv({
'ipsum': 40.45,
'ipsum/eirmod': 29.34,
'ipsum/eirmod/dolor': 94.4,
'lorem': 36.12,
'lorem/sadipscing/dolor': 44.32,
'lorem/sadipscing/lorem': 37.15,
'lorem/sadipscing/nonumy': 23.98,
'lorem/eirmod': 11.12,
'lorem/eirmod/lorem': 45.65,
'lorem/sadipscing': 79.67,
})
fig, ax = plt.subplots()
sbp = SunburstPlot(data, ax)
sbp.plot(setup_axes=True)
ax.set_title('Example SunburstPlot')
plt.show()
```
Running this script with `python3 minimal_example_sunburst.py` will
produce the following plot:
## The Data
Note that the value corresponding to path is always the value
*excluding* the values of the children of the path. Therefore plotting
the `SunburstPlot` object computes a "completed" version of the
"pathvalue dictionary". You can check this with the
`SunburstPlot._completed_pv` instance variable which gets initialized
after calling `SunburstPlot.plot(*args)`. Running our minimal example
prints the following:
```python
sbp._completed_pv.items() = {
Path((, )): 442.2, # = the total sum of all items =
# = 36.12 + 44.32 + 37.15 + 23.98 + ...
Path(('ipsum', )): 164.19000000000003, # = sum of "ipsum" and all of its children =
# = 40.45 + 29.34 + 94.4
Path(('ipsum', 'eirmod', )): 123.74000000000001, # = sum of ipsum/eirmod and all of its children =
# = 29.34 + 94.4
Path(('ipsum', 'eirmod', 'dolor', )): 94.4,
Path(('lorem', )): 278.01,
Path(('lorem', 'eirmod', )): 56.769999999999996,
Path(('lorem', 'eirmod', 'lorem', )): 45.65,
Path(('lorem', 'sadipscing', )): 185.12,
Path(('lorem', 'sadipscing', 'dolor', )): 44.32,
Path(('lorem', 'sadipscing', 'lorem', )): 37.15,
Path(('lorem', 'sadipscing', 'nonumy', )): 23.98,
}
```
`sunburst/tests/test_calc.py` contains an explicit test of this
calculation based on a similar example.
## Ring Charts
Thus you get ring charts, if and only if all of the non-zero values
correspond to paths with the same length. E.g. if we change the above data as follows (by lengthening the paths with question marks and
removing the entry for the empty path):
```python
data = stringvalues_to_pv({
'ipsum/?/?': 40.45,
'ipsum/eirmod/?': 29.34,
'ipsum/eirmod/dolor': 94.4,
'lorem/?/?': 36.12,
'lorem/sadipscing/dolor': 44.32,
'lorem/sadipscing/lorem': 37.15,
'lorem/sadipscing/nonumy': 23.98,
'lorem/eirmod/?': 11.12,
'lorem/eirmod/lorem': 45.65,
'lorem/sadipscing/?': 79.67,
})
```
we should get a classical ring chart. This is
`minimal_example_rings.py`. Running it via
`python3 minimal_example_rings.py` yields the following plot, which
indeed just fills up the white space of the above plot with wedges
labeled `?`.
## License
This project is licensed under the *BSD 3-Clause License*, see
`LICENSE.txt`.