Data

Tools

Indexes

Applications

Experiments

Open Source Science

pyradiosky

pyradiosky: A Python package for Radio Sky Models - Published in JOSS (2024)

https://github.com/radioastronomysoftwaregroup/pyradiosky

Science Score: 95.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ○
    CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ✓
    DOI references
    Found 9 DOI reference(s) in README and JOSS metadata
  • ✓
    Academic publication links
    Links to: joss.theoj.org, zenodo.org
  • ✓
    Committers with academic emails
    6 of 14 committers (42.9%) from academic institutions
  • ○
    Institutional organization owner
  • ✓
    JOSS paper metadata
    Published in Journal of Open Source Software

Keywords from Contributors

astronomy interferometry radio-astronomy exoplanet

Scientific Fields

Mathematics Computer Science - 84% confidence
Last synced: 6 months ago · JSON representation

Repository

Python objects and interfaces for representing diffuse, extended and compact astrophysical radio sources

Basic Info
Statistics
  • Stars: 14
  • Watchers: 8
  • Forks: 6
  • Open Issues: 20
  • Releases: 12
Created over 6 years ago · Last pushed 6 months ago
Metadata Files
Readme Changelog Contributing License Code of conduct

README.md

pyradiosky

codecov DOI DOI

Python objects and interfaces for representing diffuse, extended and compact astrophysical radio sources.

The primary user class is SkyModel, which supports:

  • catalogs of point sources (read/write to hd5 and text files, read VOTables)
  • diffuse models as HEALPix maps (read/write to hd5 files)
  • conversion between any astropy supported coordinates (e.g. J2000 RA/Dec) and Azimuth/Elevation including calculating full polarization coherencies in Az/El.

File formats

pyradiosky supports reading in catalogs from several formats, including VO Table files, text files, FHD catalog files and SkyH5 files and supports writing to SkyH5 and text files. SkyH5 is an HDF5-based file format defined by the pyradiosky team, a full description is in the SkyH5 memo.

Community Guidelines

Contributions to this package to add new file formats or address any of the issues in the issue log are very welcome, as are bug reports and feature requests. Please see our guide on contributing

Versioning

We use a generation.major.minor version number format. We use the generation number for very significant improvements or major rewrites, the major number to indicate substantial package changes and the minor number to release smaller incremental updates (which do not include breaking API changes). We do our best to provide a significant period (usually 2 major generations) of deprecation warnings for all breaking changes to the API. We track all changes in our changelog.

Documentation

Developer API documentation is hosted here.

Citation

Please cite pyradiosky by citing our JOSS paper:

Hazelton et al., (2024). pyradiosky: A Python package for Radio Sky Models. Journal of Open Source Software, 9(97), 6503, https://doi.org/10.21105/joss.06503

ADS Link

Installation

Simple installation via pip is available for users, developers should follow the directions under Developer Installation below.

For simple installation, the latest stable version is available via pip with pip install pyradiosky.

There are some optional dependencies that are required for specific functionality, which will not be installed automatically by pip. See Dependencies for details on installing optional dependencies.

Dependencies

If you are using conda to manage your environment, you may wish to install the following packages before installing pyradiosky:

Required:

  • astropy>=6.0
  • h5py>=3.7
  • numpy>=1.23
  • scipy>=1.9
  • python>=3.11
  • pyuvdata>=3.2.3
  • setuptools_scm>=8.1

Optional:

  • astropy-healpix>=1.0.2 (for working with beams in HEALPix formats)
  • astroquery>=0.4.4 (for downloading GLEAM and other VizieR catalogs)
  • lunarsky>=0.2.5 (for supporting telescope locations on the moon)

We suggest using conda to install all the dependencies. To install pyuvdata, astropy-healpix and astroquery, you'll need to add conda-forge as a channel (conda config --add channels conda-forge).

If you do not want to use conda, the packages are also available on PyPI. You can install the optional dependencies via pip by specifying an option when you install pyradiosky, as in pip install .[healpix] which will install all the required packages for using the HEALPix functionality in pyradiosky. The options that can be passed in this way are: [healpix, astroquery, lunarsky, all, doc, test, dev]. The first three (healpix, astroquery, lunarsky) enable various specific functionality while all will install all optional dependencies. The last three (doc, test and dev) may be useful for developers of pyradiosky.

