| Name | skytag JSON |
| Version |
0.3.3
JSON |
| download |
| home_page | https://github.com/thespacedoctor/skytag |
| Summary | Annotate transient sources or galaxies with the percentage credibility region they reside within on a given HealPix sky map. |
| upload_time | 2025-08-26 09:38:36 |
| maintainer | None |
| docs_url | None |
| author | David Young |
| requires_python | None |
| license | MIT |
| keywords |
astronomy
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# skytag
[](https://zenodo.org/doi/10.5281/zenodo.7977905)
<!-- INFO BADGES -->
[](https://pypi.org/project/skytag/)
[](https://pypi.org/project/skytag/)
[](https://anaconda.org/conda-forge/skytag)
[](https://pepy.tech/project/skytag)
[](https://github.com/thespacedoctor/skytag)
<!-- STATUS BADGES -->
[](https://soxs-eso-data.org/ci/blue/organizations/jenkins/skytag/activity?branch=main)
[](https://soxs-eso-data.org/ci/blue/organizations/jenkins/skytag/activity?branch=develop)
[](https://raw.githack.com/thespacedoctor/skytag/main/htmlcov/index.html)
[](https://skytag.readthedocs.io/en/main/)
[](https://github.com/thespacedoctor/skytag/issues?q=is%3Aissue+is%3Aopen+label%3A%22type%3A+bug%22+)
*Annotate transient sources or galaxies with the percentage credibility region they reside within on a given HealPix sky map.*
Documentation for skytag is hosted by [Read the Docs](https://skytag.readthedocs.io/en/main/) ([development version](https://skytag.readthedocs.io/en/develop/) and [main version](https://skytag.readthedocs.io/en/main/)). The code lives on [github](https://github.com/thespacedoctor/skytag). Please report any issues you find [here](https://github.com/thespacedoctor/skytag/issues). If you want to contribute, [pull requests](https://github.com/thespacedoctor/skytag/pulls) are welcomed!
true
## Features
- A command-line tool to report the credibility region a sky-location is found within on a HealPix skymap.
- Providing a MJD will also return the time since the map event.
- A python interface to provide the same functionality reported above, but can handle large lists of sky-locations or transient events.
- works well in conjunction with [gocart](https://github.com/thespacedoctor/gocart).
## Installation
The easiest way to install skytag is to use `conda`:
``` bash
conda create -n skytag python=3.11 pip skytag -c conda-forge
conda activate skytag
```
To upgrade to the latest version of skytag use the command:
``` bash
conda upgrade skytag -c conda-forge
```
It is also possible to install via pip if required:
``` bash
pip install skytag
```
To check installation was successful run `skytag -v`. This should return the version number of the install.
## Command-Line
Here is the command-line usage:
```bash
Usage:
skytag <ra> <dec> <mapPath>
skytag <ra> <dec> <mjd> <mapPath>
```
If you need an example skymap, [download one from here](https://github.com/thespacedoctor/skytag/raw/main/skytag/commonutils/tests/input/bayestar.multiorder.fits).
For example, to find the probability of the location RA=170.343532, Dec=-40.532255 then run:
```bash
skytag 170.343532 -40.532255 bayestar.multiorder.fits
```
This returns:
> This location is found in the 74.55 credibility region of the map.
If you also supply an MJD:
```bash
skytag 170.343532 -40.532255 60065.2232 bayestar.multiorder.fits
```
We get:
> This transient is found in the 74.55 credibility region, and occurred 2.85564 days after the map event.
Finally, we can request the localised event distance for this specific sky-position be returned:
```bash
skytag -d 170.343532 -40.532255 bayestar.multiorder.fits
```
> This transient is found in the 74.55% credibility region. At this sky-position the map event is localised to a distance of 75.03 (±19.72) Mpc.
## Python API
To use skytag in your own Python code, [see here](_autosummary/skytag.commonutils.prob_at_location.html#skytag.commonutils.prob_at_location).
## gocart
skyTag works very well in conjunction with [gocart](https://github.com/thespacedoctor/gocart), a tool to consume GCN Kafka alert streams and convert HealPix skymaps.
## How to cite skytag
If you use `skytag` in your work, please cite using the following BibTeX entry:
```bibtex
@software{Young_skytag,
author = {Young, David R.},
doi = {10.5281/zenodo.7977905},
license = {GPL-3.0-only},
title = {{skytag. Annotate transient sources or galaxies with the percentage credibility region they reside within on a given HealPix sky map.}},
url = {https://zenodo.org/doi/10.5281/zenodo.7977905}
}
```
Raw data
{
"_id": null,
"home_page": "https://github.com/thespacedoctor/skytag",
"name": "skytag",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "astronomy",
"author": "David Young",
"author_email": "d.r.young@qub.ac.uk",
"download_url": "https://files.pythonhosted.org/packages/65/c3/9bfc31626527cd8bc70e8a3494f6da2df1f8b49ceb72498ddcb715e9fbfa/skytag-0.3.3.tar.gz",
"platform": null,
"description": "# skytag\n\n[](https://zenodo.org/doi/10.5281/zenodo.7977905) \n\n<!-- INFO BADGES --> \n\n[](https://pypi.org/project/skytag/)\n[](https://pypi.org/project/skytag/)\n[](https://anaconda.org/conda-forge/skytag)\n[](https://pepy.tech/project/skytag)\n[](https://github.com/thespacedoctor/skytag)\n\n<!-- STATUS BADGES --> \n\n[](https://soxs-eso-data.org/ci/blue/organizations/jenkins/skytag/activity?branch=main)\n[](https://soxs-eso-data.org/ci/blue/organizations/jenkins/skytag/activity?branch=develop)\n[](https://raw.githack.com/thespacedoctor/skytag/main/htmlcov/index.html)\n[](https://skytag.readthedocs.io/en/main/)\n[](https://github.com/thespacedoctor/skytag/issues?q=is%3Aissue+is%3Aopen+label%3A%22type%3A+bug%22+) \n\n*Annotate transient sources or galaxies with the percentage credibility region they reside within on a given HealPix sky map.*\n\nDocumentation for skytag is hosted by [Read the Docs](https://skytag.readthedocs.io/en/main/) ([development version](https://skytag.readthedocs.io/en/develop/) and [main version](https://skytag.readthedocs.io/en/main/)). The code lives on [github](https://github.com/thespacedoctor/skytag). Please report any issues you find [here](https://github.com/thespacedoctor/skytag/issues). If you want to contribute, [pull requests](https://github.com/thespacedoctor/skytag/pulls) are welcomed! \ntrue\n\n## Features\n\n- A command-line tool to report the credibility region a sky-location is found within on a HealPix skymap. \n- Providing a MJD will also return the time since the map event. \n- A python interface to provide the same functionality reported above, but can handle large lists of sky-locations or transient events.\n- works well in conjunction with [gocart](https://github.com/thespacedoctor/gocart).\n\n## Installation\n\nThe easiest way to install skytag is to use `conda`:\n\n``` bash\nconda create -n skytag python=3.11 pip skytag -c conda-forge\nconda activate skytag\n```\n\nTo upgrade to the latest version of skytag use the command:\n\n``` bash\nconda upgrade skytag -c conda-forge\n```\n\nIt is also possible to install via pip if required:\n\n``` bash\npip install skytag\n```\n\nTo check installation was successful run `skytag -v`. This should return the version number of the install.\n\n## Command-Line \n\nHere is the command-line usage:\n\n```bash \nUsage:\n skytag <ra> <dec> <mapPath>\n skytag <ra> <dec> <mjd> <mapPath>\n```\n\nIf you need an example skymap, [download one from here](https://github.com/thespacedoctor/skytag/raw/main/skytag/commonutils/tests/input/bayestar.multiorder.fits).\n\nFor example, to find the probability of the location RA=170.343532, Dec=-40.532255 then run:\n\n```bash \nskytag 170.343532 -40.532255 bayestar.multiorder.fits\n```\n\nThis returns:\n\n> This location is found in the 74.55 credibility region of the map.\n\nIf you also supply an MJD:\n\n```bash \nskytag 170.343532 -40.532255 60065.2232 bayestar.multiorder.fits\n```\n\nWe get:\n\n> This transient is found in the 74.55 credibility region, and occurred 2.85564 days after the map event.\n\nFinally, we can request the localised event distance for this specific sky-position be returned:\n\n```bash \nskytag -d 170.343532 -40.532255 bayestar.multiorder.fits\n```\n\n> This transient is found in the 74.55% credibility region. At this sky-position the map event is localised to a distance of 75.03 (\u00b119.72) Mpc.\n\n## Python API\n\nTo use skytag in your own Python code, [see here](_autosummary/skytag.commonutils.prob_at_location.html#skytag.commonutils.prob_at_location).\n\n## gocart\n\nskyTag works very well in conjunction with [gocart](https://github.com/thespacedoctor/gocart), a tool to consume GCN Kafka alert streams and convert HealPix skymaps.\n\n## How to cite skytag\n\nIf you use `skytag` in your work, please cite using the following BibTeX entry: \n\n```bibtex\n@software{Young_skytag,\n author = {Young, David R.},\n doi = {10.5281/zenodo.7977905},\n license = {GPL-3.0-only},\n title = {{skytag. Annotate transient sources or galaxies with the percentage credibility region they reside within on a given HealPix sky map.}},\n url = {https://zenodo.org/doi/10.5281/zenodo.7977905}\n}\n```\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Annotate transient sources or galaxies with the percentage credibility region they reside within on a given HealPix sky map.",
"version": "0.3.3",
"project_urls": {
"Download": "https://github.com/thespacedoctor/skytag/archive/v0.3.3.zip",
"Homepage": "https://github.com/thespacedoctor/skytag"
},
"split_keywords": [
"astronomy"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5d20ae328fa54207baf058ef9faa6b1c2f8f0c67605704f2707fa1cb5468a887",
"md5": "a1a84b22493ec96c7e02382785bbc82c",
"sha256": "58da1b74c6aa2544d78f4623a8b9c906d06b01df1e6e0736163f62f22e1bade1"
},
"downloads": -1,
"filename": "skytag-0.3.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a1a84b22493ec96c7e02382785bbc82c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 32184,
"upload_time": "2025-08-26T09:38:35",
"upload_time_iso_8601": "2025-08-26T09:38:35.411046Z",
"url": "https://files.pythonhosted.org/packages/5d/20/ae328fa54207baf058ef9faa6b1c2f8f0c67605704f2707fa1cb5468a887/skytag-0.3.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "65c39bfc31626527cd8bc70e8a3494f6da2df1f8b49ceb72498ddcb715e9fbfa",
"md5": "7f7e7162fdcc00e4f872af2367f12726",
"sha256": "1a0a4d9762f4e7c88f330d7cdd3f846ed0d2266adf13dff9bae90813d1a83ebd"
},
"downloads": -1,
"filename": "skytag-0.3.3.tar.gz",
"has_sig": false,
"md5_digest": "7f7e7162fdcc00e4f872af2367f12726",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 31996,
"upload_time": "2025-08-26T09:38:36",
"upload_time_iso_8601": "2025-08-26T09:38:36.396065Z",
"url": "https://files.pythonhosted.org/packages/65/c3/9bfc31626527cd8bc70e8a3494f6da2df1f8b49ceb72498ddcb715e9fbfa/skytag-0.3.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-26 09:38:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "thespacedoctor",
"github_project": "skytag",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "skytag"
}
