https://github.com/infinitode/pyautoplot
PyAutoPlot is an open-source Python library designed to make dataset analysis much easier by generating helpful detailed plots using matplotlib. It automatically generates appropriate plots based on the dataset you feed it.
https://github.com/infinitode/pyautoplot
analysis automatic csv data dataset dataset-analysis generation matplotlib pandas plots plotting-in-python plotting-library python
Last synced: 2 months ago
JSON representation
PyAutoPlot is an open-source Python library designed to make dataset analysis much easier by generating helpful detailed plots using matplotlib. It automatically generates appropriate plots based on the dataset you feed it.
- Host: GitHub
- URL: https://github.com/infinitode/pyautoplot
- Owner: Infinitode
- License: other
- Created: 2025-01-19T10:14:29.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-01-19T10:39:18.000Z (4 months ago)
- Last Synced: 2025-02-22T16:22:38.016Z (3 months ago)
- Topics: analysis, automatic, csv, data, dataset, dataset-analysis, generation, matplotlib, pandas, plots, plotting-in-python, plotting-library, python
- Language: Python
- Homepage: https://infinitode.netlify.app
- Size: 242 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# PyAutoPlot
[](https://github.com/infinitode/pyautoplot)
PyAutoPlot is an open-source Python library designed to make dataset analysis much easier by generating helpful detailed plots using `matplotlib`. It automatically generates appropriate plots based on the dataset you feed it.
### Changes in version 1.0.1:
- Added package dependencies to PyAutoPlot: `matplotlib>=3.0.0`, `pandas>=1.0.0`, and `numpy>=1.18.0`.
### Changes in version 1.0.0:
- `AutoPlot` class, along with `auto_plot` and `plot` functions. `auto_plot` automatically generates suitable plots based on values in your dataset.
> [!IMPORTANT]
> The `AutoPlot` object needs to be initialized with a **CSV dataset** before any plots can be generated using either `plot` or `auto_plot`.
## Installation
You can install PyAutoPlot using pip:
```bash
pip install pyautoplot
```
## Supported Python Versions
PyAutoPlot supports the following Python versions:
- Python 3.6
- Python 3.7
- Python 3.8
- Python 3.9
- Python 3.10
- Python 3.11/Later (Preferred)
Please ensure that you have one of these Python versions installed before using PyAutoPlot. PyAutoPlot may not work as expected on lower versions of Python than the supported.
## Features
- **Automatic Plotting**: PyAutoPlot automatically generates appropriate plots based on values present in your dataset. Currently, PyAutoPlot supports the following types of data: `numeric`, `categorical`, and `time-series`.
- **Customization**: Due to matplotlib's high customizability, you can create and use custom themes for PyAutoPlot, just pass in your theme as a dictionary of RCParams (See `plot.rcParams.keys()` for a list of valid parameters) or choose from our predefined themes. You can also pass in additional parameters to the function that `matplotlib` can recognize (e.g. `color='#5d17eb'`).
## Usage
### AutoPlot
```python
from pyautoplot import AutoPlot
# Initialize with a CSV file
plotter = AutoPlot("path/to/dataset.csv")
# Automatically analyze and plot
plotter.auto_plot(output_file='test', theme="dark", color='orange', excludes=['detailed_analysis'])
```
> [!NOTE]
> PyAutoPlot may not work well with certain datasets. If you find any issues please open an issue.
### Customization
```python
from pyautoplot import AutoPlot
# Define your custom theme
custom_theme = {
"axes.facecolor": "#ffffff",
"axes.edgecolor": "#000000",
"axes.labelcolor": "#000000",
"figure.facecolor": "#ffffff",
"grid.color": "#dddddd",
"text.color": "#000000",
"xtick.color": "#000000",
"ytick.color": "#000000",
"legend.frameon": True,
}
# Initialize with a CSV file
plotter = AutoPlot("path/to/dataset.csv")
# Automatically analyze and plot using the custom theme
plotter.auto_plot(output_file='test', theme=custom_theme, color='orange', excludes=['detailed_analysis'])
```
## Contributing
Contributions are welcome! If you encounter any issues, have suggestions, or want to contribute to PyAutoPlot, please open an issue or submit a pull request on [GitHub](https://github.com/infinitode/pyautoplot).
## License
PyAutoPlot is released under the terms of the **MIT License (Modified)**. Please see the [LICENSE](https://github.com/infinitode/pyautoplot/blob/main/LICENSE) file for the full text.
**Modified License Clause**
The modified license clause grants users the permission to make derivative works based on the PyAutoPlot software. However, it requires any substantial changes to the software to be clearly distinguished from the original work and distributed under a different name.