plotille 4.0.2__tar.gz → 6.0.0__tar.gz

plotille-4.0.2/README.md → plotille-6.0.0/PKG-INFO

@@ -1,17 +1,44 @@
+Metadata-Version: 2.4
+Name: plotille
+Version: 6.0.0
+Summary: Plot in the terminal using braille dots.
+Keywords: plot,scatter,histogram,terminal,braille,unicode,timeseries
+Author: Tammo Ippen
+Author-email: Tammo Ippen <tammo.ippen@posteo.de>
+License-Expression: MIT
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Topic :: Terminals
+Requires-Python: >=3.10, <4
+Project-URL: Homepage, https://github.com/tammoippen/plotille
+Project-URL: Repository, https://github.com/tammoippen/plotille
+Description-Content-Type: text/markdown
+
 ![Hero Plotille](https://github.com/tammoippen/plotille/raw/master/imgs/hero.png)
 
 # Plotille
 
 [![CI](https://github.com/tammoippen/plotille/actions/workflows/CI.yml/badge.svg)](https://github.com/tammoippen/plotille/actions/workflows/CI.yml)
 [![codecov](https://codecov.io/gh/tammoippen/plotille/branch/master/graph/badge.svg?token=OGWI832JNM)](https://codecov.io/gh/tammoippen/plotille)
-[![Language grade: Python](https://img.shields.io/lgtm/grade/python/g/tammoippen/plotille.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/tammoippen/plotille/context:python)
-[![Tested CPython Versions](https://img.shields.io/badge/cpython-2.7%2C%203.6%2C%203.7%2C%203.8%2C%203.9-brightgreen.svg)](https://img.shields.io/badge/cpython-2.7%2C%203.6%2C%203.7%2C%203.8%2C%203.8-brightgreen.svg)
-[![Tested PyPy Versions](https://img.shields.io/badge/pypy-2.7--7.3%2C%203.7--7.3%2C%203.8--7.3-brightgreen.svg)](https://img.shields.io/badge/pypy-2.7--7.3%2C%203.7--7.3%2C%203.8--7.3-brightgreen.svg)
+[![Tested CPython Versions](https://img.shields.io/badge/cpython-3.10%2C%203.11%2C%203.12%2C%203.13%2C%203.14-brightgreen.svg)](https://img.shields.io/badge/cpython-3.10%2C%203.11%2C%203.12%2C%203.13%203.14-brightgreen.svg)
+[![Tested PyPy Versions](https://img.shields.io/badge/3.11-brightgreen.svg)](https://img.shields.io/badge/pypy-3.11-brightgreen.svg)
 [![PyPi version](https://img.shields.io/pypi/v/plotille.svg)](https://pypi.python.org/pypi/plotille)
 [![Downloads](https://pepy.tech/badge/plotille/month)](https://pepy.tech/project/plotille)
 [![PyPi license](https://img.shields.io/pypi/l/plotille.svg)](https://pypi.python.org/pypi/plotille)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
 
-Plot, scatter plots and histograms in the terminal using braille dots, with (almost) no dependancies. Plot with color or make complex figures - similar to a very small sibling to matplotlib. Or use the canvas to plot dots and lines yourself.
+Plots, scatter plots, histograms and heatmaps in the terminal using braille dots, and foreground and background colors - with no dependencies. Make complex figures using the Figure class or make fast and simple plots using graphing function - similar to a very small sibling to matplotlib. Or use the canvas to plot dots, lines and images yourself.
 
 Install:
 
@@ -26,7 +53,11 @@ Similar to other libraries:
 - like [termgraph](https://github.com/sgeisler/termgraph) (not on pypi), but very different style.
 - like [terminalplot](https://github.com/kressi/terminalplot), but with braille, X/Y-axis, histogram, linear interpolation.
 
-Basic support for timeseries plotting is provided with release 3.2: for any `X` or `Y` values you can also add `datetime.datetime`, `pendulum.datetime` or `numpy.datetime64` values. Labels are generated respecting the difference of `x_limits` and `y_limits`.
+Basic support for timeseries plotting is provided with release 3.2: for any `X` or `Y` values you can also add `datetime.datetime`  or `numpy.datetime64` values. Labels are generated respecting the difference of `x_limits` and `y_limits`.
+
+Support for heatmaps using background colors for figures and displaying images binary with braille, or in color with background colors using the canvas - provided with release 4.0
+
+If you are still using python 2.7, please use plotille v4 or before. With v5 I am dropping support for python 2.7, as the effort to maintain the discontinued version is too much.
 
 ## Documentation
 
@@ -38,7 +69,7 @@ In [3]: X = np.sort(np.random.normal(size=1000))
 
 ### Figure
 
-To construct plots the recomended way is to use a `Figure`:
+To construct plots the recommended way is to use a `Figure`:
 
 ```python
 In [12]: plotille.Figure?
@@ -152,10 +183,10 @@ Parameters:
     X: List[float]         X values.
     Y: List[float]         Y values. X and Y must have the same number of entries.
     width: int             The number of characters for the width (columns) of the canvas.
-    hight: int             The number of characters for the hight (rows) of the canvas.
+    height: int             The number of characters for the height (rows) of the canvas.
     X_label: str           Label for X-axis.
     Y_label: str           Label for Y-axis. max 8 characters.
-    linesep: str           The requested line seperator. default: os.linesep
+    linesep: str           The requested line separator. default: os.linesep
     interp: Optional[str]  Specify interpolation; values None, 'linear'
     x_min, x_max: float    Limits for the displayed X values.
     y_min, y_max: float    Limits for the displayed Y values.
@@ -207,10 +238,10 @@ Parameters:
     X: List[float]       X values.
     Y: List[float]       Y values. X and Y must have the same number of entries.
     width: int           The number of characters for the width (columns) of the canvas.
-    hight: int           The number of characters for the hight (rows) of the canvas.
+    height: int           The number of characters for the height (rows) of the canvas.
     X_label: str         Label for X-axis.
     Y_label: str         Label for Y-axis. max 8 characters.
-    linesep: str         The requested line seperator. default: os.linesep
+    linesep: str         The requested line separator. default: os.linesep
     x_min, x_max: float  Limits for the displayed X values.
     y_min, y_max: float  Limits for the displayed Y values.
     lc: multiple         Give the line color.
@@ -256,7 +287,7 @@ Parameters:
     bins: int            The number of bins to put X entries in (rows).
     width: int           The number of characters for the width (columns).
     log_scale: bool      Scale the histogram with `log` function.
-    linesep: str         The requested line seperator. default: os.linesep
+    linesep: str         The requested line separator. default: os.linesep
     lc: multiple         Give the line color.
     bg: multiple         Give the background color.
     color_mode: str      Specify color input mode; 'names' (default), 'byte' or 'rgb'
@@ -270,6 +301,56 @@ In [9]: print(plotille.hist(np.random.normal(size=10000)))
 
 ![Example hist](https://github.com/tammoippen/plotille/raw/master/imgs/hist.png)
 
+#### Hist (aggregated)
+
+This function allows you to create a histogram when your data is already aggregated (aka you don't have access to raw values, but you have access to bins and counts for each bin).
+
+This comes handy when working with APIs such as [OpenTelemetry Metrics API](https://opentelemetry-python.readthedocs.io/en/latest/api/metrics.html)
+where views such as [ExplicitBucketHistogramAggregation](https://opentelemetry-python.readthedocs.io/en/latest/sdk/metrics.view.html#opentelemetry.sdk.metrics.view.ExplicitBucketHistogramAggregation)
+only expose access to aggregated values (counts for each bin / bucket).
+
+```python
+In [8]: plotille.hist_aggregated?
+Signature:
+plotille.hist_aggregated(
+    counts,
+    bins,
+    width=80,
+    log_scale=False,
+    linesep='\n',
+    lc=None,
+    bg=None,
+    color_mode='names',
+)
+Docstring:
+Create histogram for aggregated data.
+
+Parameters:
+    counts: List[int]    Counts for each bucket.
+    bins: List[float]    Limits for the bins for the provided counts: limits for
+                         bin `i` are `[bins[i], bins[i+1])`.
+                         Hence, `len(bins) == len(counts) + 1`.
+    width: int           The number of characters for the width (columns).
+    log_scale: bool      Scale the histogram with `log` function.
+    linesep: str         The requested line separator. default: os.linesep
+    lc: multiple         Give the line color.
+    bg: multiple         Give the background color.
+    color_mode: str      Specify color input mode; 'names' (default), 'byte' or 'rgb'
+                         see plotille.color.__docs__
+Returns:
+    str: histogram over `X` from left to right.
+
+In [9]: counts = [1945, 0, 0, 0, 0, 0, 10555, 798, 0, 28351, 0]
+In [10]: bins = [float('-inf'), 10, 50, 100, 200, 300, 500, 800, 1000, 2000, 10000, float('+inf')]
+In [11]: print(plotille.hist_aggregated(counts, bins))
+```
+
+Keep in mind that there must always be n+1 bins (n is a total number of count values, 11 in the example above).
+
+In this example the first bin is from [-inf, 10) with a count of 1945 and the last bin is from [10000, +inf] with a count of 0.
+
+![Example hist](https://github.com/tammoippen/plotille/raw/master/imgs/hist_aggregated.png)
+
 #### Histogram
 
 There is also another more 'usual' histogram function available:
@@ -306,7 +387,7 @@ Parameters:
     height: int          The number of characters for the height (rows).
     X_label: str         Label for X-axis.
     Y_label: str         Label for Y-axis. max 8 characters.
-    linesep: str         The requested line seperator. default: os.linesep
+    linesep: str         The requested line separator. default: os.linesep
     x_min, x_max: float  Limits for the displayed X values.
     y_min, y_max: float  Limits for the displayed Y values.
     lc: multiple         Give the line color.
@@ -358,7 +439,7 @@ Initiate a Canvas object
 
 Parameters:
     width: int            The number of characters for the width (columns) of the canvas.
-    hight: int            The number of characters for the hight (rows) of the canvas.
+    height: int            The number of characters for the height (rows) of the canvas.
     xmin, ymin: float     Lower left corner of reference system.
     xmax, ymax: float     Upper right corner of reference system.
     background: multiple  Background color of the canvas.
@@ -506,7 +587,7 @@ Docstring:
 Transform canvas into `print`-able string
 
 Parameters:
-    linesep: str  The requested line seperator. default: os.linesep
+    linesep: str  The requested line separator. default: os.linesep
 
 Returns:
     unicode: The canvas as a string.
@@ -555,3 +636,9 @@ In [29]: print(cvs.plot())
 ## Stargazers over time
 
 [![Stargazers over time](https://starchart.cc/tammoippen/plotille.svg)](https://starchart.cc/tammoippen/plotille)
+
+## Sponsoring the project
+
+If you like the project and want to buy me a coffee, feel free to send some coins ;)
+
+[<img src="https://api.gitsponsors.com/api/badge/img?id=105019800" height="20">](https://api.gitsponsors.com/api/badge/link?p=gkBol1u2+g2pjgZGRaDLy4k0XbPDRXdPWJWnueCUGo/wcSsqyE8nr+n9nvqfeuqXee6JhLARGZS5bP0ZvorS7y6t4INyHLtTrprYh9c+MYkqAZeSqNIf7WL0ZRTI070RVQA3L9QW9IZNFlMbulW+BQ==)

plotille-4.0.2/PKG-INFO → plotille-6.0.0/README.md

@@ -1,47 +1,17 @@
-Metadata-Version: 2.1
-Name: plotille
-Version: 4.0.2
-Summary: Plot in the terminal using braille dots.
-Home-page: https://github.com/tammoippen/plotille
-License: MIT
-Keywords: plot,scatter,histogram,terminal,braille,unicode,timeseries
-Author: Tammo Ippen
-Author-email: tammo.ippen@posteo.de
-Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 2
-Classifier: Programming Language :: Python :: 2.7
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Programming Language :: Python :: Implementation :: PyPy
-Classifier: Topic :: Scientific/Engineering :: Visualization
-Classifier: Topic :: Terminals
-Requires-Dist: six (>=1.16,<2.0)
-Project-URL: Repository, https://github.com/tammoippen/plotille
-Description-Content-Type: text/markdown
-
 ![Hero Plotille](https://github.com/tammoippen/plotille/raw/master/imgs/hero.png)
 
 # Plotille
 
 [![CI](https://github.com/tammoippen/plotille/actions/workflows/CI.yml/badge.svg)](https://github.com/tammoippen/plotille/actions/workflows/CI.yml)
 [![codecov](https://codecov.io/gh/tammoippen/plotille/branch/master/graph/badge.svg?token=OGWI832JNM)](https://codecov.io/gh/tammoippen/plotille)
-[![Language grade: Python](https://img.shields.io/lgtm/grade/python/g/tammoippen/plotille.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/tammoippen/plotille/context:python)
-[![Tested CPython Versions](https://img.shields.io/badge/cpython-2.7%2C%203.6%2C%203.7%2C%203.8%2C%203.9-brightgreen.svg)](https://img.shields.io/badge/cpython-2.7%2C%203.6%2C%203.7%2C%203.8%2C%203.8-brightgreen.svg)
-[![Tested PyPy Versions](https://img.shields.io/badge/pypy-2.7--7.3%2C%203.7--7.3%2C%203.8--7.3-brightgreen.svg)](https://img.shields.io/badge/pypy-2.7--7.3%2C%203.7--7.3%2C%203.8--7.3-brightgreen.svg)
+[![Tested CPython Versions](https://img.shields.io/badge/cpython-3.10%2C%203.11%2C%203.12%2C%203.13%2C%203.14-brightgreen.svg)](https://img.shields.io/badge/cpython-3.10%2C%203.11%2C%203.12%2C%203.13%203.14-brightgreen.svg)
+[![Tested PyPy Versions](https://img.shields.io/badge/3.11-brightgreen.svg)](https://img.shields.io/badge/pypy-3.11-brightgreen.svg)
 [![PyPi version](https://img.shields.io/pypi/v/plotille.svg)](https://pypi.python.org/pypi/plotille)
 [![Downloads](https://pepy.tech/badge/plotille/month)](https://pepy.tech/project/plotille)
 [![PyPi license](https://img.shields.io/pypi/l/plotille.svg)](https://pypi.python.org/pypi/plotille)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
 
-Plot, scatter plots and histograms in the terminal using braille dots, with (almost) no dependancies. Plot with color or make complex figures - similar to a very small sibling to matplotlib. Or use the canvas to plot dots and lines yourself.
+Plots, scatter plots, histograms and heatmaps in the terminal using braille dots, and foreground and background colors - with no dependencies. Make complex figures using the Figure class or make fast and simple plots using graphing function - similar to a very small sibling to matplotlib. Or use the canvas to plot dots, lines and images yourself.
 
 Install:
 
@@ -56,7 +26,11 @@ Similar to other libraries:
 - like [termgraph](https://github.com/sgeisler/termgraph) (not on pypi), but very different style.
 - like [terminalplot](https://github.com/kressi/terminalplot), but with braille, X/Y-axis, histogram, linear interpolation.
 
-Basic support for timeseries plotting is provided with release 3.2: for any `X` or `Y` values you can also add `datetime.datetime`, `pendulum.datetime` or `numpy.datetime64` values. Labels are generated respecting the difference of `x_limits` and `y_limits`.
+Basic support for timeseries plotting is provided with release 3.2: for any `X` or `Y` values you can also add `datetime.datetime`  or `numpy.datetime64` values. Labels are generated respecting the difference of `x_limits` and `y_limits`.
+
+Support for heatmaps using background colors for figures and displaying images binary with braille, or in color with background colors using the canvas - provided with release 4.0
+
+If you are still using python 2.7, please use plotille v4 or before. With v5 I am dropping support for python 2.7, as the effort to maintain the discontinued version is too much.
 
 ## Documentation
 
@@ -68,7 +42,7 @@ In [3]: X = np.sort(np.random.normal(size=1000))
 
 ### Figure
 
-To construct plots the recomended way is to use a `Figure`:
+To construct plots the recommended way is to use a `Figure`:
 
 ```python
 In [12]: plotille.Figure?
@@ -182,10 +156,10 @@ Parameters:
     X: List[float]         X values.
     Y: List[float]         Y values. X and Y must have the same number of entries.
     width: int             The number of characters for the width (columns) of the canvas.
-    hight: int             The number of characters for the hight (rows) of the canvas.
+    height: int             The number of characters for the height (rows) of the canvas.
     X_label: str           Label for X-axis.
     Y_label: str           Label for Y-axis. max 8 characters.
-    linesep: str           The requested line seperator. default: os.linesep
+    linesep: str           The requested line separator. default: os.linesep
     interp: Optional[str]  Specify interpolation; values None, 'linear'
     x_min, x_max: float    Limits for the displayed X values.
     y_min, y_max: float    Limits for the displayed Y values.
@@ -237,10 +211,10 @@ Parameters:
     X: List[float]       X values.
     Y: List[float]       Y values. X and Y must have the same number of entries.
     width: int           The number of characters for the width (columns) of the canvas.
-    hight: int           The number of characters for the hight (rows) of the canvas.
+    height: int           The number of characters for the height (rows) of the canvas.
     X_label: str         Label for X-axis.
     Y_label: str         Label for Y-axis. max 8 characters.
-    linesep: str         The requested line seperator. default: os.linesep
+    linesep: str         The requested line separator. default: os.linesep
     x_min, x_max: float  Limits for the displayed X values.
     y_min, y_max: float  Limits for the displayed Y values.
     lc: multiple         Give the line color.
@@ -286,7 +260,7 @@ Parameters:
     bins: int            The number of bins to put X entries in (rows).
     width: int           The number of characters for the width (columns).
     log_scale: bool      Scale the histogram with `log` function.
-    linesep: str         The requested line seperator. default: os.linesep
+    linesep: str         The requested line separator. default: os.linesep
     lc: multiple         Give the line color.
     bg: multiple         Give the background color.
     color_mode: str      Specify color input mode; 'names' (default), 'byte' or 'rgb'
@@ -300,6 +274,56 @@ In [9]: print(plotille.hist(np.random.normal(size=10000)))
 
 ![Example hist](https://github.com/tammoippen/plotille/raw/master/imgs/hist.png)
 
+#### Hist (aggregated)
+
+This function allows you to create a histogram when your data is already aggregated (aka you don't have access to raw values, but you have access to bins and counts for each bin).
+
+This comes handy when working with APIs such as [OpenTelemetry Metrics API](https://opentelemetry-python.readthedocs.io/en/latest/api/metrics.html)
+where views such as [ExplicitBucketHistogramAggregation](https://opentelemetry-python.readthedocs.io/en/latest/sdk/metrics.view.html#opentelemetry.sdk.metrics.view.ExplicitBucketHistogramAggregation)
+only expose access to aggregated values (counts for each bin / bucket).
+
+```python
+In [8]: plotille.hist_aggregated?
+Signature:
+plotille.hist_aggregated(
+    counts,
+    bins,
+    width=80,
+    log_scale=False,
+    linesep='\n',
+    lc=None,
+    bg=None,
+    color_mode='names',
+)
+Docstring:
+Create histogram for aggregated data.
+
+Parameters:
+    counts: List[int]    Counts for each bucket.
+    bins: List[float]    Limits for the bins for the provided counts: limits for
+                         bin `i` are `[bins[i], bins[i+1])`.
+                         Hence, `len(bins) == len(counts) + 1`.
+    width: int           The number of characters for the width (columns).
+    log_scale: bool      Scale the histogram with `log` function.
+    linesep: str         The requested line separator. default: os.linesep
+    lc: multiple         Give the line color.
+    bg: multiple         Give the background color.
+    color_mode: str      Specify color input mode; 'names' (default), 'byte' or 'rgb'
+                         see plotille.color.__docs__
+Returns:
+    str: histogram over `X` from left to right.
+
+In [9]: counts = [1945, 0, 0, 0, 0, 0, 10555, 798, 0, 28351, 0]
+In [10]: bins = [float('-inf'), 10, 50, 100, 200, 300, 500, 800, 1000, 2000, 10000, float('+inf')]
+In [11]: print(plotille.hist_aggregated(counts, bins))
+```
+
+Keep in mind that there must always be n+1 bins (n is a total number of count values, 11 in the example above).
+
+In this example the first bin is from [-inf, 10) with a count of 1945 and the last bin is from [10000, +inf] with a count of 0.
+
+![Example hist](https://github.com/tammoippen/plotille/raw/master/imgs/hist_aggregated.png)
+
 #### Histogram
 
 There is also another more 'usual' histogram function available:
@@ -336,7 +360,7 @@ Parameters:
     height: int          The number of characters for the height (rows).
     X_label: str         Label for X-axis.
     Y_label: str         Label for Y-axis. max 8 characters.
-    linesep: str         The requested line seperator. default: os.linesep
+    linesep: str         The requested line separator. default: os.linesep
     x_min, x_max: float  Limits for the displayed X values.
     y_min, y_max: float  Limits for the displayed Y values.
     lc: multiple         Give the line color.
@@ -388,7 +412,7 @@ Initiate a Canvas object
 
 Parameters:
     width: int            The number of characters for the width (columns) of the canvas.
-    hight: int            The number of characters for the hight (rows) of the canvas.
+    height: int            The number of characters for the height (rows) of the canvas.
     xmin, ymin: float     Lower left corner of reference system.
     xmax, ymax: float     Upper right corner of reference system.
     background: multiple  Background color of the canvas.
@@ -536,7 +560,7 @@ Docstring:
 Transform canvas into `print`-able string
 
 Parameters:
-    linesep: str  The requested line seperator. default: os.linesep
+    linesep: str  The requested line separator. default: os.linesep
 
 Returns:
     unicode: The canvas as a string.
@@ -586,3 +610,8 @@ In [29]: print(cvs.plot())
 
 [![Stargazers over time](https://starchart.cc/tammoippen/plotille.svg)](https://starchart.cc/tammoippen/plotille)
 
+## Sponsoring the project
+
+If you like the project and want to buy me a coffee, feel free to send some coins ;)
+
+[<img src="https://api.gitsponsors.com/api/badge/img?id=105019800" height="20">](https://api.gitsponsors.com/api/badge/link?p=gkBol1u2+g2pjgZGRaDLy4k0XbPDRXdPWJWnueCUGo/wcSsqyE8nr+n9nvqfeuqXee6JhLARGZS5bP0ZvorS7y6t4INyHLtTrprYh9c+MYkqAZeSqNIf7WL0ZRTI070RVQA3L9QW9IZNFlMbulW+BQ==)

{plotille-4.0.2 → plotille-6.0.0}/plotille/__init__.py

@@ -1,9 +1,6 @@
-# -*- coding: utf-8 -*-
-from __future__ import absolute_import, division, print_function, unicode_literals
-
 # The MIT License
 
-# Copyright (c) 2017 - 2022 Tammo Ippen, tammo.ippen@posteo.de
+# Copyright (c) 2017 - 2025 Tammo Ippen, tammo.ippen@posteo.de
 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
@@ -27,18 +24,18 @@ from ._canvas import Canvas
 from ._cmaps import Colormap, ListedColormap
 from ._colors import color, hsl
 from ._figure import Figure
-from ._graphs import hist, histogram, plot, scatter
-
+from ._graphs import hist, hist_aggregated, histogram, plot, scatter
 
 __all__ = [
-    'Canvas',
-    'color',
-    'Colormap',
-    'Figure',
-    'hist',
-    'histogram',
-    'hsl',
-    'ListedColormap',
-    'plot',
-    'scatter',
+    "Canvas",
+    "Colormap",
+    "Figure",
+    "ListedColormap",
+    "color",
+    "hist",
+    "hist_aggregated",
+    "histogram",
+    "hsl",
+    "plot",
+    "scatter",
 ]