MatplotLibAPI 3.2.14__py3-none-any.whl → 3.2.15__py3-none-any.whl

matplotlibapi-3.2.15.dist-info/METADATA

@@ -0,0 +1,269 @@
+Metadata-Version: 2.4
+Name: MatplotLibAPI
+Version: 3.2.15
+License-File: LICENSE
+Requires-Python: >=3.8
+Requires-Dist: kaleido
+Requires-Dist: matplotlib
+Requires-Dist: nbformat
+Requires-Dist: networkx
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: plotly
+Requires-Dist: scikit-learn
+Requires-Dist: seaborn
+Provides-Extra: dev
+Requires-Dist: black; extra == 'dev'
+Requires-Dist: pydocstyle; extra == 'dev'
+Requires-Dist: pyright; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest-pydocstyle; extra == 'dev'
+Requires-Dist: tomli; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# MatplotLibAPI
+
+MatplotLibAPI is a Python library that simplifies the process of creating various types of plots from pandas DataFrames. It provides a high-level API for generating bubble charts, network graphs, pivot tables, tables, time series plots, treemaps, and sunburst charts.
+
+## Installation
+
+To install the library, you can use pip:
+
+```bash
+pip install MatplotLibAPI
+```
+
+## Generating Sample Data
+
+The examples in this README use sample data that can be generated by running the `generate_sample_data.py` script:
+
+```bash
+python scripts/generate_sample_data.py
+```
+
+This will create a `data` directory with CSV files for each plot type.
+
+## Usage
+
+Here's a simple example of how to create a bubble chart using MatplotLibAPI with a sample CSV file:
+
+```python
+import pandas as pd
+import matplotlib.pyplot as plt
+from MatplotLibAPI import fplot_bubble
+
+# Load the sample data
+df = pd.read_csv('data/bubble.csv')
+
+# Generate the bubble chart
+fig = fplot_bubble(df, label='country', x='gdp_per_capita', y='population', z='population', title='Country Statistics')
+
+# Display the plot
+plt.show()
+```
+
+## Plot Types
+
+The library supports the following plot types:
+
+- **Bubble (Scatter plot)**
+- **Bar / Stacked Bar**
+- **Histogram + KDE**
+- **Box / Violin**
+- **Heatmap / Correlation Matrix**
+- **Area**
+- **Pie / Donut**
+- **Waffle**
+- **Sankey**
+- **Network (Graph)**
+- **Pivot**
+- **Table**
+- **Timeserie**
+- **Treemap**
+- **Sunburst**
+
+## Examples with Sample Data
+
+This repository includes a `data` directory with sample CSV files for each plot type. Here's how you can use them:
+
+### Bubble Chart
+
+```python
+import pandas as pd
+from MatplotLibAPI import fplot_bubble
+
+df = pd.read_csv('data/bubble.csv')
+fig = fplot_bubble(df, label='country', x='gdp_per_capita', y='life_expectancy', z='population')
+fig.show()
+```
+
+### Network Graph
+
+```python
+import pandas as pd
+from MatplotLibAPI import fplot_network
+
+df = pd.read_csv('data/network.csv')
+fig = fplot_network(df)
+fig.show()
+```
+
+### Bar / Stacked Bar
+
+```python
+import pandas as pd
+from MatplotLibAPI import fplot_bar
+
+df = pd.read_csv('data/bar.csv')
+fig = fplot_bar(df, category='product', value='revenue', group='region', stacked=True)
+fig.show()
+```
+
+### Histogram + KDE
+
+```python
+import pandas as pd
+from MatplotLibAPI import fplot_histogram_kde
+
+df = pd.read_csv('data/histogram.csv')
+fig = fplot_histogram_kde(df, column='waiting_time_minutes', bins=8, kde=True)
+fig.show()
+```
+
+### Box / Violin
+
+```python
+import pandas as pd
+from MatplotLibAPI import fplot_box_violin
+
+df = pd.read_csv('data/box_violin.csv')
+fig = fplot_box_violin(df, column='satisfaction_score', category='department', use_violin=True)
+fig.show()
+```
+
+### Heatmap / Correlation Matrix
+
+```python
+import pandas as pd
+from MatplotLibAPI import fplot_heatmap, fplot_correlation_matrix
+
+heatmap_df = pd.read_csv('data/heatmap.csv')
+correlation_df = pd.read_csv('data/correlation.csv')
+
+fig_heatmap = fplot_heatmap(heatmap_df, index='month', columns='channel', values='engagements')
+fig_corr = fplot_correlation_matrix(correlation_df)
+
+fig_heatmap.show()
+fig_corr.show()
+```
+
+### Area
+
+```python
+import pandas as pd
+from MatplotLibAPI import fplot_area
+
+df = pd.read_csv('data/area.csv')
+fig = fplot_area(df, x='quarter', y='subscriptions', label='segment', stacked=True)
+fig.show()
+```
+
+### Pie / Donut
+
+```python
+import pandas as pd
+from MatplotLibAPI import fplot_pie_donut
+
+df = pd.read_csv('data/pie.csv')
+fig = fplot_pie_donut(df, category='device', value='sessions', donut=True)
+fig.show()
+```
+
+### Waffle
+
+```python
+import pandas as pd
+from MatplotLibAPI import fplot_waffle
+
+df = pd.read_csv('data/waffle.csv')
+fig = fplot_waffle(df, category='device', value='sessions')
+fig.show()
+```
+
+### Sankey
+
+```python
+import pandas as pd
+from MatplotLibAPI import fplot_sankey
+
+df = pd.read_csv('data/sankey.csv')
+fig = fplot_sankey(df, source='source', target='target', value='value')
+fig.show()
+```
+
+### Pivot Table
+
+```python
+import pandas as pd
+from MatplotLibAPI.Pivot import plot_pivoted_bars
+
+df = pd.read_csv('data/pivot.csv')
+ax = plot_pivoted_bars(data=df, label="category", x="date", y="value")
+ax.figure.show()
+```
+
+### Table
+
+```python
+import pandas as pd
+from MatplotLibAPI import fplot_table
+
+df = pd.read_csv('data/table.csv')
+fig = fplot_table(pd_df=df, cols=["col1", "col2"])
+fig.show()
+```
+
+### Timeseries Plot
+
+```python
+import pandas as pd
+from MatplotLibAPI import fplot_timeserie
+
+df = pd.read_csv('data/timeserie.csv')
+fig = fplot_timeserie(pd_df=df, label="group", x="date", y="value")
+fig.show()
+```
+
+### Treemap
+
+```python
+import pandas as pd
+from MatplotLibAPI import fplot_treemap
+
+df = pd.read_csv('data/treemap.csv')
+fig = fplot_treemap(pd_df=df, path="path", values="values")
+fig.show()
+```
+
+### Sunburst Chart
+
+```python
+import pandas as pd
+from MatplotLibAPI import fplot_sunburst
+
+df = pd.read_csv('data/sunburst.csv')
+fig = fplot_sunburst(df, labels="labels", parents="parents", values="values")
+fig.show()
+```
+
+### Word Cloud
+
+```python
+import pandas as pd
+from MatplotLibAPI import fplot_wordcloud
+
+df = pd.read_csv('data/wordcloud.csv')
+fig = fplot_wordcloud(df, text_column="word", weight_column="weight")
+fig.show()
+```

