{"id":22903084,"url":"https://github.com/space-physics/astrometry_geomap","last_synced_at":"2025-05-08T16:54:57.257Z","repository":{"id":16611784,"uuid":"19366614","full_name":"space-physics/astrometry_geomap","owner":"space-physics","description":"FITS to Azimuth/Elevation using Astrometry.net--calibrate and plate scale images","archived":false,"fork":false,"pushed_at":"2024-02-06T04:39:39.000Z","size":661,"stargazers_count":12,"open_issues_count":1,"forks_count":3,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-09T21:09:06.011Z","etag":null,"topics":["astrometry","astropy","citizen-science"],"latest_commit_sha":null,"homepage":"https://www.scivision.dev/astrometry-tips-techniques","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/space-physics.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null},"funding":{"github":["scivision"],"ko_fi":"scivision"}},"created_at":"2014-05-02T05:14:44.000Z","updated_at":"2025-03-27T07:12:56.000Z","dependencies_parsed_at":"2023-11-07T20:00:20.352Z","dependency_job_id":"45ff6667-3480-4bf0-be3e-3868e710de7d","html_url":"https://github.com/space-physics/astrometry_geomap","commit_stats":{"total_commits":155,"total_committers":1,"mean_commits":155.0,"dds":0.0,"last_synced_commit":"342bc9c7937b513fd2d55476d88ad304a33bbe9d"},"previous_names":["space-physics/astrometry_azel"],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/space-physics%2Fastrometry_geomap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/space-physics%2Fastrometry_geomap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/space-physics%2Fastrometry_geomap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/space-physics%2Fastrometry_geomap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/space-physics","download_url":"https://codeload.github.com/space-physics/astrometry_geomap/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253112078,"owners_count":21856070,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["astrometry","astropy","citizen-science"],"created_at":"2024-12-14T02:33:05.110Z","updated_at":"2025-05-08T16:54:57.228Z","avatar_url":"https://github.com/space-physics.png","language":"Python","funding_links":["https://github.com/sponsors/scivision","https://ko-fi.com/scivision"],"categories":[],"sub_categories":[],"readme":"\n# Azimuth/Elevation converter for [Astrometry.net](https://github.com/dstndstn/astrometry.net)\n\n[![Zenodo DOI](https://zenodo.org/badge/19366614.svg)](https://zenodo.org/badge/latestdoi/19366614)\n[![ci](https://github.com/space-physics/astrometry_geomap/actions/workflows/ci.yml/badge.svg)](https://github.com/space-physics/astrometry_geomap/actions/workflows/ci.yml)\n[![PyPI version](https://img.shields.io/pypi/pyversions/astrometry-azel.svg)](https://pypi.python.org/pypi/astrometry-azel)\n[![Downloads](http://pepy.tech/badge/astrometry-azel)](http://pepy.tech/project/astrometry-azel)\n\n[Tips and techniques article](https://www.scivision.dev/astrometry-tips-techniques), especially for DSLR citizen science data.\n\nGet\n[Astrometry.net \u0026ge; 0.67](https://scivision.dev/astrometry-install-usage)\nor use the\n[astrometry.net cloud service](http://nova.astrometry.net/upload).\n\n```sh\npython3 -m pip install -e .\n```\n\nThe main program used is [PlateScale.py](./PlateScale.py).\nAuxiliary scripts are under [scripts/](./scripts/)\n\n## PlateScale.py\n\nThe main script most users would use to register a star field image to Azimuth and Elevation is \"PlateScale.py\".\n\nThe \"--args\" command line option allows passing through a variety of parameters to `solve-field`, which underlies this program.\nType `solve-field -h` or `man solve-field` for a brief description of the nearly 100 options available.\n\nBe sure to enclose the options in quotes.\nFor example, to specify that the image field is at least 20 degrees in extent:\n\n```sh\npython PlateScale.py ~/data/myimg.jpg --args \"--scale-low 20\"\n```\n\nCitizen science images often contain extraneous items in the image field of view.\nThese can very easily break `solve-field`, which is designed for professional science-grade imagery from telescopes and narrow to medium field of view imagers (at least to 50 degree FOV).\nTo mitigate these issues, judicious use of arguments passed to `solve-field` via `--args` is probably a good start.\n\nThe parameters I find most useful for citizen science images include:\n\n```\n--scale-low \u003cscale\u003e: lower bound of image scale estimate\n\n--scale-high \u003cscale\u003e: upper bound of image scale estimate\n\n--depth \u003cnumber or range\u003e: number of field objects to look at, or range\n          of numbers; 1 is the brightest star, so \"-d 10\" or \"-d 1-10\" mean look\n          at the top ten brightest stars only.\n```\n\nFor extraneous regions of the image, try making a copy of the original image that has the offending regions  cropped out.\nIf the original image is in a lossy format such as JPEG, consider saving in a lossless format such as PNG after cropping.\n\n### Astrometry.net installed on local computer\n\n```sh\npython PlateScale.py myimg.fits 61.2 -149.9 2013-04-02T12:03:23Z\n```\n\ngives netCDF .nc with az/el ra/dec and PNG plots of the data.\nBoth files contain the same data, just for your convenience.\n\n61.2 -149.9 is your WGS84 coordinates, 2013-04-02T12:03:23Z is UTC time of the picture.\n\n### wcs.fits from the Astrometry.net website\n\nDownload from nova.astrometry.net solved image the \"new-image.fits\" and \"wcs.fits\" files, then:\n\n```sh\npython PlateScale.py 61.2 -149.9 2013-04-02T12:03:23Z new-image.fits\n```\n\n## Notes\n\n* 2MASS [index](http://broiler.astrometry.net/~dstn/4200/)\n* Tycho [index](http://broiler.astrometry.net/~dstn/4100/)\n\n* ways to [use astrometry.net](http://astrometry.net/use.html)\n* astrometry.net [source code releases](http://astrometry.net/downloads/)\n* astrometry.net [GitHub](https://github.com/dstndstn/astrometry.net)\n\n* [article](https://www.dsi.uni-stuttgart.de/institut/mitarbeiter/schindler/Schindler_et_al._2016.pdf) on good robustness of Astrometry.net to shaky, streaked images.\n\n### Download star index files\n\n```sh\npython downloadIndex.py\n```\n\nEdit file /etc/astrometry.cfg or similar:\n\nBe sure `add_path` points to /home/username/astrometry-data, where username is your Linux username.\nDon't use ~ or $HOME.\n\nUncomment `inparallel` to process much faster.\n\nOptionally, set `minwidth` smaller than the smallest FOV (in degrees) expected.\nFor example, if NOT using a telescope, perhaps minwidth 1 or something.\n\n## PlotGeomap.py\n\nPlot an image registered to Latitude and Longitude, assuming the image features all occurred at a single altitude.\nThis technique is used in aeronomy assuming a certain altitude of auroral or airglow emissions.\nThis approximation is based on colors representing particle dynamics at a range of altitudes, approximated by a single altitude.\nFor example, if a short wavelength filter (blue) was applied to the auroral image, one might assume the emissions were at about 100 km altitude.\n\n## Related\n\nFor source extraction or photometry, see my AstroPy-based\n[examples](https://github.com/scivision/starscale).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspace-physics%2Fastrometry_geomap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspace-physics%2Fastrometry_geomap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspace-physics%2Fastrometry_geomap/lists"}