Skip to main content

pyillustrator

pyillustrator is a modular Python package designed for creating beautiful and configurable matplotlib subplot grids — perfect for creating aligned and aesthetic scientific figures, especially for publications.


Features

  • Golden, square, equal or custom aspect ratios
  • Fine control over subplot spacing, margins, and grid layout
  • Double-axis plotting with horizontal or vertical pairs
  • Centralized configuration system
  • LaTeX-friendly and publication-ready styling

Installation

To install it from the repository you can install it

git clone https://github.com/yourusername/pyillustrator.git
cd pyillustrator
pip install .

PyPi installation is also available:

pip install pyillustrator

Project Structure

pyillustrator/
├── __init__.py 
├── source/
│   ├── __init__.py         # Module exports
│   ├── plots.py            # Core plotting functions
│   ├── config.py           # Default settings and aspect ratio constants
│   └── utils.py            # Axes formatting and layout utilities

Usage

Basic grid plot

from pyillustrator import grid_plot
import matplotlib.pyplot as plt

fig, axs = grid_plot(2, 2)
axs[0,0].plot([0,1], [0,1])
plt.show()

Double grid (e.g., for comparison)

from pyillustrator import grid_plot_double
import matplotlib.pyplot as plt

fig, axs = grid_plot_double(1, 2, pair='Horizontal')
axs[0,0,0].plot(...)  # Left half
axs[0,0,1].plot(...)  # Right half
plt.show()

Custom configuration

from pyillustrator import DEFAULT_CONFIG, grid_plot
import matplotlib.pyplot as plt

config = DEFAULT_CONFIG.copy()
config["figwidth"] = 20
config["aspect"] = "Equal"
config["style"] = "seaborn"

fig, axs = grid_plot(2, 2, config)
plt.show()

License

This project is licensed under the MIT License. See the LICENSE file for details.


Metadata

Release files for pyillustrator 0.9.6

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

Source distribution (sdist)

Source distribution for pyillustrator 0.9.6
File Size Uploaded Provenance Actions
pyillustrator-0.9.6.tar.gz 6.6 kB Without provenance Details for pyillustrator-0.9.6.tar.gz

Built distribution (wheel)

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

Total release size: 13.4 kB

Release files / pyillustrator-0.9.6.tar.gz

Download URL pyillustrator-0.9.6.tar.gz
Size 6.6 kB
Tags Source
SHA-256 checksum
How to use checksums
393b525ebd536bdb90acb4457c58c957ef40021f43163b14b9641fcbc3fa3749
BLAKE2b-256 checksum
How to use checksums
4aafbc46e18b5457e28d24b2c47706642a75164b34622546fa89eec283c840d5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.10.12

Release files / pyillustrator-0.9.6-py3-none-any.whl

Download URL pyillustrator-0.9.6-py3-none-any.whl
Size 6.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
02f849762020fd76bd6a251772e3a66e37735ff4e07f948dd4799a93312e541a
BLAKE2b-256 checksum
How to use checksums
af35eb03fc2f2b044fcacefd39f1af0793b03d6f202702c80e64894ca0e39bba
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.10.12

Security for pyillustrator 0.9.6

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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