d3blocks 2.2.0__tar.gz → 2.2.1__tar.gz

d3blocks-2.2.1/PKG-INFO

@@ -0,0 +1,159 @@
+Metadata-Version: 2.4
+Name: d3blocks
+Version: 2.2.1
+Summary: Python package d3blocks.
+Author-email: Erdogan Taskesen <erdogant@gmail.com>
+License-Expression: GPL-3.0-or-later
+Project-URL: Homepage, https://erdogant.github.io/d3blocks
+Project-URL: Download, https://github.com/erdogant/d3blocks/archive/{version}.tar.gz
+Keywords: Python,visualizations,interactive,javascript,d3js,d3blocks,network,graph,data visualization,web,extendable,extension,plugin,modular,customizable
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: Unix
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
+Requires-Python: >=3
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: colourmap>=1.1.10
+Requires-Dist: datazets>=0.1.7
+Requires-Dist: d3graph>=3.2.0
+Requires-Dist: ismember>=1.0.1
+Requires-Dist: pandas
+Requires-Dist: tqdm
+Requires-Dist: requests
+Requires-Dist: jinja2
+Requires-Dist: scikit-learn
+Dynamic: license-file
+
+[![Python](https://img.shields.io/pypi/pyversions/d3blocks)](https://img.shields.io/pypi/pyversions/d3blocks)
+[![Pypi](https://img.shields.io/pypi/v/d3blocks)](https://pypi.org/project/d3blocks/)
+[![Docs](https://img.shields.io/badge/Sphinx-Docs-blue)](https://d3blocks.github.io/d3blocks/)
+[![LOC](https://sloc.xyz/github/d3blocks/d3blocks/?category=code)](https://github.com/d3blocks/d3blocks/)
+[![Downloads](https://static.pepy.tech/personalized-badge/d3blocks?period=month&units=international_system&left_color=grey&right_color=brightgreen&left_text=PyPI%20downloads/month)](https://pepy.tech/project/d3blocks)
+[![Downloads](https://static.pepy.tech/personalized-badge/d3blocks?period=total&units=international_system&left_color=grey&right_color=brightgreen&left_text=Downloads)](https://pepy.tech/project/d3blocks)
+[![License](https://img.shields.io/badge/license-GPL3-green.svg)](https://github.com/d3blocks/d3blocks/blob/master/LICENSE)
+[![Forks](https://img.shields.io/github/forks/d3blocks/d3blocks.svg)](https://github.com/d3blocks/d3blocks/network)
+[![Open Issues](https://img.shields.io/github/issues/d3blocks/d3blocks.svg)](https://github.com/d3blocks/d3blocks/issues)
+[![Project Status](http://www.repostatus.org/badges/latest/active.svg)](http://www.repostatus.org/#active)
+[![Medium](https://img.shields.io/badge/Medium-Blog-black)](https://d3blocks.github.io/d3blocks/Documentation.html#medium-blog)
+![GitHub Repo stars](https://img.shields.io/github/stars/d3blocks/d3blocks)
+![GitHub repo size](https://img.shields.io/github/repo-size/d3blocks/d3blocks)
+[![Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://github.com/d3blocks/d3blocks/blob/main/notebooks/d3blocks.ipynb)
+[![Donate](https://img.shields.io/badge/Support%20this%20project-grey.svg?logo=github%20sponsors)](https://d3blocks.github.io/d3blocks/Documentation.html#)
+
+### 
+
+<div>
+
+<a href="https://d3blocks.github.io/d3blocks/"><img src="https://github.com/d3blocks/d3blocks/blob/main/logo.png" width="275" align="left" /></a>
+``D3Blocks`` is a Python package that builds on the graphics of d3 javascript (d3js). It allows you to create the most visually attractive and useful charts with only a few lines of Python code!
+The [documentation pages](https://d3blocks.github.io/d3blocks/) contain detailed information about the working of the blocks with many examples. **⭐️ Star it if you like it ⭐️**
+</div>
+
+---
+
+<p align="center">
+  <a href="https://d3blocks.github.io/d3blocks">
+  <img src="https://github.com/d3blocks/d3blocks/blob/main/docs/figs/summary.png" width="600" />
+  </a>
+</p>
+
+---
+
+### Resources and Links
+- [**Example Notebooks**](https://d3blocks.github.io/d3blocks/Documentation.html#google-colab-notebooks)
+- [**Documentation**](https://d3blocks.github.io/d3blocks)
+- [**Bug Reports and Feature Requests**](https://github.com/d3blocks/d3blocks/issues)
+
+### Blogs
+- [**Medium Blog**](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510)
+- [**Substack with podcast**](https://erdogant.substack.com/p/d3blocks-the-python-library-to-create)
+- [**Gumroad Blogs with podcast**](https://erdogant.gumroad.com/l/d3blocks-the-python-library-to-create-interactive-standalone-and-beautiful-d3-js-charts)
+
+-------------------------------------------------------------------------
+### [Available charts](https://d3blocks.github.io/d3blocks/)
+
+
+|  nr |  Block                                                                             |    Function                  |    More Information                                                                 |
+|-----|------------------------------------------------------------------------------------|------------------------------|-------------------------------------------------------------------------|
+|  1  | [D3graph](https://d3blocks.github.io/d3blocks/d3graph.html)                | ``` d3.d3graph() ```         | [D3graph](https://medium.com/data-science-collective/how-to-turn-any-network-into-an-interactive-knowledge-graph-to-discover-hidden-insights-f49fae4757ff)                                  |
+|  2  | [Radialgraph](https://d3blocks.github.io/d3blocks/Radialgraph.html)   | ``` d3.radialgraph() ```     | [Radialgraph](https://medium.com/data-science-collective/radialgraph-a-new-way-to-explore-large-networks-without-the-hairball-ea34193ddec9)                              |
+|  3  | [Elasticgraph](https://d3blocks.github.io/d3blocks/elasticgraph.html)   | ``` d3.elasticgraph() ```    | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510)                             |
+|  4  | [Sankey](https://d3blocks.github.io/d3blocks/Sankey.html)               | ``` d3.sankey()  ```         | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510)                                   |
+|  5  | [Movingbubbles](https://d3blocks.github.io/d3blocks/MovingBubbles.html) | ``` d3.movingbubbles()  ```  | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510)    |
+|  6  | [Scatter](https://d3blocks.github.io/d3blocks/Scatter.html)             | ``` d3.scatter()  ```        | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510)       |
+|  7  | [Heatmap](https://d3blocks.github.io/d3blocks/Heatmap.html)             | ``` d3.heatmap()  ```        | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510)  |
+|  8  | [Chord diagram](https://d3blocks.github.io/d3blocks/Chord.html)         | ``` d3.chord()  ```          | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510) |
+|  9  | [Timeseries](https://d3blocks.github.io/d3blocks/Timeseries.html)       | ``` d3.timeseries()  ```     | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510) |
+|  10 | [Image slider](https://d3blocks.github.io/d3blocks/Imageslider.html)    | ``` d3.imageslider()  ```    | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510) |
+|  11 | [Violin plot](https://d3blocks.github.io/d3blocks/Violin.html)          | ``` d3.violin()  ```         | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510) |
+|  12 | [Particles](https://d3blocks.github.io/d3blocks/Particles.html)         | ``` d3.particles()  ```      | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510) |
+|  13 | [Treemap](https://d3blocks.github.io/d3blocks/Treemap.html)             | ``` d3.treemap()  ```        | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510) |
+|  14 | [Tree](https://d3blocks.github.io/d3blocks/Tree.html)                   | ``` d3.tree()  ```           | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510) |
+|  15 | [Maps](https://d3blocks.github.io/d3blocks/Maps.html)                   | ``` d3.maps()  ```           | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510) |
+|  16 | [Circlepacking](https://d3blocks.github.io/d3blocks/Circlepacking.html) | ``` d3.circlepacking()  ```  | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510) |
+|  17 | [Flowgraph](https://d3blocks.github.io/d3blocks/Flowgraph.html)         | ``` d3.flowgraph()  ```      | [Dagre](https://github.com/dagrejs/dagre) |
+
+-------------------------------------------------------------------------
+
+#### Installation (Pypi)
+```bash
+pip install d3blocks     # Normal installation
+pip install -U d3blocks  # Force update
+```
+
+#### Installation (clone)
+```bash
+git clone https://github.com/d3blocks/d3blocks.git
+cd d3blocks
+pip install -U .
+```  
+
+#### Import d3blocks package
+```python
+from d3blocks import D3Blocks
+# Initialize
+d3 = D3Blocks()
+```
+
+
+---
+
+### D3Blocks💙Streamlit
+Every chart from D3Block can easily be incorporated into a Streamlit Dashboard. Because every D3Blocks chart is just HTML and JavaScript, you can generate the HTML in memory and embed it 
+A few practical rules of thumb: prefer `st.iframe` over the older `components.html` for full interactive charts, always pass an explicit pixel height, and set `show_side_panel=False` when Streamlit already owns the controls so the UI doesn't duplicate. `color_background='streamlit'` picks backgrounds that match a typical Streamlit light or dark page.
+
+* [Minimal examples for each chart can be found in the Streamlit directory in the repo](https://github.com/d3blocks/d3blocks/tree/main/streamlit). 
+* [More Streamlit documentation can be found here.](https://d3blocks.github.io/d3blocks/Streamlit.html)
+
+---
+
+### Ethical Ads
+When HTMLs are generated, it automatically includes ethical ads as a small way to support development. 
+I maintain this entire project thoughtfully and in my free time. Ads can be disabled via an input parameter, and you can also support the project with a coffee donation instead.
+
+### Star history
+[![Star History Chart](https://star-history.dera.page/svg?repos=d3blocks/d3blocks)](https://star-history.dera.page/d3blocks/d3blocks)
+
+### References
+* [bl.ocks](https://bl.ocks.org/)
+* [observablehq](https://observablehq.com/top)
+
+### Contributors
+
+<p align="left">
+  <a href="https://github.com/d3blocks/d3blocks/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=d3blocks/d3blocks" />
+  </a>
+</p>
+
+### Maintainer
+* Erdogan Taskesen, github: [erdogant](https://github.com/erdogant)
+* Contributions are welcome.
+* Yes! This library is entirely **free** but it runs on coffee! :) Feel free to support with a <a href="https://erdogant.github.io/donate/?currency=USD&amount=5">Coffee</a>.
+
+[![Buy me a coffee](https://img.buymeacoffee.com/button-api/?text=Buy+me+a+coffee&emoji=&slug=erdogant&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=FFDD00)](https://www.buymeacoffee.com/erdogant)

d3blocks-2.2.1/README.md

@@ -0,0 +1,128 @@
+[![Python](https://img.shields.io/pypi/pyversions/d3blocks)](https://img.shields.io/pypi/pyversions/d3blocks)
+[![Pypi](https://img.shields.io/pypi/v/d3blocks)](https://pypi.org/project/d3blocks/)
+[![Docs](https://img.shields.io/badge/Sphinx-Docs-blue)](https://d3blocks.github.io/d3blocks/)
+[![LOC](https://sloc.xyz/github/d3blocks/d3blocks/?category=code)](https://github.com/d3blocks/d3blocks/)
+[![Downloads](https://static.pepy.tech/personalized-badge/d3blocks?period=month&units=international_system&left_color=grey&right_color=brightgreen&left_text=PyPI%20downloads/month)](https://pepy.tech/project/d3blocks)
+[![Downloads](https://static.pepy.tech/personalized-badge/d3blocks?period=total&units=international_system&left_color=grey&right_color=brightgreen&left_text=Downloads)](https://pepy.tech/project/d3blocks)
+[![License](https://img.shields.io/badge/license-GPL3-green.svg)](https://github.com/d3blocks/d3blocks/blob/master/LICENSE)
+[![Forks](https://img.shields.io/github/forks/d3blocks/d3blocks.svg)](https://github.com/d3blocks/d3blocks/network)
+[![Open Issues](https://img.shields.io/github/issues/d3blocks/d3blocks.svg)](https://github.com/d3blocks/d3blocks/issues)
+[![Project Status](http://www.repostatus.org/badges/latest/active.svg)](http://www.repostatus.org/#active)
+[![Medium](https://img.shields.io/badge/Medium-Blog-black)](https://d3blocks.github.io/d3blocks/Documentation.html#medium-blog)
+![GitHub Repo stars](https://img.shields.io/github/stars/d3blocks/d3blocks)
+![GitHub repo size](https://img.shields.io/github/repo-size/d3blocks/d3blocks)
+[![Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://github.com/d3blocks/d3blocks/blob/main/notebooks/d3blocks.ipynb)
+[![Donate](https://img.shields.io/badge/Support%20this%20project-grey.svg?logo=github%20sponsors)](https://d3blocks.github.io/d3blocks/Documentation.html#)
+
+### 
+
+<div>
+
+<a href="https://d3blocks.github.io/d3blocks/"><img src="https://github.com/d3blocks/d3blocks/blob/main/logo.png" width="275" align="left" /></a>
+``D3Blocks`` is a Python package that builds on the graphics of d3 javascript (d3js). It allows you to create the most visually attractive and useful charts with only a few lines of Python code!
+The [documentation pages](https://d3blocks.github.io/d3blocks/) contain detailed information about the working of the blocks with many examples. **⭐️ Star it if you like it ⭐️**
+</div>
+
+---
+
+<p align="center">
+  <a href="https://d3blocks.github.io/d3blocks">
+  <img src="https://github.com/d3blocks/d3blocks/blob/main/docs/figs/summary.png" width="600" />
+  </a>
+</p>
+
+---
+
+### Resources and Links
+- [**Example Notebooks**](https://d3blocks.github.io/d3blocks/Documentation.html#google-colab-notebooks)
+- [**Documentation**](https://d3blocks.github.io/d3blocks)
+- [**Bug Reports and Feature Requests**](https://github.com/d3blocks/d3blocks/issues)
+
+### Blogs
+- [**Medium Blog**](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510)
+- [**Substack with podcast**](https://erdogant.substack.com/p/d3blocks-the-python-library-to-create)
+- [**Gumroad Blogs with podcast**](https://erdogant.gumroad.com/l/d3blocks-the-python-library-to-create-interactive-standalone-and-beautiful-d3-js-charts)
+
+-------------------------------------------------------------------------
+### [Available charts](https://d3blocks.github.io/d3blocks/)
+
+
+|  nr |  Block                                                                             |    Function                  |    More Information                                                                 |
+|-----|------------------------------------------------------------------------------------|------------------------------|-------------------------------------------------------------------------|
+|  1  | [D3graph](https://d3blocks.github.io/d3blocks/d3graph.html)                | ``` d3.d3graph() ```         | [D3graph](https://medium.com/data-science-collective/how-to-turn-any-network-into-an-interactive-knowledge-graph-to-discover-hidden-insights-f49fae4757ff)                                  |
+|  2  | [Radialgraph](https://d3blocks.github.io/d3blocks/Radialgraph.html)   | ``` d3.radialgraph() ```     | [Radialgraph](https://medium.com/data-science-collective/radialgraph-a-new-way-to-explore-large-networks-without-the-hairball-ea34193ddec9)                              |
+|  3  | [Elasticgraph](https://d3blocks.github.io/d3blocks/elasticgraph.html)   | ``` d3.elasticgraph() ```    | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510)                             |
+|  4  | [Sankey](https://d3blocks.github.io/d3blocks/Sankey.html)               | ``` d3.sankey()  ```         | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510)                                   |
+|  5  | [Movingbubbles](https://d3blocks.github.io/d3blocks/MovingBubbles.html) | ``` d3.movingbubbles()  ```  | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510)    |
+|  6  | [Scatter](https://d3blocks.github.io/d3blocks/Scatter.html)             | ``` d3.scatter()  ```        | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510)       |
+|  7  | [Heatmap](https://d3blocks.github.io/d3blocks/Heatmap.html)             | ``` d3.heatmap()  ```        | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510)  |
+|  8  | [Chord diagram](https://d3blocks.github.io/d3blocks/Chord.html)         | ``` d3.chord()  ```          | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510) |
+|  9  | [Timeseries](https://d3blocks.github.io/d3blocks/Timeseries.html)       | ``` d3.timeseries()  ```     | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510) |
+|  10 | [Image slider](https://d3blocks.github.io/d3blocks/Imageslider.html)    | ``` d3.imageslider()  ```    | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510) |
+|  11 | [Violin plot](https://d3blocks.github.io/d3blocks/Violin.html)          | ``` d3.violin()  ```         | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510) |
+|  12 | [Particles](https://d3blocks.github.io/d3blocks/Particles.html)         | ``` d3.particles()  ```      | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510) |
+|  13 | [Treemap](https://d3blocks.github.io/d3blocks/Treemap.html)             | ``` d3.treemap()  ```        | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510) |
+|  14 | [Tree](https://d3blocks.github.io/d3blocks/Tree.html)                   | ``` d3.tree()  ```           | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510) |
+|  15 | [Maps](https://d3blocks.github.io/d3blocks/Maps.html)                   | ``` d3.maps()  ```           | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510) |
+|  16 | [Circlepacking](https://d3blocks.github.io/d3blocks/Circlepacking.html) | ``` d3.circlepacking()  ```  | [D3Blocks](https://medium.com/data-science-collective/d3blocks-the-sweet-spot-for-data-scientists-interactive-charts-without-deployment-friction-c7f576025510) |
+|  17 | [Flowgraph](https://d3blocks.github.io/d3blocks/Flowgraph.html)         | ``` d3.flowgraph()  ```      | [Dagre](https://github.com/dagrejs/dagre) |
+
+-------------------------------------------------------------------------
+
+#### Installation (Pypi)
+```bash
+pip install d3blocks     # Normal installation
+pip install -U d3blocks  # Force update
+```
+
+#### Installation (clone)
+```bash
+git clone https://github.com/d3blocks/d3blocks.git
+cd d3blocks
+pip install -U .
+```  
+
+#### Import d3blocks package
+```python
+from d3blocks import D3Blocks
+# Initialize
+d3 = D3Blocks()
+```
+
+
+---
+
+### D3Blocks💙Streamlit
+Every chart from D3Block can easily be incorporated into a Streamlit Dashboard. Because every D3Blocks chart is just HTML and JavaScript, you can generate the HTML in memory and embed it 
+A few practical rules of thumb: prefer `st.iframe` over the older `components.html` for full interactive charts, always pass an explicit pixel height, and set `show_side_panel=False` when Streamlit already owns the controls so the UI doesn't duplicate. `color_background='streamlit'` picks backgrounds that match a typical Streamlit light or dark page.
+
+* [Minimal examples for each chart can be found in the Streamlit directory in the repo](https://github.com/d3blocks/d3blocks/tree/main/streamlit). 
+* [More Streamlit documentation can be found here.](https://d3blocks.github.io/d3blocks/Streamlit.html)
+
+---
+
+### Ethical Ads
+When HTMLs are generated, it automatically includes ethical ads as a small way to support development. 
+I maintain this entire project thoughtfully and in my free time. Ads can be disabled via an input parameter, and you can also support the project with a coffee donation instead.
+
+### Star history
+[![Star History Chart](https://star-history.dera.page/svg?repos=d3blocks/d3blocks)](https://star-history.dera.page/d3blocks/d3blocks)
+
+### References
+* [bl.ocks](https://bl.ocks.org/)
+* [observablehq](https://observablehq.com/top)
+
+### Contributors
+
+<p align="left">
+  <a href="https://github.com/d3blocks/d3blocks/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=d3blocks/d3blocks" />
+  </a>
+</p>
+
+### Maintainer
+* Erdogan Taskesen, github: [erdogant](https://github.com/erdogant)
+* Contributions are welcome.
+* Yes! This library is entirely **free** but it runs on coffee! :) Feel free to support with a <a href="https://erdogant.github.io/donate/?currency=USD&amount=5">Coffee</a>.
+
+[![Buy me a coffee](https://img.buymeacoffee.com/button-api/?text=Buy+me+a+coffee&emoji=&slug=erdogant&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=FFDD00)](https://www.buymeacoffee.com/erdogant)

{d3blocks-2.2.0 → d3blocks-2.2.1}/d3blocks/__init__.py

@@ -10,7 +10,7 @@ from d3blocks.utils import (
 
 __author__ = 'Erdogan Taskesen'
 __email__ = 'erdogant@gmail.com'
-__version__ = '2.2.0'
+__version__ = '2.2.1'
 
 # Setup root logger
 import logging

{d3blocks-2.2.0 → d3blocks-2.2.1}/d3blocks/examples.py

@@ -1,3 +1,42 @@
+# %% Flowgraph
+
+# Edge list with shapes and edge labels
+from d3blocks import D3Blocks
+import pandas as pd
+
+d3 = D3Blocks(frame=False)
+df = pd.DataFrame({'source': ['Start', 'Valid?', 'Valid?', 'Fix'],
+                   'target': ['Valid?', 'Done', 'Fix', 'Valid?'],
+                   'label': ['', 'yes', 'no', 'retry']})
+
+nodes = {'Start': {'shape': 'terminal'}, 'Valid?': {'shape': 'decision'},
+         'Done': {'shape': 'terminal'}}
+
+# Set the flowgraph
+d3.flowgraph(df, nodes=nodes, direction='TB', showfig=True)
+
+# Change a node and redraw
+d3.node_properties['Fix']['color'] = '#e15759'
+d3.show(showfig=True)
+
+# %%
+
+
+# Mermaid diagram kept in a Markdown file (renders on GitHub too)
+d3.flowgraph('docs/process.md')
+
+# Mermaid flowchart with a subgraph, laid out with ELK
+d3.flowgraph('''
+flowchart LR
+  subgraph api [API]
+    gw[Gateway] --> svc[Orders]
+  end
+  svc --> db[(Postgres)]
+  svc -.->|events| q[[Worker]]
+''', layout='elk')
+
+
+# %% imageslider
 from d3blocks import D3Blocks
 d3 = D3Blocks()
 img_before, img_after = d3.import_example('southern_nebula_internet')
@@ -80,13 +119,13 @@ from d3blocks import D3Blocks
 # Initialize
 d3 = D3Blocks()
 
-df = d3.import_example('energy')
-
+df = d3.import_example('socialmedia')
+df = df[0:200]
 # Create the chart
 d3.heatmap(
           df=df,
-          show_side_panel=False,
-          show_top_panel=False,
+          show_side_panel=True,
+          show_top_panel=True,
           dark_mode=True,
           # color_background='streamlit',
           )

{d3blocks-2.2.0 → d3blocks-2.2.1}/d3blocks/heatmap/Heatmap.py

@@ -33,7 +33,7 @@ def set_config(config={}, **kwargs):
     config['stroke'] = kwargs.get('stroke', 'red')
     config['notebook'] = kwargs.get('notebook', False)
     config['reset_properties'] = kwargs.get('reset_properties', True)
-    config['cmap'] = kwargs.get('cmap', 'Set1')
+    config['cmap'] = kwargs.get('cmap', 'tableau')
     config['cluster_params'] = kwargs.get('cluster_params', {})
     config['scale'] = kwargs.get('scale', False)
     config['fontsize'] = kwargs.get('fontsize', 10)
@@ -149,6 +149,59 @@ def set_node_properties(df, **kwargs):
     return dict_labels
 
 
+_NOISE_COLOR = '#8a8f9c'
+_TABLEAU10 = ['#4e79a7', '#f28e2b', '#e15759', '#76b7b2', '#59a14f',
+              '#edc948', '#b07aa1', '#ff9da7', '#9c755f', '#bab0ac']
+_OLD_QUALITATIVE_DEFAULTS = (None, 'tableau', 'Set1', 'Set2')
+
+
+def _cluster_palette(n, cmap=None):
+    """Return n visually distinct hex colors (one per cluster).
+
+    The old approach sampled 8-9 color qualitative colormaps through a 0..1
+    normalisation, which produced duplicate colors for >8 clusters and always
+    ended on gray. Here every cluster gets its own entry.
+    """
+    import colorsys
+    if cmap in _OLD_QUALITATIVE_DEFAULTS:
+        if n <= len(_TABLEAU10):
+            return _TABLEAU10[:n]
+        # More clusters than the base palette: spread hues, alternate lightness
+        cols = list(_TABLEAU10)
+        extra = n - len(cols)
+        for i in range(extra):
+            h = (i * 0.618033988749895) % 1.0  # golden-angle hue spacing
+            l = 0.55 if i % 2 == 0 else 0.42
+            r, g, b = colorsys.hls_to_rgb(h, l, 0.65)
+            cols.append('#%02x%02x%02x' % (int(r * 255), int(g * 255), int(b * 255)))
+        return cols
+    # User supplied a matplotlib colormap: use its discrete colors if it has enough, else sample evenly
+    import matplotlib
+    from matplotlib.colors import ListedColormap, to_hex
+    cm = matplotlib.colormaps[cmap]
+    if isinstance(cm, ListedColormap) and cm.N >= n and cm.N <= 20:
+        return [to_hex(cm.colors[i]) for i in range(n)]
+    return [to_hex(cm(v)) for v in np.linspace(0, 1, max(n, 2))[:n]]
+
+
+def _color_from_labels(labels, cmap):
+    """Map arbitrary cluster labels to (consecutive int labels, hex colors). Label -1 (noise) is gray."""
+    labels = np.asarray(labels)
+    uni = [u for u in np.unique(labels) if u != -1]
+    palette = _cluster_palette(len(uni), cmap)
+    lut = {int(u): palette[i] for i, u in enumerate(uni)}
+    lut[-1] = _NOISE_COLOR
+    colors = [lut[int(x)] for x in labels]
+    return [int(x) for x in labels], colors
+
+
+def _log(logger, level, msg):
+    if logger is not None:
+        getattr(logger, level)(msg)
+    else:
+        print('[%s] %s' % (level, msg))
+
+
 def set_colors(df, **kwargs):
     """Color in clusterlabel.
 
@@ -162,60 +215,56 @@ def set_colors(df, **kwargs):
     config = kwargs.get('config')
     node_properties = kwargs.get('node_properties')
 
-    # d3network.vec2adjmat(source, target, weight=weight, symmetric=symmetric, aggfunc=aggfunc)
-    if df.get('weight', None) is not None:
-        df = df.copy()
-        df['weight'] = normalize(df['weight'].values, scaler=config['scaler'])
-    adjmat = vec2adjmat(source=df['source'], target=df['target'], weight=df.get('weight', None).values, symmetric=True)
-
     # Default is all cluster labels are the same
-    # Convert NumPy integers to regular Python integers for proper JSON serialization
     node_properties['classlabel'] = [0] * node_properties.shape[0]
     node_properties['color'] = '#000000'
 
-    if isinstance(config.get('color'), str) and config.get('color')=='cluster':
-        # Cluster the nodes
+    if isinstance(config.get('color'), str) and config.get('color') == 'cluster':
         try:
             from clusteval import clusteval
         except Exception:
-            if logger is not None:
-                logger.warning('clusteval is not installed; skipping clustering and using default colors. Tip: pip install clusteval')
-            else:
-                print('Warning: clusteval is not installed; skipping clustering and using default colors. Tip: pip install clusteval')
+            _log(logger, 'warning', 'clusteval is not installed; skipping clustering and using default colors. Tip: pip install clusteval')
             return node_properties
-        # Initialize
-        plot_param = config['cluster_params'].pop('plot', False)
-        ce = clusteval(**config['cluster_params'])
+
+        # Cluster on the RAW weights. Z-scoring first turned "no link" (0) into an
+        # "average link" and distorted the row profiles that are being clustered.
+        weight = df['weight'].values if df.get('weight', None) is not None else np.ones(df.shape[0])
+        adjmat = vec2adjmat(source=df['source'], target=df['target'], weight=weight, symmetric=True)
+        adjmat = adjmat.fillna(0)
+
+        # Do not mutate the (possibly shared/default) cluster_params dict
+        cluster_params = dict(config.get('cluster_params') or {})
+        plot_param = cluster_params.pop('plot', False)
+        ce = clusteval(**cluster_params)
         results = ce.fit(adjmat.values)
         if plot_param: ce.plot()
-        logger.info('[%d] clusters detected' %(len(np.unique(results['labx']))))
+        labx = np.asarray(results['labx'])
+        _log(logger, 'info', '[%d] clusters detected' % (len(np.unique(labx[labx != -1]))))
 
-        # uilabx = np.unique(results['labx'])
+        # Align cluster labels with node_properties order (adjmat order can differ!)
         Iloc, idx = ismember(node_properties['label'].values, adjmat.index.values)
         if np.any(~Iloc):
-            logger.error('Feature name(s): %s can not be used. Hint: Remove special characters. <return>' %(df.index.values[~np.isin(np.arange(0, df.shape[0]), idx)]))
+            missing = node_properties['label'].values[~np.asarray(Iloc)]
+            _log(logger, 'error', 'Feature name(s): %s can not be used. Hint: Remove special characters.' % (missing,))
             return None
-        logger.info('Colors are based on clustering.')
-        # Convert NumPy integers to regular Python integers for proper JSON serialization
-        node_properties['classlabel'] = [int(x) for x in results['labx']]
-        # # Create node colors
-        colors = colourmap.fromlist(node_properties['classlabel'], cmap=config['cmap'], scheme='hex', verbose=0)[0]
-        # Convert NumPy strings to regular Python strings
-        node_properties['color'] = [str(c) for c in colors]
+        labx_nodes = labx[np.asarray(idx)]
+        _log(logger, 'info', 'Colors are based on clustering.')
+        classlabel, colors = _color_from_labels(labx_nodes, config.get('cmap'))
+        node_properties['classlabel'] = classlabel
+        node_properties['color'] = colors
+
     elif isinstance(config['color'], (list, np.ndarray)):
         if np.all(list(map(colourmap.is_hex_color, config['color']))):
-            logger.info('Colors are based on the input hex colors.')
-            # Convert NumPy strings to regular Python strings
+            _log(logger, 'info', 'Colors are based on the input hex colors.')
             node_properties['color'] = [str(c) for c in config['color']]
             class_labels = ismember(config['color'], np.unique(config['color']))[1]
             node_properties['classlabel'] = [int(x) for x in class_labels]
         else:
-            logger.info('Colors are based on the labels.')
+            _log(logger, 'info', 'Colors are based on the labels.')
             class_labels = ismember(config['color'], np.unique(config['color']))[1]
-            node_properties['classlabel'] = [int(x) for x in class_labels]
-            colors = colourmap.fromlist(node_properties['classlabel'], cmap=config['cmap'], scheme='hex', verbose=0)[0]
-            # Convert NumPy strings to regular Python strings
-            node_properties['color'] = [str(c) for c in colors]
+            classlabel, colors = _color_from_labels(class_labels, config.get('cmap'))
+            node_properties['classlabel'] = classlabel
+            node_properties['color'] = colors
 
     return node_properties
 

{d3blocks-2.2.0 → d3blocks-2.2.1}/d3blocks/heatmap/d3js/heatmap.html.j2

@@ -411,11 +411,11 @@ $SIDE_PANEL_START$
 
     <div class="physics-control">
       <label for="fontSizeSlider">Font size <span id="fontSizeVal">$FONTSIZE$</span></label>
-      <input type="range" id="fontSizeSlider" min="6" max="28" step="1" value="$FONTSIZE$" />
+      <input type="range" id="fontSizeSlider" min="0" max="28" step="1" value="$FONTSIZE$" />
     </div>
     <div class="physics-control">
       <label for="fontHoverSlider">Hover font size <span id="fontHoverVal">$FONTSIZE_MOUSEOVER$</span></label>
-      <input type="range" id="fontHoverSlider" min="8" max="36" step="1" value="$FONTSIZE_MOUSEOVER$" />
+      <input type="range" id="fontHoverSlider" min="0" max="36" step="1" value="$FONTSIZE_MOUSEOVER$" />
     </div>
     <div class="physics-control">
       <label for="strokeColor">Highlight stroke</label>
@@ -450,7 +450,7 @@ var fontSizeHover = chartConfig.fontsizeMouseover;
 var strokeColor = chartConfig.stroke;
 
 var x = d3.scale.ordinal().rangeBands([0, width]),
-    z = d3.scale.linear().domain([0, 4]).clamp(true),
+    z = d3.scale.linear().domain([0, 1]).range([0.15, 1]).clamp(true),
     c = d3.scale.category10().domain(d3.range(10));
 
 // Full-viewport SVG so zoom/pan is not clipped to the chart box
@@ -487,22 +487,36 @@ var data =
   nodes.forEach(function(node, i) {
     node.index = i;
     node.count = 0;
-    matrix[i] = d3.range(n).map(function(j) { return {x: j, y: i, z: 0}; });
+    matrix[i] = d3.range(n).map(function(j) { return {x: j, y: i, z: 0, has: false}; });
   });
 
   data.links.forEach(function(link) {
     matrix[link.source][link.target].z += link.value;
     matrix[link.target][link.source].z += link.value;
-    matrix[link.source][link.source].z += link.value;
-    matrix[link.target][link.target].z += link.value;
+    matrix[link.source][link.target].has = true;
+    matrix[link.target][link.source].has = true;
     nodes[link.source].count += link.value;
     nodes[link.target].count += link.value;
   });
+  // Diagonal: mark as present but neutral so it does not dominate the colour scale
+  nodes.forEach(function(nd, i) { matrix[i][i].has = true; matrix[i][i].diag = true; });
+
+  // Scale opacity to the real (possibly z-scored / negative) off-diagonal value range
+  (function() {
+    var vals = [];
+    matrix.forEach(function(r) { r.forEach(function(c) { if (c.has && !c.diag) vals.push(c.z); }); });
+    var lo = d3.min(vals), hi = d3.max(vals);
+    if (lo === undefined) { lo = 0; hi = 1; }
+    if (hi === lo) { hi = lo + 1; }
+    z.domain([lo, hi]);
+  })();
 
   var orders = {
     name: d3.range(n).sort(function(a, b) { return d3.ascending(nodes[a].name, nodes[b].name); }),
     count: d3.range(n).sort(function(a, b) { return nodes[b].count - nodes[a].count; }),
-    cluster: d3.range(n).sort(function(a, b) { return nodes[b].cluster - nodes[a].cluster; })
+    cluster: d3.range(n).sort(function(a, b) {
+      return (nodes[a].cluster - nodes[b].cluster) || (nodes[b].count - nodes[a].count);
+    })
   };
 
   x.domain(orders.name);
@@ -549,17 +563,18 @@ var data =
 
   function row(row) {
     var cell = d3.select(this).selectAll(".cell")
-        .data(row.filter(function(d) { return d.z; }))
+        .data(row.filter(function(d) { return d.has; }))
         .enter().append("rect")
         .attr("class", "cell")
         .attr("x", function(d) { return x(d.x); })
         .attr("width", x.rangeBand())
         .attr("height", x.rangeBand())
-        .style("fill-opacity", function(d) { return z(d.z); })
+        .style("fill-opacity", function(d) { return d.diag ? 0.9 : z(d.z); })
 		.style("fill", function(d) {
 			var sourceCluster = data.nodes[d.x].cluster;
 			var targetCluster = data.nodes[d.y].cluster;
-			return sourceCluster == targetCluster ? data.nodes[d.x].color : null;
+			// Within-cluster: cluster colour. Between clusters: neutral grey (SVG default black was invisible on dark bg)
+			return sourceCluster == targetCluster ? data.nodes[d.x].color : "#8a8f9c";
 			})
         .on("mouseover", mouseover)
         .on("mouseout", mouseout);

{d3blocks-2.2.0 → d3blocks-2.2.1}/d3blocks/skills/d3blocks/SKILL.md

@@ -41,7 +41,8 @@ When the user wants to visualize changing values or entities as animated bubbles
 When the user wants to visualize particles, movement, or dynamic particle-based patterns, prefer `particles`.
 When the user wants to visualize flows between different entities, stages, or categories, prefer `sankey`.
 When the user wants to visualize how one or more variables change over time, prefer `timeseries`.
-When the user wants to visualize hierarchical data using nested rectangles sized by value, prefer `treemap`.
+When the user wants to visualize hierarchical data using nested rectangles sized by value, prefer `tree`.
+When the user wants to make diagram, prefer `flowgraph`.
 When the user wants to compare the distributions of continuous variables across groups, prefer `violin`.
 Use `matrix` primarily when the user wants to inspect pairwise relationships, similarities, distances, or connections between rows and columns.
 Use `circlepacking` when the hierarchical structure and relative containment of groups are important.