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.
Demo and Usage
For the installation, conda-forge and PyPI are available.
conda install conda-forge::plotastrodata
or
pip install plotastrodata
The following is the way to install plotastrodata manually. The file example.py will help you find out how to use this package.
git clone https://github.com/yusukeaso-astron/plotastrodata
cd plotastrodata
python example.py
To keep the package updated, always type the command below in the directory plotastrodata before you use it.
git pull
Also, setting the path in .bashrc (or .zshrc, etc.) will be useful.
export PYTHONPATH=${PYTHONPATH}:/YOUR_PATH_TO/plotastrodata
Or directly in your script,
import sys
sys.path.append( "/YOUR_PATH_TO/plotastrodata" )
Features
plotastrodata can do the following things.
- Make 3D channel maps, 3D rotatable html cube, or 2D images including position-velocity diagrams.
- Color scale can be linear, log, and asinh.
- Make a figure of line profiles with Gaussian fitting.
- Plot images to externally given fig and ax (2D images only).
- Combine color, contour, segment, and RGB maps using images with different spatial grids.
- Input fits files or 2D/3D numpy arrays.
- Select the R.A.-Dec. style or the offset style as the x/y tick labels.
- Fill channel maps with a 2D image.
- Add line, arrow, ellipse, rectangle, text, and marker in specified channels.
- Use original arguments of matplotlib (pcolormesh, contour, quiver, plot, text, Ellipse, Rectangle).
- Other functions for plotting line profiles and a spatial 1D slice.
- example_advanced.py includes how to make a movie of channel maps.
- There are other utilities for Fourier transform and fitting.
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)
Installation
Download from https://github.com/yusukeaso-astron/plotastrodata or git clone.
git clone https://github.com/yusukeaso-astron/plotastrodata
Note
- For 3D data, a 1D velocity array or a FITS file with a velocity axis must be given to set up channels on each page.
- For 2D/3D data, the spatial center can be read from a FITS file or manually given.
- len(v)=1 (default) means to make a 2D figure.
- Spatial lengths are in the unit of arcsec, or au if dist (!= 1) is given.
- Angles are in the unit of degree.
- For region, line, arrow, label, and marker, a single input can be treated without a list, e.g., anglelist=60, as well as anglelist=[60].
- Each element of poslist supposes a text coordinate like '01h23m45.6s 01d23m45.6s' or a list of relative x and y like [0.2, 0.3] (0 is left or bottom, 1 is right or top).
- Parameters for original methods in matplotlib.axes.Axes can be used as kwargs; see the default kwargs0 for reference.
- Position-velocity diagrams (pv=True) do not yet support region, line, arrow, and segment because the units of abscissa and ordinate are different.
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.10.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| plotastrodata-1.10.1.tar.gz | 72.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| plotastrodata-1.10.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 147.5 kB
Release files / plotastrodata-1.10.1.tar.gz
| Download URL | plotastrodata-1.10.1.tar.gz |
|---|---|
| Size | 72.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bb339c51948c189edc905f353aa6cf2be62b1e6a6e974cc224d4cf37d7df05a8
|
|
BLAKE2b-256 checksum How to use checksums |
82c052157b5647c2b54adf7e360cae6727c67693286e8d9e994701ced096533d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.3
|
Release files / plotastrodata-1.10.1-py3-none-any.whl
| Download URL | plotastrodata-1.10.1-py3-none-any.whl |
|---|---|
| Size | 75.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b524ea95afe05a9b7943cc28efce706042782a1218d0de154497909afe6ddf1a
|
|
BLAKE2b-256 checksum How to use checksums |
4dea03005f951596f3b32e873183e8ea081560c5ab8c817afda9fd52c2baa004
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.3
|
