Metadata-Version: 2.1
Name: jwst_novt
Version: 0.1.4
Summary: JWST NIRSpec Observation Visualization Tool
Author-email: STScI <help@stsci.edu>
License: BSD 3-Clause License
        
        Copyright (c) 2023, Association of Universities for Research in Astronomy.
        All rights reserved.
        
        Redistribution and use in source and binary forms, with or without
        modification, are permitted provided that the following conditions are met:
        
        * Redistributions of source code must retain the above copyright notice, this
          list of conditions and the following disclaimer.
        
        * Redistributions in binary form must reproduce the above copyright notice,
          this list of conditions and the following disclaimer in the documentation
          and/or other materials provided with the distribution.
        
        * Neither the name of the copyright holder nor the names of its
          contributors may be used to endorse or promote products derived from
          this software without specific prior written permission.
        
        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
        AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
        DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
        SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
        CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
        OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
        
Project-URL: Homepage, https://github.com/spacetelescope/jwst_novt
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 :: Implementation :: CPython
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
License-File: LICENSE.rst
Requires-Dist: astropy>=5.2.2
Requires-Dist: jwst_gtvt>=1.0.0
Requires-Dist: numpy>=1.24.3
Requires-Dist: pandas>=2.0.1
Requires-Dist: pysiaf>=0.19.1
Requires-Dist: regions>=0.7
Requires-Dist: requests>=2.28
Requires-Dist: setuptools>=61.2
Provides-Extra: interact
Requires-Dist: bqplot>=0.12.37; extra == "interact"
Requires-Dist: ipykernel>=6.19.4; extra == "interact"
Requires-Dist: ipyvuetify>=1.7.0; extra == "interact"
Requires-Dist: ipywidgets>=8.0.4; extra == "interact"
Requires-Dist: jdaviz>=3.4.0; extra == "interact"
Requires-Dist: pyyaml>=5.4.1; extra == "interact"
Requires-Dist: traitlets>=5.0.5; extra == "interact"
Requires-Dist: voila>=0.4; extra == "interact"
Provides-Extra: test
Requires-Dist: ruff>0.3; extra == "test"
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-coverage; extra == "test"
Requires-Dist: pytest-mock; extra == "test"
Provides-Extra: docs
Requires-Dist: graphviz; extra == "docs"
Requires-Dist: stsci_rtd_theme; extra == "docs"
Requires-Dist: sphinx-astropy; extra == "docs"
Requires-Dist: sphinx_rtd_theme; extra == "docs"
Requires-Dist: sphinx-automodapi; extra == "docs"
Requires-Dist: sphinx-issues; extra == "docs"
Requires-Dist: tomli; extra == "docs"

JWST NIRSpec Observation Visualization Tool (NOVT)
==================================================

.. image:: https://github.com/spacetelescope/jwst_novt/workflows/CI/badge.svg
    :target: https://github.com/spacetelescope/jwst_novt/actions
    :alt: GitHub Actions CI Status
.. image:: https://codecov.io/gh/spacetelescope/jwst_novt/branch/main/graph/badge.svg
    :target: https://codecov.io/gh/spacetelescope/jwst_novt
    :alt: Coverage Status
.. image:: https://readthedocs.org/projects/jwst_novt/badge/?version=latest
    :target: https://jwst-novt.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status
.. image:: http://img.shields.io/badge/powered%20by-AstroPy-orange.svg?style=flat
   :target: http://www.astropy.org
   :alt: Powered by Astropy Badge


The NIRSpec Observation Visualization Tool (NOVT) visualizes projected footprints
for the NIRSpec and NIRCam instruments on the James Webb Space Telescope (JWST).
It is intended to aid in planning NIRCam pre-imaging for NIRSpec MOS observations,
by allowing simultaneous display and configuration of the NIRSpec and NIRCam
fields of view for a given sky position.

Available modules
-----------------

The NOVT package includes tools for calculating footprints and visibility timelines
and tools for interactively configuring and displaying them.  The dependencies for
the interactive tools are much more extensive than the core tools require, so the
package allows installation of the core tools without the optional dependencies
required by the interactive tools.

See the `online documentation <https://jwst-novt.readthedocs.io/en/latest/>`__
for more information on the contents of the software modules.

Core tools: jwst_novt
~~~~~~~~~~~~~~~~~~~~~
The top-level package (`jwst_novt`) contains lightweight interfaces to the
`pysiaf <https://github.com/spacetelescope/pysiaf>`__ and
`jwst_gtvt <https://github.com/spacetelescope/jwst_gtvt>`__
tools to compute aperture projections by target position and
target visibility and position angle by date, respectively. This package may
be installed and used directly to create inputs for preferred visualization
tools (e.g.
`SAO DS9 <https://sites.google.com/cfa.harvard.edu/saoimageds9>`__ or
`Imviz <https://jdaviz.readthedocs.io/en/latest/imviz/index.html>`__).

See the `novt_tools` notebook in the `notebooks` directory of the source
distribution for an example of this usage.

Display and interactive tools: jwst_novt.interact
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The `jwst_novt.interact` package contains tools to configure, visualize, and interact
with the instrument apertures and visibility timeline in a Jupyter notebook
context. A default application is provided that can be run in a local notebook
server, or as a remote web application.  STScI plans to serves this application for the
public soon.  In the meantime, the default application can be run locally by following the
installation instructions below, then running the command::

    $ novt

See also the `novt_interact` notebook in the `notebooks` directory of the source
distribution for an example of using NOVT tools with the Imviz display tool in
a custom notebook.

See the `NOVT JDox article <https://jwst-docs.stsci.edu/jwst-other-tools/nirspec-observation-visualization-tool-help>`__
for usage information for the web application.

Installation
------------

It is highly recommended that the user install the NOVT package into a virtual
environment.  For example, use conda to create and activate a virtual environment
before following the installation steps::

    $ conda create -n jwst_novt python
    $ conda activate jwst_novt

Core tools only
~~~~~~~~~~~~~~~

To install the top-level package from source via GitHub::

    $ git clone https://github.com/spacetelescope/jwst_novt
    $ pip install -e jwst_novt


To install via pip::

    $ pip install jwst_novt

Either method will also download and install the required software dependencies.

Core tools + display and interactive tools
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

To install the display and interactive tools along with the base package from
source via GitHub::

    $ git clone https://github.com/spacetelescope/jwst_novt
    $ pip install -e jwst_novt[interact]


Or via pip::

    $ pip install jwst_novt[interact]

Either method will download and install the additional required software dependencies
for the interact module.

License
-------
See `LICENSE.rst` in the `source distribution <https://github.com/spacetelescope/jwst_novt>`__ for more information.


Contributing
------------
See `CONTRIBUTING.md` in the `source distribution <https://github.com/spacetelescope/jwst_novt>`__ for more information.
