Metadata-Version: 2.1
Name: clean-business-chart
Version: 0.2.20
Summary: Clean Business Chart is a Python package for IBCS-like charts based on matplotlib. Currently a column chart with waterfall and a barchart with waterfall are supported.
Home-page: https://github.com/marcelw1323/clean_business_chart
Author: Marcel Wuijtenburg
Author-email: marcelw1323@gmail.com
License: MIT license
Keywords: clean business chart,IBCS,business chart,clean business charts,business charts,chart,charts
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
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 :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.6
License-File: LICENSE
License-File: AUTHORS.rst
Requires-Dist: matplotlib (>=3.5.1)
Requires-Dist: pandas (>=1.3)

====================
Clean Business Chart
====================


.. image:: https://img.shields.io/pypi/v/clean_business_chart.svg
        :target: https://pypi.python.org/pypi/clean_business_chart





Clean Business Chart is a Python package for IBCS-like charts based on matplotlib. Currently a column chart with waterfall and a barchart with waterfall are supported


* Free software: MIT license
* Documentation: https://github.com/MarcelW1323/clean_business_chart/wiki.


Features
--------

* ColumnWithWaterfall, the first chart released with clean-business-chart (version 0.1.0)

  * added support for pandas in version 0.1.1

  * added date column support for pandas DataFrame and added translation of column headers inside the call in version 0.1.2

  * fixed error with FC-scenario when all FC-values were zero in version 0.2.12
  
  * fixed cosmetic bug with AC-scenario when total equals 0, stacked bar on the right has an element of zero in version 0.2.13 

  * added support for parameter footnote in version 0.2.15
  
  * added parameter last_closed_month to indicate last used month for actual values in version 0.2.18
  
  * technically optimized to use one axes-object (instead of 4) so it is prepared for small multiples. Chart looks more crisp because with zorder objects and text are better organized in version 0.2.20

* BarWithWaterfall, the second chart released in version 0.2.2

  * added support for parameter sort_chart in version 0.2.4

  * added support for parameter footnote in version 0.2.6

  * added support for parameter figsize in version 0.2.7 for optional (manual) sizing of the chart

  * better calculation of vertical part of figsize in version 0.2.8 for automatic sizing of the chart

  * added support for parameter translate_scenario in version 0.2.9 for optional translating the standard scenarios on the output of the chart
  
  * added support for parameter scalingvalue in version 0.2.10 for optional visualizing a scaling band. Also better visibility of texts. And added support for parameter figsize to only use x-size in float or integer

  * later rounding in the process leads to better connection between the waterfall and the total bars in version 0.2.11
  
  * fixed waterfall pattern-bug so FC-comparison looks different than AC-comparison in version 0.2.14
  
  * fixed disconnected lines bug in some cases by later rounding in the total values of the bar chart in version 0.2.16
  
  * improved support for parameter sort_chart also in combination with year or month fields in version 0.2.17
  
  * added support for parameter highlight to highlight detail bars in version 0.2.18
  
  * fixed a small bug with forecast information in special cases when no usable visual was produced. Solved in version 0.2.19

* General

  * better rounding support for values of chart-labels in version 0.2.5


Read more
---------

* README.MD on github: https://github.com/MarcelW1323/clean_business_chart/blob/main/README.md
* LinkedIn Group on Clean Business Chart: https://www.linkedin.com/groups/12783685/


Credits
-------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage


=======
History
=======

0.2.20 (2025-09-05)
-------------------

* Column chart with waterfall is prepared for small multiples by using only one axes-object
* Column chart with waterfall looks more crisp through better organizing of objects and text with zorder


0.2.19 (2024-10-01)
-------------------

* Fixed a small bug with forecast information in special cases when no usable visual was produced


0.2.18 (2024-09-15)
-------------------

* Added parameter 'highlight' in bar chart with waterfall to highlight detail bars.
* Added parameter 'last_closed_month' in column chart with waterfall to indicate last used month for actual values


0.2.17 (2024-07-07)
-------------------

* Improved support for parameter sort_chart also in combination with year or month fields in bar chart with waterfall


0.2.16 (2024-05-25)
-------------------

* Fixed disconnected lines bug in some cases by later rounding in the total values of the bar chart


0.2.15 (2024-03-04)
-------------------

* Added parameter 'footnote' and related 'footnote_size' in column chart with waterfall for supporting footnotes for example to mention the source.
* Centralized function for display of the footnote so bar chart with waterfall and column chart with waterfall share the same code base


0.2.14 (2024-01-26)
-------------------

* Fixed waterfall pattern-bug in bar chart with waterfall


0.2.13 (2024-01-26)
-------------------

* Fixed cosmetic bug with AC-scenario when total equals zero in column chart with waterfall


0.2.12 (2024-01-06)
-------------------

* Fixed error with FC-scenario when all FC-values were zero


0.2.11 (2023-12-23)
-------------------

* Later rounding in the process leads to better connection between the waterfall and the total bars


0.2.10 (2023-12-14)
-------------------

* Added parameter 'scalingvalue' in bar chart with waterfall for optional visualizing a scaling band. Improved chart with better visibility of texts. And added support for parameter 'figsize' for providing the x-size


0.2.9 (2023-11-26)
------------------

* Added parameter 'translate_scenario' in bar chart with waterfall for optional translating the standard scenarios on the output of the chart.


0.2.8 (2023-11-18)
------------------

* Better calculation of vertical part of figsize for automatic sizing of the bar chart with waterfall.


0.2.7 (2023-11-12)
------------------

* Added parameter 'figsize' in bar chart with waterfall for optional (manual) sizing of the chart.


0.2.6 (2023-10-29)
------------------

* Added parameter 'footnote' and related 'footnote_size' in bar chart with waterfall for supporting footnotes for example to mention the source.


0.2.5 (2023-10-15)
------------------

* Better rounding support for value labels in charts.


0.2.4 (2023-09-26)
------------------

* Added parameter 'sort_chart' in bar chart with waterfall for supporting ordinal categories-of-interest.


0.2.2 (2023-09-14)
------------------

* Second chart: bar chart with waterfall. Small bug occured on Google Colab, not at local installation. Other solution.


0.2.1 (2023-09-12)
------------------

* Second chart: bar chart with waterfall. Small bug occured on Google Colab, not at local installation. Bugfix wasn't succesfull.


0.2.0 (2023-09-12)
------------------

* Second chart: bar chart with waterfall.


0.1.2 (2023-04-11)
------------------

* Added date column in pandas DataFrame support in parameter data when calling the column chart with waterfall.
* Also added translate_headers as a parameter in dictionary-form to rename the columns within the call.


0.1.1 (2023-03-29)
------------------

* Added pandas DataFrame support in parameter data when calling the column chart with waterfall.


0.1.0 (2023-02-21)
------------------

* First release on PyPI. Column chart with waterfall.