Developer Installation

Clone the repository using git clone https://github.com/RadioAstronomySoftwareGroup/pyradiosky.git

Navigate into the pyradiosky directory and run pip install . (note that python setup.py install does not work). Note that this will attempt to automatically install any missing dependencies. If you use anaconda or another package manager you might prefer to first install the dependencies as described in Dependencies.

To install without dependencies, run pip install --no-deps

If you want to do development on pyradiosky, in addition to the other dependencies you will need the following packages:

  • pytest
  • pytest-cov
  • coverage
  • pre-commit
  • sphinx
  • pypandoc

One way to ensure you have all the needed packages is to use the included environment.yaml file to create a new environment that will contain all the optional dependencies along with dependencies required for testing and development (conda env create -f environment.yml). Alternatively, you can specify dev when installing pyradiosky (as in pip install pyradiosky[dev]) to install the packages needed for testing and documentation development.

To use pre-commit to prevent committing code that does not follow our style, you'll need to run pre-commit install in the top level pyradiosky directory.

Tests

Uses the pytest package to execute test suite. From the pyradiosky directory run pytest or python -m pytest.

Maintainers

pyradiosky is maintained by the RASG Managers, which currently include:

  • Adam Beardsley (Arizona State University)
  • Bryna Hazelton (University of Washington)
  • Daniel Jacobs (Arizona State University)
  • Paul La Plante (University of California, Berkeley)
  • Jonathan Pober (Brown University)

Please use the channels discussed in the guide on contributing for code-related discussions. You can contact us privately if needed at rasgmanagers@gmail.com.

Acknowledgments

Support for pyradiosky was provided by NSF awards #1835421 and #1835120.

Owner

  • Name: Radio Astronomy Software Group
  • Login: RadioAstronomySoftwareGroup
  • Kind: organization
  • Email: rasgmanagers@gmail.com

Foundational software tools for radio astronomy

JOSS Publication

pyradiosky: A Python package for Radio Sky Models
Published
May 17, 2024
DOI
Volume 9, Issue 97, Page 6503
Authors
Bryna Hazelton ORCID
Physics Department, University of Washington, USA, eScience Institute University of Washington, USA
Matthew Kolopanis ORCID
School of Earth and Space Exploration, Arizona State University, USA
Adam Lanman ORCID
Kavli Institute of Astrophysics and Space Research, Massachusetts Institute of Technology, USA
Jonathan Pober ORCID
Department of Physics, Brown University, USA
Editor
Juanjo Bazán ORCID
Tags
astronomy radio astronomy 21cm cosmology
View PDF Review Thread Software Archive

GitHub Events

Total
  • Issues event: 7
  • Watch event: 1
  • Delete event: 43
  • Issue comment event: 50
  • Push event: 80
  • Pull request review comment event: 18
  • Pull request review event: 69
  • Pull request event: 88
  • Fork event: 2
  • Create event: 39
Last Year
  • Issues event: 7
  • Watch event: 1
  • Delete event: 43
  • Issue comment event: 50
  • Push event: 80
  • Pull request review comment event: 18
  • Pull request review event: 69
  • Pull request event: 88
  • Fork event: 2
  • Create event: 39

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 613
  • Total Committers: 14
  • Avg Commits per committer: 43.786
  • Development Distribution Score (DDS): 0.405
Past Year
  • Commits: 86
  • Committers: 2
  • Avg Commits per committer: 43.0
  • Development Distribution Score (DDS): 0.488
