Metadata-Version: 2.4
Name: sonoviz
Version: 0.1.0
Summary: Simple music-data visualization built on matplotlib.
Author: Jagriti
License: MIT
License-File: LICENSE
Requires-Python: >=3.8
Requires-Dist: matplotlib
Requires-Dist: pandas
Description-Content-Type: text/markdown

# sonoviz

Simple music-data visualization built on [matplotlib](https://matplotlib.org/).
Two plain functions, one clean sage-green aesthetic.

## Install

```bash
pip install sonoviz
```

## Usage

```python
import pandas as pd
import sonoviz as viz

df = pd.DataFrame({
    "energy":       [0.42, 0.55, 0.68, 0.74, 0.81],
    "danceability": [0.51, 0.60, 0.66, 0.73, 0.80],
    "year":         [2004, 2009, 2014, 2019, 2023],
    "popularity":   [30, 52, 66, 80, 91],
})

# Relationship between two audio features
viz.scatter(df, x="energy", y="danceability")

# Change over time
viz.lines(df, x="year", y="popularity")

# Optional descriptive title + subtitle
viz.scatter(df, x="energy", y="danceability",
            title="Higher-energy tracks tend to be more danceable",
            subtitle="Each point is one track (audio features 0-1).")
```

## License

MIT
