Skip to main content

JWST coronagraphic target observability calculator

Project description

Current version: 0.2.0 (beta).

Download for Mac (24 MB) | Download Python source

This initial release is for user testing and (as with any software) bugs may remain! Report any issues at https://github.com/spacetelescope/jwst_coronagraph_visibility/issues/new or via email to the authors

Authors: Christopher Stark (cstark@stsci.edu), Joseph Long (jlong@stsci.edu)

Screenshot of the JWST Coronagraph Visibility Tool showing target HR 8799 with three companions plotted.

The allowed pointing of JWST leads to target visibility that depends on ecliptic latitude, and the range of roll angles allowed depends on solar elongation. The allowed PAs for a target can thus be a complicated function of time. As a result, it can be difficult to 1) understand the possible orientations of a given target on the detector, 2) determine the ideal roll angle offsets for multi-roll observations, and 3) determine a group of targets that are simultaneously visible. The JWST Coronagraph Visibility Tool (CVT) was created to address these issues and assist with creating APT programs and diagnosing scheduling errors.

We stress that the CVT is designed to provide quick illustrations of the possible observable orientations for a given target. As such, the CVT rapidly approximates JWST’s pointing restrictions and does not query the official JWST Proposal Constraint Generator (PCG). The CVT does not include detailed pointing restrictions like Earth and Moon avoidance, etc. Additionally, results may differ from official constraints by a degree or so. Users should treat the results as close approximations.

Additionally, detector geometry (e.g. conversion from sky coordinates to the instrument’s Idl frame) is provided by the SIAF (Science Image Aperture File). The SIAF is a standardized format for manipulating instrument apertures and coordinate conversions, maintained by STScI as part of operating JWST. As of this writing (April 2016), the code includes its own copies of the PRDDEVSOC-D-012 version of the NIRCam and MIRI SIAFs.

For installation instructions and usage instructions, see the documentation on GitHub or docs/index.rst in this repository.

Known Issues

  • The CVT does not (and will not) query the JWST Proposal Constraint Generator. The only constraint on the field of regard is the Sun and anti-Sun avoidance angle.

  • Target name resolution depends on the availability of the SIMBAD service. If the service cannot be reached, you will have to enter coordinates yourself.

  • The CVT does not currently provide a way to export the plotted points as text. Plots can be saved from the GUI using the save icon below the plot panel.

  • The CVT has only been tested on Mac and Linux. Issue reports from Windows users are welcome, and we will do our best to address them, but we are not testing the tool on Windows.

See issue tracker at https://github.com/spacetelescope/jwst_coronagraph_visibility/issues.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jwst-coronagraph-visibility-0.2.0.tar.gz (2.0 MB view details)

Uploaded Source

Built Distribution

jwst_coronagraph_visibility-0.2.0-py2.py3-none-any.whl (2.1 MB view details)

Uploaded Python 2 Python 3

File details

Details for the file jwst-coronagraph-visibility-0.2.0.tar.gz.

File metadata

File hashes

Hashes for jwst-coronagraph-visibility-0.2.0.tar.gz
Algorithm Hash digest
SHA256 bda1539597ca957d855ce3ed18a3194a7db8f1bca4eae9fe76764d90c0329665
MD5 c8dbc202f160a019b7103374fdb9ad68
BLAKE2b-256 eb3702af63400e20b6e7f10ae09c7c2f24dfc1072c1630bb877585a05229ada2

See more details on using hashes here.

File details

Details for the file jwst_coronagraph_visibility-0.2.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for jwst_coronagraph_visibility-0.2.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 8107181af1e95352eead640c19c9af7a7f811a5a9539a58d58d883699c28886f
MD5 fcc0f5953a914bc92315ba1c0f61f989
BLAKE2b-256 cf55ff5859956a9e94ce91422c3754878e6f2ff3815643ec2ada4ae2cfa8b608

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page