| Name | pyradiosky JSON |
| Version |
1.0.1
JSON |
| download |
| home_page | None |
| Summary | Python objects and interfaces for representing diffuse, extended and compact astrophysical radio sources |
| upload_time | 2024-07-01 17:49:49 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | None |
| keywords |
radio
astronomy
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
|
# pyradiosky
[](https://codecov.io/gh/RadioAstronomySoftwareGroup/pyradiosky)
[](https://doi.org/10.21105/joss.06503)
[](https://doi.org/10.5281/zenodo.11187469)
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](https://github.com/EoRImaging/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](docs/references/skyh5_memo.pdf).
# Community Guidelines
Contributions to this package to add new file formats or address any of the
issues in the [issue log](https://github.com/RadioAstronomySoftwareGroup/pyradiosky/issues)
are very welcome, as are bug reports and feature requests.
Please see our [guide on contributing](.github/CONTRIBUTING.md)
# 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](https://github.com/RadioAstronomySoftwareGroup/pyradiosky/blob/main/CHANGELOG.md).
# Documentation
Developer API documentation is hosted [here](https://pyradiosky.readthedocs.io/en/latest/).
# 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](https://ui.adsabs.harvard.edu/abs/2024JOSS....9.6503H)
# Installation
Simple installation via pip is available for users, developers should follow
the directions under [Developer Installation](#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](#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.4
* numpy>=1.23
* scipy>=1.8
* pyuvdata>=2.4.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.2 (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](#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](.github/CONTRIBUTING.md)
for code-related discussions. You can contact us privately if needed at
[rasgmanagers@gmail.com](mailto:rasgmanagers@gmail.com).
# Acknowledgments
Support for pyradiosky was provided by NSF awards #1835421 and #1835120.
Raw data
{
"_id": null,
"home_page": null,
"name": "pyradiosky",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Bryna Hazelton <brynah@phys.washington.edu>, Matthew Kolopanis <mjkolopa@asu.edu>",
"keywords": "radio astronomy",
"author": null,
"author_email": "Bryna Hazelton <brynah@phys.washington.edu>, Matthew Kolopanis <mjkolopa@asu.edu>, Jonathan Pober <jonathan_pober@brown.edu>, Adam Lanman <alanman@mit.edu>",
"download_url": "https://files.pythonhosted.org/packages/69/2d/72271e0196151c907fb1a31d59e8245940e69d783960607fe444dd9802a6/pyradiosky-1.0.1.tar.gz",
"platform": null,
"description": "# pyradiosky\n\n[](https://codecov.io/gh/RadioAstronomySoftwareGroup/pyradiosky)\n[](https://doi.org/10.21105/joss.06503)\n[](https://doi.org/10.5281/zenodo.11187469)\n\nPython objects and interfaces for representing diffuse, extended and compact\nastrophysical radio sources.\n\nThe primary user class is `SkyModel`, which supports:\n\n - catalogs of point sources (read/write to hd5 and text files, read VOTables)\n - diffuse models as HEALPix maps (read/write to hd5 files)\n - conversion between any astropy supported coordinates (e.g. J2000 RA/Dec) and\n Azimuth/Elevation including calculating full polarization coherencies in Az/El.\n\n# File formats\n\npyradiosky supports reading in catalogs from several formats, including VO Table files,\ntext files, [FHD](https://github.com/EoRImaging/FHD) catalog files and SkyH5 files and\nsupports writing to SkyH5 and text files. SkyH5 is an HDF5-based file format defined by\nthe pyradiosky team, a full description is in the [SkyH5 memo](docs/references/skyh5_memo.pdf).\n\n# Community Guidelines\nContributions to this package to add new file formats or address any of the\nissues in the [issue log](https://github.com/RadioAstronomySoftwareGroup/pyradiosky/issues)\nare very welcome, as are bug reports and feature requests.\nPlease see our [guide on contributing](.github/CONTRIBUTING.md)\n\n# Versioning\nWe use a `generation.major.minor` version number format. We use the `generation`\nnumber for very significant improvements or major rewrites, the `major` number\nto indicate substantial package changes and the `minor` number to release smaller\nincremental updates (which do not include breaking API changes). We do our best\nto provide a significant period (usually 2 major generations) of deprecation\nwarnings for all breaking changes to the API.\nWe track all changes in our [changelog](https://github.com/RadioAstronomySoftwareGroup/pyradiosky/blob/main/CHANGELOG.md).\n\n# Documentation\nDeveloper API documentation is hosted [here](https://pyradiosky.readthedocs.io/en/latest/).\n\n# Citation\nPlease cite pyradiosky by citing our JOSS paper:\n\nHazelton et al., (2024). pyradiosky: A Python package for Radio Sky Models.\nJournal of Open Source Software, 9(97), 6503, https://doi.org/10.21105/joss.06503\n\n[ADS Link](https://ui.adsabs.harvard.edu/abs/2024JOSS....9.6503H)\n\n# Installation\nSimple installation via pip is available for users, developers should follow\nthe directions under [Developer Installation](#developer-installation) below.\n\nFor simple installation, the latest stable version is available via pip with\n`pip install pyradiosky`.\n\nThere are some optional dependencies that are required for specific functionality,\nwhich will not be installed automatically by pip.\nSee [Dependencies](#dependencies) for details on installing optional dependencies.\n\n## Dependencies\n\nIf you are using `conda` to manage your environment, you may wish to install the\nfollowing packages before installing `pyradiosky`:\n\nRequired:\n\n* astropy>=6.0\n* h5py>=3.4\n* numpy>=1.23\n* scipy>=1.8\n* pyuvdata>=2.4.3\n* setuptools_scm>=8.1\n\nOptional:\n\n* astropy-healpix>=1.0.2 (for working with beams in HEALPix formats)\n* astroquery>=0.4.4 (for downloading GLEAM and other VizieR catalogs)\n* lunarsky>=0.2.2 (for supporting telescope locations on the moon)\n\nWe suggest using conda to install all the dependencies. To install\npyuvdata, astropy-healpix and astroquery, you'll need to add conda-forge as a channel\n(```conda config --add channels conda-forge```).\n\nIf you do not want to use conda, the packages are also available on PyPI.\nYou can install the optional dependencies via pip by specifying an option\nwhen you install pyradiosky, as in ```pip install .[healpix]```\nwhich will install all the required packages for using the HEALPix functionality\nin pyradiosky. The options that can be passed in this way are:\n[`healpix`, `astroquery`, `lunarsky`, `all`, `doc`, `test`, `dev`].\nThe first three (`healpix`, `astroquery`, `lunarsky`) enable various specific\nfunctionality while `all` will install all optional dependencies.\nThe last three (`doc`, `test` and `dev`) may be useful for developers of pyradiosky.\n\n## Developer Installation\nClone the repository using\n```git clone https://github.com/RadioAstronomySoftwareGroup/pyradiosky.git```\n\nNavigate into the pyradiosky directory and run `pip install .`\n(note that `python setup.py install` does not work).\nNote that this will attempt to automatically install any missing dependencies.\nIf you use anaconda or another package manager you might prefer to first install\nthe dependencies as described in [Dependencies](#dependencies).\n\nTo install without dependencies, run `pip install --no-deps`\n\nIf you want to do development on pyradiosky, in addition to the other dependencies\nyou will need the following packages:\n\n* pytest\n* pytest-cov\n* coverage\n* pre-commit\n* sphinx\n* pypandoc\n\nOne way to ensure you have all the needed packages is to use the included\n`environment.yaml` file to create a new environment that will\ncontain all the optional dependencies along with dependencies required for\ntesting and development (```conda env create -f environment.yml```).\nAlternatively, you can specify `dev` when installing pyradiosky\n(as in `pip install pyradiosky[dev]`) to install the packages needed for testing\nand documentation development.\n\nTo use pre-commit to prevent committing code that does not follow our style,\nyou'll need to run `pre-commit install` in the top level `pyradiosky` directory.\n\n# Tests\nUses the `pytest` package to execute test suite.\nFrom the pyradiosky directory run ```pytest``` or ```python -m pytest```.\n\n# Maintainers\npyradiosky is maintained by the RASG Managers, which currently include:\n\n - Adam Beardsley (Arizona State University)\n - Bryna Hazelton (University of Washington)\n - Daniel Jacobs (Arizona State University)\n - Paul La Plante (University of California, Berkeley)\n - Jonathan Pober (Brown University)\n\nPlease use the channels discussed in the [guide on contributing](.github/CONTRIBUTING.md)\nfor code-related discussions. You can contact us privately if needed at\n[rasgmanagers@gmail.com](mailto:rasgmanagers@gmail.com).\n\n# Acknowledgments\nSupport for pyradiosky was provided by NSF awards #1835421 and #1835120.\n",
"bugtrack_url": null,
"license": null,
"summary": "Python objects and interfaces for representing diffuse, extended and compact astrophysical radio sources",
"version": "1.0.1",
"project_urls": {
"Documentation": "https://pyradiosky.readthedocs.io/",
"Repository": "https://github.com/RadioAstronomySoftwareGroup/pyradiosky"
},
"split_keywords": [
"radio",
"astronomy"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "689a84bf31a57ccffbd6d1d9b0243f806997638c2d1e9990e5eec8036653c622",
"md5": "3e6973ada38be9ac7a3425e2b9179fe6",
"sha256": "94b5a080de89aebe8bfdc13e1c95919b1514def635f6c90867651646f0bb5dad"
},
"downloads": -1,
"filename": "pyradiosky-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3e6973ada38be9ac7a3425e2b9179fe6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 664076,
"upload_time": "2024-07-01T17:49:47",
"upload_time_iso_8601": "2024-07-01T17:49:47.625109Z",
"url": "https://files.pythonhosted.org/packages/68/9a/84bf31a57ccffbd6d1d9b0243f806997638c2d1e9990e5eec8036653c622/pyradiosky-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "692d72271e0196151c907fb1a31d59e8245940e69d783960607fe444dd9802a6",
"md5": "b303f35c7a5386ac188408fffbda4719",
"sha256": "86e7bab6679701ce96cbee2865e0dd8813a0aee916e5b4869a852d56a803297b"
},
"downloads": -1,
"filename": "pyradiosky-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "b303f35c7a5386ac188408fffbda4719",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 1733878,
"upload_time": "2024-07-01T17:49:49",
"upload_time_iso_8601": "2024-07-01T17:49:49.995293Z",
"url": "https://files.pythonhosted.org/packages/69/2d/72271e0196151c907fb1a31d59e8245940e69d783960607fe444dd9802a6/pyradiosky-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-01 17:49:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "RadioAstronomySoftwareGroup",
"github_project": "pyradiosky",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "pyradiosky"
}