matplotlibapi-3.2.15.dist-info/RECORD

@@ -0,0 +1,25 @@
+MatplotLibAPI/Area.py,sha256=cGStEYunusfJdkKOF4199l5LH-ZV-xk8Pe8RAeBaPt8,1931
+MatplotLibAPI/Bar.py,sha256=WY74gXJA3ZIpJD0WaidMo0lrT1lVEbeA0UMGFBY5yiE,2079
+MatplotLibAPI/BoxViolin.py,sha256=XB4cUxUvf8LzwE2twu0gd7vn2NJYjz_mQwVqtyE7dYU,1783
+MatplotLibAPI/Bubble.py,sha256=PiK6Fe77mXRTSSewXkimrNFsMa32pGRXr9jlgZJndXA,12644
+MatplotLibAPI/Composite.py,sha256=k4elPk2mucw5oOH2S2GZV6mbHI9N4Nhpnte4mWLHObg,5902
+MatplotLibAPI/Heatmap.py,sha256=OAF6oBXUksRKGgbN5Mn3EkZxOOZmD4LaJmk4mC01jN8,3053
+MatplotLibAPI/Histogram.py,sha256=0J4uC7xy53TZKjTDWCeEjaELL7E5lQDG0MpeGfaaO6Y,1705
+MatplotLibAPI/Network.py,sha256=erjKzl1Jb6j6Fiy3170xKSeF1LEBe7jPdLB6q8VZclw,30142
+MatplotLibAPI/Pie.py,sha256=TBAnj4mVYy6dKPMwXPjGanTDrLrjHmA5pFvrdXbNw9A,1724
+MatplotLibAPI/Pivot.py,sha256=6qH8e6U1TzUQcAIBmA_KMuHER2Uxp0-GFtwy9eJuS9A,3403
+MatplotLibAPI/Sankey.py,sha256=Q_zmEcER8PGPDro6W4R_SEs17ejfi6D0q-kH6mxkFcI,1187
+MatplotLibAPI/StyleTemplate.py,sha256=Y3sBbUMbfAuxaONW8YixaI0UGgC7b1xnUo0MUMV4Z98,8176
+MatplotLibAPI/Sunburst.py,sha256=ksPV5D40FQcVXQQ1QOHYMc0WMCcjmt9iRrbeH4g85uE,2265
+MatplotLibAPI/Table.py,sha256=EBxXJA6GKjFhWcOMwJ6Wfm-UNw3Ha5KBZ2004TYdkKY,6272
+MatplotLibAPI/Timeserie.py,sha256=s6u68IlugqPMpJk-X5hr-k1WDZyx97Ov7VKQOztXo_U,10028
+MatplotLibAPI/Treemap.py,sha256=a-9Z-ZzXzIV5SDgdJaW7slGELFBBks1pXZnIjcYmarw,4528
+MatplotLibAPI/Waffle.py,sha256=gPREV5v92DQcvjNGuwdKDbAaRSzLBbGF8sWPGUwFyJM,2353
+MatplotLibAPI/Wordcloud.py,sha256=b0vXLRjclSDr28o6LSXqnQenT7duZMmldmfyLrNOVro,9333
+MatplotLibAPI/__init__.py,sha256=StUMlDJehHrO_LMCxmmMX3NpT0Ua_POCZ8GcHHpsQ5Y,2171
+MatplotLibAPI/_visualization_utils.py,sha256=RQBgS-ytPorEOuWqQMHJRwaKOgmZoMW22-sjzxkui2I,1179
+MatplotLibAPI/accessor.py,sha256=I497w2I9vIA9Imc3f00KiW0_a2-VABl_vHgLwRYejPE,50814
+matplotlibapi-3.2.15.dist-info/METADATA,sha256=xkpRcdXfSkx0jwSCVAn-NXu4sYxuu0EXNWyiS5mSf6g,5863
+matplotlibapi-3.2.15.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+matplotlibapi-3.2.15.dist-info/licenses/LICENSE,sha256=hMErKLb6YZR3lRR5zr-vxeFkvY69QAaafgSpZ5-P1dQ,1067
+matplotlibapi-3.2.15.dist-info/RECORD,,

