Metadata-Version: 2.1
Name: skyproj
Version: 1.2.3
Summary: Python tools for making sky projections and maps
Home-page: https://github.com/lsstdesc/skyproj
Author: Eli Rykoff, Alex Drlica-Wagner, and others
Author-email: erykoff@stanford.edu
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Scientific/Engineering :: Astronomy
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: astropy >=4.0
Requires-Dist: matplotlib >=3.6
Requires-Dist: hpgeom
Requires-Dist: healsparse
Requires-Dist: pyproj >=3.1

# skyproj: Sky Projections with matplotlib and proj

The `skyproj` package provides an astronomically oriented interface to ploting sky maps based on [`matplotlib`](https://matplotlib.org/) and [PROJ](https://proj.org/).
This package addresses several issues present in the [`healpy`](https://healpy.readthedocs.io/en/latest/) plotting routines:
1. `healpy` supports a limited set of sky projections (`cartview`, `mollview`, and `gnomview`)
2. `healpy` converts sparse healpix maps to full maps to plot; this is memory intensive for large `nside`

`skyproj` is intended as the primary visualization tool for [`healsparse`](https://healsparse.readthedocs.io/en/latest/) maps, which provide high resolution maps in a memory efficent way.
`skyproj` can create interactive visualizations of `healsparse` and `healpy` maps that dynamically change resolution.
In addition, `skyproj` provides some convenience functionality for large optical surveys.
The `skyproj` package has its origins in `cartosky`, which was built on `cartopy` and some of the features may be familiar to users of `cartopy`.
However, it has diverged significantly from the original code as the needs of mapping the sky are somewhat different than the needs of mapping the Earth.

## Installation

The easiest way to install `skyproj` is from pypi or conda-forge. (Coming soon.)

## Tutorial

If you want to see what you can do with `skyproj`, check out the [tutorial](tutorial/).
