Metadata-Version: 2.4
Name: uranography
Version: 1.2.1
Summary: Tools for visualization of the celestial sphere.
Author-email: "Eric H. Neilsen, Jr." <neilsen@fnal.gov>
Project-URL: Homepage, https://github.com/lsst/uranography
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Scientific/Engineering :: Astronomy
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: astropy>=5.3
Requires-Dist: healpy
Requires-Dist: healsparse
Requires-Dist: bokeh>=3.1.1
Requires-Dist: panel>=1.1.0
Requires-Dist: colorcet
Requires-Dist: jupyter
Requires-Dist: nbconvert
Requires-Dist: selenium>=4.10.0
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Dynamic: license-file

# uranography

[![pypi](https://img.shields.io/pypi/v/uranography.svg)](https://pypi.org/project/uranography/)
[![Conda Version](https://img.shields.io/conda/vn/conda-forge/uranography.svg)](https://anaconda.org/conda-forge/uranography) <br>
[![Build and Publish PyPI](https://github.com/lsst/uranography/actions/workflows/build.yaml/badge.svg)](https://github.com/lsst/uranography/actions/workflows/build.yaml)
[![Build and Upload Docs](https://github.com/lsst/uranography/actions/workflows/build_docs.yaml/badge.svg)](https://github.com/lsst/uranography/actions/workflows/build_docs.yaml)



## Description

Documentation available at https://uranography.lsst.io

`uranography` is a collection of tools for making plots on the celestial sphere with `bokeh`.
It is primarily intended for  use in interactive environments such as jupyter notebooks or dashboards.

It supports a handful of map projections, and interactive tools that adjust them in ways that simulate traditional tools
used in astronomy:
the Lambert azimutal equal area projection simulates a [planisphere](https://en.wikipedia.org/wiki/Planisphere),
and the othrogrophic projection simulates an [armillary sphere](https://en.wikipedia.org/wiki/Armillary_sphere).

The `uranography` module includes tools to produce:
- `bokeh` [`transforms`](https://docs.bokeh.org/en/latest/docs/reference/transform.html) that apply the map projection in the client.
- projections of [`healpix`](https://healpix.jpl.nasa.gov/) and [healsparse](https://github.com/LSSTDESC/healsparse) arrays.
- graticules in equatorial coordinates (R.A. and declination),
- graticules in horizon coordinates (altitude and azimuth),
- the ecliptic plane,
- the horizon (or circles of any other altitude),
- circles of a sphere (great or small circes) with arbitrary centers and radii, or arcs of such circles beginning and ending at arbitrary bearings from the center.
- the galactic plane, and
- stars from the [Yale Bright Star Catalog](http://tdc-www.harvard.edu/catalogs/bsc5.html).

These methods add `bokeh` glyphs, data sources, and renderer models with standard or manually assigned assigned names to an instance of `bokeh.plotting.Figure`, so they can be selected by name and adjusted and refined using the standard `bokeh` API.

More documentation is available at [uranography.lsst.io](https://uranography.lsst.io).
