plotastrodata
Python package to make figures from radio astronomical data by astropy and matplotlib. The API, examples, and gallery are available in readthedocs. The PDF manual is available here.
Highlights
- Read, write, and process astronomical FITS images, spectral cubes, position-velocity diagrams, and NumPy arrays, including WCS coordinates, spectral axes, beam information, and brightness-temperature conversion.
- Create 2D maps, channel maps, position-velocity diagrams, RGB composites, line profiles, spatial slices, and interactive 3D isosurface visualizations.
- Overlay color, contour, polarization-vector, and RGB data from different spatial grids, with astronomical coordinates, beams, scale bars, regions, markers, and other annotations.
- Prepare data through trimming, interpolation, binning, masking, centering, rotation, deprojection, beam circularization, and profile extraction.
- Estimate image noise, including support for primary-beam-corrected data.
- Fit Gaussian models to line profiles and two-dimensional image components.
- Use supporting tools for coordinate and line-of-sight transformations, centered Fourier transforms and visibility sampling, and Bayesian or grid-based parameter estimation.
Installation
Released version
Install from conda-forge:
conda install conda-forge::plotastrodata
or from PyPI:
pip install plotastrodata
Development version from GitHub
Clone the repository to install the latest development version, which may include changes not yet available in the published releases:
git clone https://github.com/yusukeaso-astron/plotastrodata
(cd plotastrodata)
(python -m pip install .)
To update the development version, run the following commands in the cloned repository:
git pull
(python -m pip install --upgrade .)
Demo and Usage
The repository includes example.py, which demonstrates the main plotting and analysis features. After cloning the repository and installing the package, run:
python example.py
More examples and the complete API reference are available in the online documentation.
Generate plotting scripts
from plotastrodata.script_utils import generate_image_script
script = generate_image_script(
"image.fits", output="image.py",
)
Review the inline values, then run python image.py. The script uses existing
library APIs to visualize a hist-pbcor noise fit, fit a 2D Gaussian and report
its sky center and east/north uncertainties, and plot a logarithmic image
with contours, a beam, and RA/Dec axes. It saves separate noise and image PNGs.
Noise estimation uses the full image. Fitting and plotting ranges are estimated automatically and written inline
with three significant digits for editing.
For a spectral cube, use generate_cube_script("cube.fits", output="cube.py")
from the same module. It generates an edge-channel noise visualization, a flux-integrated line
profile and 3D channel maps over estimated spatial and velocity ranges,
with intrinsic channel spacing. The flux profile assumes Jy/beam data with beam metadata.
Noise and range estimation in both generators assume PB-corrected intensities.
Both generators return an absolute pathlib.Path and write the script
without executing it.
See the script-generation guide.
Ranges can also be obtained from loaded data with
rmax, vmin, vmax = d.estimate_ranges(pbcor=True) for PB-corrected data.
For uniform-noise data, use d.estimate_ranges(). Noise is fitted when
d.sigma=None; a supplied positive scalar assumes a zero baseline unless
pbcor=True. For PB-corrected data, supplied sigma describes noise before
PB correction. The array-based function is noise_utils.estimate_ranges,
with the same pbcor option and optional sigma. Here, rmax is a symmetric
spatial half-width; 2D images return None for both velocity limits.
Requirement
- Python >= 3.11
- astropy >= 7.2
- corner (only for fitting)
- dynesty (only for fitting)
- emcee >= 3.1.5 (only for fitting)
- ffmpeg (only for movie)
- matplotlib
- numpy >= 2.0
- pillow (only for RGB figures)
- plotly (only for html cube)
- ptemcee (only for fitting)
- pydantic >= 2
- scikit-image (only for html cube)
- scipy
- tqdm (only for fitting)
Conventions and Limitations
See Conventions and usage notes for data formats, coordinate and angle conventions, runtime types, input validation, and usage limitations.
Author
- Name: Yusuke Aso
- Affiliation: Korea Astronomy and Space Science Institute
- E-mail: yaso@kasi.re.kr
License
"plotastrodata" is under GNU General Public License Version 3.
1 maintainer
Metadata
1 maintainer
Release files for plotastrodata 1.12.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| plotastrodata-1.12.2.tar.gz | 111.0 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| plotastrodata-1.12.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 228.4 kB
Release files / plotastrodata-1.12.2.tar.gz
| Download URL | plotastrodata-1.12.2.tar.gz |
|---|---|
| Size | 111.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
709ee12dbb620524b1eb07fb363302948ff71ee518c94169c35650dab306336c
|
|
BLAKE2b-256 checksum How to use checksums |
54c31dfad806e605d5d7b9144ec7548b79995b18e0518a99f1f8aeb8eb8bf789
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.8
|
Release files / plotastrodata-1.12.2-py3-none-any.whl
| Download URL | plotastrodata-1.12.2-py3-none-any.whl |
|---|---|
| Size | 117.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
dd15d860f982f804fc6770651c8a20461f7fac44f586c9dbd64bca322894211e
|
|
BLAKE2b-256 checksum How to use checksums |
4f74c9112c6e28ee1ed93f276362cfddde55b9551f61ffeb4b3bda05fbe6dc4e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.8
|
Security for plotastrodata 1.12.2
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.