matplotlibapi-3.2.14.dist-info/METADATA

@@ -1,31 +0,0 @@
-Metadata-Version: 2.4
-Name: MatplotLibAPI
-Version: 3.2.14
-License-File: LICENSE
-Requires-Python: >=3.8
-Requires-Dist: kaleido
-Requires-Dist: matplotlib
-Requires-Dist: nbformat
-Requires-Dist: networkx
-Requires-Dist: numpy
-Requires-Dist: pandas
-Requires-Dist: plotly
-Requires-Dist: scikit-learn
-Requires-Dist: seaborn
-Provides-Extra: dev
-Requires-Dist: black; extra == 'dev'
-Requires-Dist: pydocstyle; extra == 'dev'
-Requires-Dist: pyright; extra == 'dev'
-Requires-Dist: pytest; extra == 'dev'
-Requires-Dist: pytest-cov; extra == 'dev'
-Requires-Dist: pytest-pydocstyle; extra == 'dev'
-Description-Content-Type: text/markdown
-
-# MatplotLibAPI
-Simple pandas Dataframe to generate plots:
-Bubble (Scatter plot)
-Network (Graph)
-pivot
-Table
-Timeserie
-Treemap

matplotlibapi-3.2.14.dist-info/RECORD

@@ -1,14 +0,0 @@
-MatplotLibAPI/Bubble.py,sha256=PiK6Fe77mXRTSSewXkimrNFsMa32pGRXr9jlgZJndXA,12644
-MatplotLibAPI/Composite.py,sha256=k4elPk2mucw5oOH2S2GZV6mbHI9N4Nhpnte4mWLHObg,5902
-MatplotLibAPI/Network.py,sha256=LP2hjwbOSua0heLKdOC0xbtP-MrMpeA6B5E2cDb76g8,28065
-MatplotLibAPI/Pivot.py,sha256=6qH8e6U1TzUQcAIBmA_KMuHER2Uxp0-GFtwy9eJuS9A,3403
-MatplotLibAPI/StyleTemplate.py,sha256=dYvR1tUw_FxBYvjbeuVjgkyzH0brF7BVqi4JIIbTW_I,7913
-MatplotLibAPI/Table.py,sha256=EBxXJA6GKjFhWcOMwJ6Wfm-UNw3Ha5KBZ2004TYdkKY,6272
-MatplotLibAPI/Timeserie.py,sha256=s6u68IlugqPMpJk-X5hr-k1WDZyx97Ov7VKQOztXo_U,10028
-MatplotLibAPI/Treemap.py,sha256=a-9Z-ZzXzIV5SDgdJaW7slGELFBBks1pXZnIjcYmarw,4528
-MatplotLibAPI/Wordcloud.py,sha256=b0vXLRjclSDr28o6LSXqnQenT7duZMmldmfyLrNOVro,9333
-MatplotLibAPI/__init__.py,sha256=PgaF4xCVBiFsCWCFgmn_8D23IO3DpXJpNS4kGnh5eNM,27194
-matplotlibapi-3.2.14.dist-info/METADATA,sha256=umSpirrDBJ3f_MDYFxND7UxfCK5UUjsORMjGU-NiD5E,750
-matplotlibapi-3.2.14.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-matplotlibapi-3.2.14.dist-info/licenses/LICENSE,sha256=hMErKLb6YZR3lRR5zr-vxeFkvY69QAaafgSpZ5-P1dQ,1067
-matplotlibapi-3.2.14.dist-info/RECORD,,