2019-09-15 23:22:59 +03:00
|
|
|
|
.. To preview locally, install Sphinx and run: rst2html.py README.rst README.html
|
|
|
|
|
|
|
2019-09-15 23:40:01 +03:00
|
|
|
|
.. image:: https://travis-ci.com/WorldWideTelescope/pywwt.svg
|
|
|
|
|
|
:target: https://travis-ci.com/WorldWideTelescope/pywwt
|
2017-11-30 12:51:28 +03:00
|
|
|
|
|
2017-12-14 15:19:16 +03:00
|
|
|
|
.. image:: https://ci.appveyor.com/api/projects/status/yweuddwyxy97d8go/branch/master?svg=true
|
|
|
|
|
|
:target: https://ci.appveyor.com/project/astrofrog/pywwt/branch/master
|
|
|
|
|
|
|
|
|
|
|
|
.. image:: https://readthedocs.org/projects/pywwt/badge/?version=latest
|
|
|
|
|
|
:target: http://pywwt.readthedocs.io/en/latest/?badge=latest
|
|
|
|
|
|
:alt: Documentation Status
|
2017-11-30 12:51:28 +03:00
|
|
|
|
|
2019-09-15 23:22:59 +03:00
|
|
|
|
pywwt: The AAS WorldWide Telescope from Python/Jupyter
|
|
|
|
|
|
======================================================
|
2017-11-13 14:59:52 +03:00
|
|
|
|
|
2017-11-30 13:11:36 +03:00
|
|
|
|
About
|
|
|
|
|
|
-----
|
|
|
|
|
|
|
2019-09-15 23:22:59 +03:00
|
|
|
|
The pywwt_ package is the official toolkit for accessing the AAS_ `WorldWide
|
|
|
|
|
|
Telescope`_ (WWT) from Python. WWT is a free, open-source tool for visually
|
|
|
|
|
|
exploring humanity’s scientific understanding of the Universe. It includes a
|
|
|
|
|
|
sophisticated 4D WebGL rendering engine and a cloud-based web service for
|
2019-09-16 02:02:34 +03:00
|
|
|
|
sharing and visualizing terabytes of astronomical data. WWT is brought to you
|
|
|
|
|
|
by the non-profit `American Astronomical Society`_ (AAS), the major
|
|
|
|
|
|
organization of professional astronomers in North America.
|
|
|
|
|
|
|
|
|
|
|
|
.. _pywwt: https://pywwt.readthedocs.io/
|
|
|
|
|
|
.. _AAS: https://aas.org/
|
|
|
|
|
|
.. _American Astronomical Society: https://aas.org/
|
|
|
|
|
|
.. _WorldWide Telescope: http://www.worldwidetelescope.org/home
|
2019-09-15 23:22:59 +03:00
|
|
|
|
|
|
|
|
|
|
.. figure:: docs/images/data_layers_kepler.png
|
|
|
|
|
|
:align: center
|
|
|
|
|
|
:alt: A WWT screenshot showing exoplanets in the Kepler field overlaid on a background sky map.
|
|
|
|
|
|
|
|
|
|
|
|
*Known exoplanets in the Kepler field rendered over background imagery by pywwt.*
|
|
|
|
|
|
|
|
|
|
|
|
With pywwt_ you can:
|
|
|
|
|
|
|
|
|
|
|
|
* Visualize and explore astronomical data interactively in the `Jupyter and
|
|
|
|
|
|
JupyterLab`_ environments through an HTML widget
|
|
|
|
|
|
* Do the same in standalone applications with a Qt_ widget
|
|
|
|
|
|
* Load data from common astronomical data formats (e.g. `AstroPy tables`_)
|
|
|
|
|
|
into WWT
|
|
|
|
|
|
* Control a running instance of the WWT Windows application
|
|
|
|
|
|
|
|
|
|
|
|
.. _Jupyter and JupyterLab: https://jupyter.org/
|
|
|
|
|
|
.. _Qt: https://www.qt.io/
|
|
|
|
|
|
.. _AstroPy tables: https://docs.astropy.org/en/stable/table/
|
|
|
|
|
|
|
|
|
|
|
|
The full documentation, including installation instructions, can be found at
|
|
|
|
|
|
http://pywwt.readthedocs.io/.
|
2017-12-14 01:55:37 +03:00
|
|
|
|
|
2017-11-20 16:24:20 +03:00
|
|
|
|
|
2017-11-17 18:39:04 +03:00
|
|
|
|
Reporting issues
|
|
|
|
|
|
----------------
|
|
|
|
|
|
|
|
|
|
|
|
If you run into any issues, please open an issue `here
|
2019-09-15 23:22:59 +03:00
|
|
|
|
<https://github.com/WorldWideTelescope/pywwt/issues>`_.
|
|
|
|
|
|
|
2017-11-17 18:46:18 +03:00
|
|
|
|
|
|
|
|
|
|
Acknowledgments
|
|
|
|
|
|
---------------
|
|
|
|
|
|
|
2019-09-15 23:22:59 +03:00
|
|
|
|
Work on pywwt and the WorldWide Telescope is supported by the `American
|
|
|
|
|
|
Astronomical Society`_ (AAS). Some work on pywwt has been supported by NSF
|
|
|
|
|
|
grant 1642446_.
|
|
|
|
|
|
|
|
|
|
|
|
.. _1642446: https://www.nsf.gov/awardsearch/showAward?AWD_ID=1642446
|