Top Committers
Name Email Commits
Bryna Hazelton b****n@g****m 365
pre-commit-ci[bot] 6****] 78
Adam Lanman a****n@b****u 65
Matthew Kolopanis M****s@g****m 41
Ruby Byrne r****e@u****u 25
Steven Murray s****y@c****u 21
nicelmh n****m@a****u 10
Dara Storer d****r@g****m 2
Dan F-M f****y@g****m 1
Daniya d****a@g****m 1
James Aguirre j****e@s****u 1
Jonathan Pober j****r@g****m 1
daniel.d.quinter@gmail.com d****r@g****m 1
jburba j****a@b****u 1
Committer Domains (Top 20 + Academic)
brown.edu: 2 sas.upenn.edu: 1 alumni.stanford.edu: 1 curtin.edu.au: 1 uw.edu: 1

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 60
  • Total pull requests: 234
  • Average time to close issues: about 1 year
  • Average time to close pull requests: 27 days
  • Total issue authors: 13
  • Total pull request authors: 13
  • Average comments per issue: 1.6
  • Average comments per pull request: 1.41
  • Merged pull requests: 207
  • Bot issues: 0
  • Bot pull requests: 119
Past Year
  • Issues: 4
  • Pull requests: 101
  • Average time to close issues: 23 days
  • Average time to close pull requests: 5 days
  • Issue authors: 3
  • Pull request authors: 2
  • Average comments per issue: 0.25
  • Average comments per pull request: 0.93
  • Merged pull requests: 84
  • Bot issues: 0
  • Bot pull requests: 73
View more stats
Top Authors
Issue Authors
  • bhazelton (21)
  • jpober (11)
  • mkolopanis (8)
  • steven-murray (4)
  • piyanatk (3)
  • rlbyrne (3)
  • aelanman (3)
  • nicelmh (2)
  • danielquinter-brown (1)
  • jburba (1)
  • kelceydavis33 (1)
  • pritchardn (1)
  • JianrongTan (1)
Pull Request Authors
  • pre-commit-ci[bot] (119)
  • bhazelton (97)
  • mkolopanis (3)
  • aelanman (2)
  • dfm (2)
  • rlbyrne (2)
  • dstorer (2)
  • samirchoudhuri (2)
  • jpober (1)
  • dseitova (1)
  • nicelmh (1)
  • jburba (1)
  • daniel-quinter (1)
Top Labels
Issue Labels
enhancement (21) bug (13) technical debt (8) documentation (7) needs research (4) test (4) major (3) packaging (2) healpix (2) question (1) help wanted (1) continuous integration (1)
Pull Request Labels
continuous integration (118) bug (31) documentation (26) packaging (23) technical debt (23) enhancement (16) healpix (1)

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 4,642 last-month
  • Total dependent packages: 5
  • Total dependent repositories: 3
  • Total versions: 12
  • Total maintainers: 1
pypi.org: pyradiosky

Python objects and interfaces for representing diffuse, extended and compact astrophysical radio sources

  • Versions: 12
  • Dependent Packages: 5
  • Dependent Repositories: 3
  • Downloads: 4,642 Last month
Rankings
Dependent packages count: 1.9%
Downloads: 8.4%
Dependent repos count: 9.0%
Average: 10.5%
Stargazers count: 16.6%
Forks count: 16.9%
Maintainers (1)
bhazelton
Last synced: 6 months ago

Dependencies

docs/requirements.txt pypi
  • sphinx >=1.3
  • sphinx_rtd_theme ==0.5.2
.github/workflows/externaltests.yaml actions
  • actions/checkout master composite
  • conda-incubator/setup-miniconda v2 composite
.github/workflows/publish-to-test-pypi.yaml actions
  • actions/checkout master composite
  • conda-incubator/setup-miniconda v2 composite
  • pypa/gh-action-pypi-publish master composite
.github/workflows/testsuite.yaml actions
  • actions/checkout master composite
  • codecov/codecov-action v2.0.2 composite
  • conda-incubator/setup-miniconda v2 composite
  • conda-incubator/setup-miniconda v2.0.0 composite
environment.yaml conda
  • astropy >=5.2
  • astropy-healpix >=0.6
  • astroquery >=0.4.4
  • coverage
  • h5py >=3.0
  • numpy >=1.20
  • pip
  • pre-commit
  • pypandoc
  • pytest-cov
  • pyuvdata >=2.2.10
  • pyyaml
  • scipy >=1.3
  • setuptools_scm >=7.0.3
  • sphinx