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 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 and
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 or
Imviz).
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 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.