KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #typescript #codex #claude-code #mcp #rust #deepseek-harness #ai-agent #cli

SWMat

★ 13 Open GitHub ↗

Storytelling With Matplotlib (SWMat)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

```
Help Needed (in .text function):
Right now text function just adds height of text (a constant a calculated manually) based on fontsize for next line sub-text.
It doesn't work as expected many times. So, I want to change it in a matplolib way to calculate new line y value.
```

# SWMat - Storytelling With Matplotlib

## (Make stunning graphs/charts using matplotlib in just a few lines of code)

![SWMat](https://raw.githubusercontent.com/PuneetGrov3r/SWMat/master/images/swm.png)

---

## Example plots made with this library

## Index

1. [Installation](#1-installation)
 2. [Import](#2-import)
 3. [Usage](#3-usage)
    * 3.1 [Initialize Class](#31-initialize-class)
    * 3.2 [Main features of Package](#32-main-features-of-package)
    * 3.3 [Other Functions](#33-other-functions)
        * [Line Plot](#331-line-plot)
        * [Hist Plot](#332-hist-plot)
        * [Bar Plot](#333-bar-plot)
        * [Violin Plot (Dist Plot)](#334-violin-plot)
        * [Text](#335-text)
 4. [References](#4-references)

## 1) Installation

Using Pip:

```python
pip install SWMat
```

Download from pypi: [SWMat.tar.gz](https://pypi.org/project/SWMat/#files)

## 2) Import

```python
from SWMat.SWMat import SWMat  # Will change it soon...
```

## 3) Usage

### 3.1 Initialize class

You can initialize `SWMat` class in two ways:

* Either you can only pass `matplotlib.pyplot` directly,

```python
import matplotlib.pyplot as plt
swm = SWMat(plt) # Will take current Axes
```

* Or you can pass `Axes` with `matplotlib.pyplot` to beautify given `Axes`.

```python
import matplotlib.pyplot as plt
fig, axs = plt.subplots(3, 4)
swm = SWMat(plt, ax=axs[0][1])
```

### 3.2 Main features of package

There are 'two' main differentiating features of this package:

* Base beautifications are done without much hassle,

```python
swm = SWMat(plt) # And... The Base beautifications will be added.
plt.scatter(x, y)
```

![Base](https://raw.githubusercontent.com/PuneetGrov3r/SWMat/master/images/base.png)

* You can easily plot text on your plot using `SWMat.text`,

```python
swm = SWMat(plt) # This function will initialize your plot
plt.scatter(x, y)
swm.text(some_text);  # That's all!! Don't worry there's much more you can do with it.
```

![text1](https://raw.githubusercontent.com/PuneetGrov3r/SWMat/master/images/text1.png)

* And there is a `highlight` parameter available with every function in `SWMat`, to help you highlight some part of plot for that particular plot type.

### 3.3 Other Functions

#### 3.3.1 Line Plot

Main parameters to look for here are: `line_labels` (Label for each line plot) and `highlight` (int or list of lines to highlight).

```python
swm = SWMat(plt)
swm.line_plot(xs, ys, line_labels=["A", "B"], highlight=0, lw=3);
```

![lineplot](https://raw.githubusercontent.com/PuneetGrov3r/SWMat/master/images/lineplot.png)

#### 3.3.2 Hist Plot

Main parameters to look for here are: `highlight` (int orlist of index of bins to highlight).

```python
swm = SWMat(plt)
swm.hist(data, highlight=3, bins=bins);
```

![hist](https://raw.githubusercontent.com/PuneetGrov3r/SWMat/master/images/hist.png)

```python
swm = SWMat(plt)
swm.hist(data, highlight=3, bins=bins, hide_y=True);
```

![hist2](https://raw.githubusercontent.com/PuneetGrov3r/SWMat/master/images/hist2.png)

#### 3.3.3 Bar Plot

Main parameters to look for here are: `plot_type` (horizontal, vertical etc), `cat_labels` (labels for categories in each data vector), `data_labels` (labels for each data vector) and `highlight` (dictionary taking int or list of ints for highlighting particular data bars or given category bars).

```python
swm = SWMat(plt)
swm.bar(cats, heights, data_labels=["A", "B", "C", "D"], cat_labels=["One", "Two", "Three"], highlight={"data":1});
```

![bar](https://raw.githubusercontent.com/PuneetGrov3r/SWMat/master/images/bar.png)

```python
swm = SWMat(plt)
swm.bar(cats, heights, data_labels=["Alpha", "Beta"],  highlight={"data":1, "cat":1},
    cat_labels=["One", "Two", "Three"], plot_type="stacked100%");
```

![bar2](https://raw.githubusercontent.com/PuneetGrov3r/SWMat/master/images/bar2.png)

#### 3.3.4 Violin Plot (Dist PLot)

Main parameters to look for here are: `show` (where violin\dist plot(s) should be shown), `highlight` (dictionary taking list of tuples of starting and ending points inbetween which to highlight, with keys as index of violin plot. Actually you can plot many violin plots simultaneously.)

```python
swm = SWMat(plt)
swm.violinplot(data, show="top", highlight={"0":[(0.7, 2.3), (4.7, 6)]})
```

![violin](https://raw.githubusercontent.com/PuneetGrov3r/SWMat/master/images/violin.png)

#### 3.3.5 Text

Main feature of text function of SWMat is that you can type in paragraphs of text without using matplotlib's plot function again and again, and that too while using HTML like attribute specification using `prop` tag. So you can configure your text as:

```python
text = "Lorem <prop fontsize='20', color='#FF7700'>ipsum dolor</prop> sit amet." # All attribute's values needs to be inside quotes (As "value" or 'value').
```

`prop` tag can take all attributes of  `fontdict` available in matplotlib.

## 4) References

1. Knaflic, Cole. Storytelling With Data: A Data Visualization Guide for Business Professionals, Wiley, © 2015
  2. Matplotlib Library Docs

SWMat

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README