Skip to main content

PyAutoPlot

Python Version Code Size Downloads License Compliance PyPI Version PyPI provenance

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.1.1:

  • Fixed date detection and reports for sparse or mixed-format timestamps. Time plots use sorted timestamps as the x-axis for numeric measurements.
  • Fixed analysis and plotting for empty columns and header-only CSVs, and made JSON exports handle non-finite numbers.
  • Fixed partial themes and dpi/bins handling. Plots and reports no longer close figures they didn't create, and show=False supports file-only plotting.
  • Added regression tests and prepared releases for PyPI Trusted Publishing with per-file attestations. The provenance badge links to the latest release's provenance status on PyPI.

Changes in version 1.1.0:

  1. New Visualizations: Added Correlation Heatmaps and Violin Plots.
  2. Data Cleanup: New cleanup() method allows filling or dropping missing values with multiple strategies.
  3. Advanced Reporting:
    • export_json(): Saves all stats and metadata to JSON.
    • export_report(): Generates professional HTML (self-contained) or PDF reports.
  4. Improved Intelligence: Automatically detects and parses date strings into datetime objects.
  5. Optimizations: Better memory management and resource warnings for large datasets.

Changes in version 1.0.2:

Bug Fixes and Robustness:

  • Corrected calculation of missing values in _generate_analysis.
  • Added error handling for statistical functions (skewness, kurtosis, autocorrelation) to prevent crashes with empty or zero-variance data, returning NaN instead.
  • Added warnings for columns not classified by _detect_column_types.
  • Included input validation in the plot() method to check for valid column names and required arguments, raising ValueErrors for invalid input.

Performance Enhancements:

  • Modified auto_plot() to display and close plot figures section by section (or individually for looped plots like pie/line charts). This significantly reduces memory consumption when generating many plots.
  • Added a warning in the auto_plot() docstring regarding potential performance issues of pairwise scatter plots with many numeric columns.

Code Cleanup:

  • Refined static method definitions (_calculate_skewness, _calculate_kurtosis, etc.) by removing unnecessary self arguments and ensuring calls are updated.

Testing:

  • Replaced the existing test.py with a new script that:
    • Creates a test_output directory for plot outputs.
    • Uses energy_consumption_dataset.csv (with a dummy fallback).
    • Demonstrates AutoPlot initialization.
    • Runs auto_plot() with default and custom configurations.
    • Runs manual plot() for scatter, distribution, boxplot, and bar types.
    • Shows usage of the customize() method.
    • Includes a test with a small, inline dataset.
    • Saves all generated plots for visual inspection.

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.

Installation

You can install PyAutoPlot using pip:

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

from pyautoplot import AutoPlot

# Initialize with a CSV file
plotter = AutoPlot("path/to/dataset.csv")

# Save charts without opening plot windows
plotter.auto_plot(
    output_file="charts.png", theme="dark", color="orange",
    excludes=["pairwise_scatter"], show=False, dpi=150, bins=20,
)

Date-like text columns are converted only if all their non-missing values parse. Offset-aware timestamps are normalized to UTC. When numeric measurements are present, line charts use the sorted timestamps as the x-axis; the area chart uses the first plottable date column and switches to an unstacked chart if a series has both positive and negative values.

Customization

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.

License

PyAutoPlot is released under the terms of the MIT License (Modified). Please see the 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.

Metadata

Release files for pyautoplot 1.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyautoplot 1.1.1
File Size Uploaded Provenance Actions
pyautoplot-1.1.1.tar.gz 20.3 kB With provenance Details for pyautoplot-1.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pyautoplot 1.1.1
File Interpreter ABI Platform Actions
pyautoplot-1.1.1-py3-none-any.whl Python 3 none any Details for pyautoplot-1.1.1-py3-none-any.whl

Total release size: 34.8 kB

Release files / pyautoplot-1.1.1.tar.gz

Download URL pyautoplot-1.1.1.tar.gz
Size 20.3 kB
Tags Source
SHA-256 checksum
How to use checksums
137778a0c31ac2336ff990aad925938244b9ceea6902511409c74fac49bd488a
BLAKE2b-256 checksum
How to use checksums
17803c09980276c72e6bb91eff858378e58b0d2a107390349ad952c42b20524c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / pyautoplot-1.1.1-py3-none-any.whl

Download URL pyautoplot-1.1.1-py3-none-any.whl
Size 14.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1b7752d77b56616f4c0d93899c70c377a4e919e68671367a297c6c5def8e8aff
BLAKE2b-256 checksum
How to use checksums
af6974dcd2ba182360af08dd258f8cc865f9ee5916b0f6b1dc3095021c9100ce
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Security for pyautoplot 1.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for pyautoplot-1.1.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page