eyepiece
Plotting and animation primitives for astronomical imaging simulations.
What eyepiece is
eyepiece provides ax-first, stateless figure functions for the plots that
recur across direct-imaging work: log-scaled and diverging image displays,
complex-field panels, corner plots, orbit and sky-track scenes, optical-train
schematics, and a multi-sink animation recorder that grabs frames once and
writes them to any combination of gif, mp4, and html. Every primitive takes
plain arrays in and returns a small result object holding the axes and the
artists it drew, so callers can update or extend a figure without re-deriving
which line or image object came from where.
Figure style (color, colormaps, and mode) is resolved through
hwostyle at call
time, not at import time. import eyepiece never activates a style or
touches matplotlib's rcParams. Without an active hwostyle mode, primitives
fall back to a fixed light-mode palette, so eyepiece also works as a
standalone plotting library.
What eyepiece is not
- Not a simulation library. eyepiece takes arrays and returns figures; it never imports a simulation, orbit, or optics package.
- Not a style engine. Color, colormap, and mode definitions live in hwostyle; eyepiece only reads them at call time.
- Not a data pipeline. Aggregating or transforming simulation output before plotting is the caller's job.
Status
eyepiece is in early development. The package currently exposes only its version; the plotting and animation API is under active construction.
Installation
pip install eyepiece
Unit conversions used by a small number of layout helpers (arcsecond and AU extents) are optional and pull in hwoutils:
pip install eyepiece[hwo]
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file eyepiece-0.0.1.tar.gz.
File metadata
- Download URL: eyepiece-0.0.1.tar.gz
- Upload date:
- Size: 32.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
75c00a02c0c3ad6cd2af1cc651a1d3378f53f1edf644affa12b3fe3515e40c0a
|
|
| MD5 |
50b5540a255490e86a6b150e60c5586f
|
|
| BLAKE2b-256 |
a2c34b9d230d5e72873df977acd6d229995da1f3483c1260a6036a6b3301b34b
|
Provenance
The following attestation bundles were made for eyepiece-0.0.1.tar.gz:
Publisher:
publish-to-pypi.yml on CoreySpohn/eyepiece
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
eyepiece-0.0.1.tar.gz -
Subject digest:
75c00a02c0c3ad6cd2af1cc651a1d3378f53f1edf644affa12b3fe3515e40c0a - Sigstore transparency entry: 2426967825
- Sigstore integration time:
-
Permalink:
CoreySpohn/eyepiece@31148ea95ee2d414d9a7c6efb851f10eabf03f93 -
Branch / Tag:
refs/tags/v0.0.1 - Owner: https://github.com/CoreySpohn
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-to-pypi.yml@31148ea95ee2d414d9a7c6efb851f10eabf03f93 -
Trigger Event:
push
-
Statement type:
File details
Details for the file eyepiece-0.0.1-py3-none-any.whl.
File metadata
- Download URL: eyepiece-0.0.1-py3-none-any.whl
- Upload date:
- Size: 32.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
65e25caeb20d336cc0ec318d5a965669ea83b0930e507480a9e7ac4157060967
|
|
| MD5 |
496589f1d5257663d405198b7f3294e4
|
|
| BLAKE2b-256 |
09f6309550652a5e98e5b48406bac64002fda1152dff893f29a1c4554a0986f6
|
Provenance
The following attestation bundles were made for eyepiece-0.0.1-py3-none-any.whl:
Publisher:
publish-to-pypi.yml on CoreySpohn/eyepiece
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
eyepiece-0.0.1-py3-none-any.whl -
Subject digest:
65e25caeb20d336cc0ec318d5a965669ea83b0930e507480a9e7ac4157060967 - Sigstore transparency entry: 2426968268
- Sigstore integration time:
-
Permalink:
CoreySpohn/eyepiece@31148ea95ee2d414d9a7c6efb851f10eabf03f93 -
Branch / Tag:
refs/tags/v0.0.1 - Owner: https://github.com/CoreySpohn
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-to-pypi.yml@31148ea95ee2d414d9a7c6efb851f10eabf03f93 -
Trigger Event:
push
-
Statement type:
