- JWST Cycle 1 Proposal Opportunities
- JWST Cycle 1 Guaranteed Time Observations Call for Proposals
- • JWST Director's Discretionary Early Release Science Call for Proposals
- • JWST Call for Proposals for Cycle 1
- James Webb Space Telescope Call for Proposals for Cycle 1
- •JWST Cycle 1 Proposal Checklist and Resources
- •JWST Cycle 1 Proposal Policies and Funding Support
- JWST Cycle 1 Proposal Categories
- •JWST Cycle 1 Observation Types and Restrictions
- •JWST Cycle 1 Proposal Preparation
- •JWST Cycle 1 Single-Stream Proposal Process
- •JWST Cycle 1 Special Submission Requirements
- •JWST Cycle 1 Observation Mode Restrictions
- •JWST Cycle 1 Proposal Selection Process
- •JWST Cycle 1 Awarded Program Implementation
- •JWST Cycle 1 Proposal Science Categories and Keywords
- JWST General Science Policies
- • JWST Observing Overheads and Time Accounting Policy
- • JWST Duplicate Observations Policy
- • JWST Science Parallel Observation Policies and Guidelines
- • JWST Observing Program Modification Policy
- • Policies for the Telescope Time Review Board
- • JWST Target of Opportunity Program Activation
- NASA-SMD Policies and Guidelines for the Operations of JWST at STScI
- •Policy 1 - Limitations on the Use of Funds for the Research of General Observers and Archival Research
- •Policy 2 - Data Rights and Data Dissemination
- •Policy 3 - Data Requests and Facilities
- •Policy 4 - Post-Launch Commissioning of JWST
- •Policy 5 - Clarification of Extensions of Exclusive Access Data to Public Affairs Activities
- •Policy 6 - Distribution of JWST Science Data Obtained from Investigations Other Than Those Selected Through the Peer-review Process
- •Policy 7 - NASA Needs for Support for Other Missions
- •Policy 8 - Definition of Observing Time
- •Policy 9 - Allocation of Guaranteed Observing Time to Scientists Selected Under AO 01-OSS-05 and Through NASA-ESA-CSA Agreements
- •Policy 10 - Redistribution of Guaranteed Observing Time Among Observers
- •Policy 11 - Protection of Science Programs Associated With Guaranteed Time
- •Policy 12 - Education and Public Outreach
- Methods and Roadmaps
- JWST Imaging
- • JWST Slit Spectroscopy
- • JWST Slitless Spectroscopy
- JWST High-Contrast Imaging
- •Contrast Considerations for JWST High-Contrast Imaging
- •JWST Coronagraphic Observation Planning
- •JWST Coronagraphic Sequences
- •JWST Coronagraphy in ETC
- •JWST High-Contrast Imaging in APT
- •JWST High-Contrast Imaging Inner Working Angle
- •JWST High-Contrast Imaging Optics
- •JWST Small Grid Dither Technique
- •MIRI-Specific Treatment of Limiting Contrast
- •NIRCam-Specific Treatment of Limiting Contrast
- •NIRISS AMI-Specific Treatment of Limiting Contrast
- •Selecting Suitable PSF Reference Stars for JWST High-Contrast Imaging
- JWST Integral Field Spectroscopy
- JWST MOS Spectroscopy
- JWST Time-Series Observations
- •Overview of Time-Series Observation (TSO) Modes
- •Noise Sources for Time-Series Observations
- •Sensitivity of Time-Series Observation Modes
- •Bright limits of Time-Series Observation Modes
- •Preparing Time-Series Observations with JWST
- •Target Acquisition for Time-Series Observations
- •NIRCam-Specific Time-Series Observations
- •NIRISS-Specific Time-Series Observations
- •MIRI-Specific Time-Series Observations
- JWST Moving Target Observations
- •Moving Target Roadmap
- •Field of Regard Considerations for Moving Targets
- •Instrument-Specific Considerations for Moving Targets
- •Moving Target Recommended Strategies
- •JWST Moving Target Observing Procedures
- •JWST Moving Target Calibration and Processing
- •JWST Moving Target Ephemerides
- JWST Moving Targets in APT
- •JWST Moving Targets in ETC
- •JWST Moving Target Useful References and Links
- •Overheads for Moving Targets
- •JWST Moving Target Policies
- NIRSpec IFU and Fixed Slit Observations of Near-Earth Asteroids
- JWST Parallel Observations
- JWST Target of Opportunity Observations
- Observatory Functionality
- • JWST Position Angles, Ranges, and Offsets
- • JWST Instrument Ideal Coordinate Systems
- JWST Background Model
- • JWST Guide Stars
- • JWST Mosaic Overview
- • JWST Dithering Overview
- JWST Duplication Checking
- JWST Observing Overheads and Time Accounting Overview
- •JWST Observing Overheads Summary
- •JWST Slew Times and Overheads
- JWST Instrument Overheads
- Observing Overheads for NIRCam Imaging
- • JWST Data Rate and Data Volume Limits
- Observatory Hardware
- • JWST Observatory Overview
- • JWST Observatory Coordinate System and Field of Regard
- • JWST Field of View
- • JWST Orbit
- JWST Spacecraft Bus
- • JWST Pointing Performance
- • JWST Telescope
- • JWST Wavefront Sensing and Control
- • JWST Momentum Management
- • JWST Integrated Science Instrument Module
- • JWST Solid State Recorder
- • JWST Target Viewing Constraints
- • Fine Guidance Sensor, FGS
- JWST Exposure Time Calculator Overview
- • JWST ETC New User Guide
- JWST ETC Calculations Page Overview
- •JWST ETC Creating a New Calculation
- •JWST ETC Backgrounds
- •JWST ETC Wavelength of Interest/Slice
- •JWST ETC Batch Expansions
- JWST ETC Strategies
- JWST ETC Target Acquisition
- JWST ETC Outputs Overview
- JWST ETC Workbooks Overview
- JWST ETC Pandeia Engine Tutorial
- • JWST ETC Point Spread Functions
- • JWST ETC Instrument Throughputs
- • JWST ETC Residual Flat Field Errors
- • JWST ETC NIRCam Imaging
- Astronomers Proposal Tool
- • JWST Astronomers Proposal Tool Overview
- APT Workflow
- Additional APT Functionality
- Getting Help with APT
- Other Tools
- Mid Infrared Instrument
- • MIRI Overview
- MIRI Observing Modes
- MIRI Instrumentation
- MIRI Operations
- MIRI Target Acquisitions
- MIRI Dithering
- MIRI Mosaics
- •MIRI MRS Simultaneous Imaging
- MIRI Time Series Observations
- MIRI Predicted Performance
- MIRI APT Templates
- MIRI Observing Strategies
- MIRI Example Programs
- •MIRI Coronagraphy of GJ 758 b
- MIRI Imaging, MIRI MRS, and NIRSpec IFU Observations of SN1987A
- •MIRI and NIRCam Coronagraphy of the Beta Pictoris Debris Disk
- •MIRI IFU and NIRSpec Observations of Cas A
- MIRI MRS Spectroscopy of a Late M Star
- MIRI MRS and NIRSpec IFU Observations of Cassiopeia A
- Near Infrared Camera
- • NIRCam Overview
- NIRCam Observing Modes
- NIRCam Instrumentation
- •NIRCam Field of View
- •NIRCam Modules
- •NIRCam Optics
- •NIRCam Dichroics
- •NIRCam Pupil and Filter Wheels
- •NIRCam Filters
- •NIRCam Coronagraphic Occulting Masks and Lyot Stops
- •NIRCam Filters for Coronagraphy
- •NIRCam Grisms
- •NIRCam Weak Lenses
- NIRCam Detectors
- NIRCam Operations
- NIRCam Dithers and Mosaics
- •NIRCam Coronagraphic PSF Estimation
- •NIRCam Coronagraph Astrometric Confirmation Images
- •NIRCam Apertures
- NIRCam Target Acquisition Overview
- NIRCam Predicted Performance
- NIRCam APT Templates
- NIRCam Observing Strategies
- NIRCam Example Programs
- NIRCam Deep Field Imaging with MIRI Imaging Parallels
- NIRCam Imaging and NIRISS WFSS of Galaxies Within Lensing Clusters
- •NIRCam WFSS Deep Galaxy Observations
- •NIRCam and MIRI Coronagraphy of the Beta Pictoris Debris Disk
- •NIRCam Coronagraphy of HR8799 b
- NIRCam Grism Time-Series Observations of GJ 436b
- NIRCam Time-Series Imaging of HAT-P-18 b
- Near Infrared Imager and Slitless Spectrograph
- • NIRISS Overview
- NIRISS Observing Modes
- NIRISS Instrumentation
- NIRISS Operations
- NIRISS Predicted Performance
- NIRISS APT Templates
- NIRISS Observing Strategies
- NIRISS Example Programs
- NIRISS AMI Observations of Extrasolar Planets Around a Host Star
- NIRISS SOSS Time-Series Observations of HAT-P-1
- NIRISS WFSS with NIRCam Parallel Imaging of Galaxies in Lensing Clusters
- Near Infrared Spectrograph
- NIRSpec Overview
- NIRSpec Observing Modes
- NIRSpec Instrumentation
- •NIRSpec Optics
- •NIRSpec Dispersers and Filters
- NIRSpec Detectors
- •NIRSpec Micro-Shutter Assembly
- •NIRSpec Integral Field Unit
- •NIRSpec Fixed Slits
- NIRSpec Operations
- NIRSpec Dithers and Nods
- NIRSpec MOS Operations
- NIRSpec IFU Operations
- •NIRSpec FS Operations
- •NIRSpec BOTS Operations
- NIRSpec Target Acquisition
- NIRSpec Predicted Performance
- NIRSpec APT Templates
- NIRSpec Multi-Object Spectroscopy APT Template
- •NIRSpec MOS Proposal Checklist
- •NIRSpec MSA Planning Tool, MPT
- NIRSpec MPT - Catalogs
- •NIRSpec MPT - Planner
- NIRSpec MPT - Manual Planner
- •NIRSpec MPT - Plans
- •NIRSpec MPT - Parameter Space
- •NIRSpec MSA Spectral Visualization Tool Help
- •NIRSpec Observation Visualization Tool Help
- •NIRSpec IFU Spectroscopy APT Template
- •NIRSpec Fixed Slit Spectroscopy APT Template
- •NIRSpec Bright Object Time-Series APT Template
- •NIRSpec FS and IFU Mosaic APT Guide
- NIRSpec Multi-Object Spectroscopy APT Template
- NIRSpec Observing Strategies
- •NIRSpec Background Recommended Strategies
- •NIRSpec Bright Spoilers and the IFU Recommended Strategies
- •NIRSpec Detector Recommended Strategies
- •NIRSpec Dithering Recommended Strategies
- •NIRSpec MOS Recommended Strategies
- •NIRSpec MSA Leakage Subtraction Recommended Strategies
- •NIRSpec Target Acquisition Recommended Strategies
- NIRSpec Example Programs
- NIRSpec IFU and MIRI MRS Observations of Cassiopeia A
- NIRSpec BOTS Observations of GJ 1214b
- NIRSpec IFU, MIRI Imaging, and MIRI MRS Observations of SN1987A
- NIRSpec IFU and Fixed Slit Observations of Near-Earth Asteroids
- NIRSpec MOS Deep Extragalactic Survey
- •NIRSpec MOS Observations of NGC 346
- •NIRSpec and MIRI IFU Observations of Cas A
- Understanding Data Files
- Obtaining Data
- Data Processing and Calibration Files
- JWST Data Reduction Pipeline
- • Primer and Tutorials
- • Pipeline User's Guide
- • Software Reference Documentation
- Algorithm Documentation
- • Obtaining and Installing Software
The JWST NIRSpec MSA Planning Tool (MPT) Manual Planner is designed to help the user manually create new plans and modify existing plans.
The MSA Planning Tool (MPT) Planner is designed to automatically create optimal plans, but it is also possible for the user to create plans manually. Checking the Manual Planning1 box at the top of the Planner tab of MPT results in the view shown in Figure 1.
The Manual Planning template has four sections that are described in detail below.
- Section 1: Planning Angles
- Section 2: Primary Candidate List
- Section 3: Exposure Setup
- Section 4: Pointing/Config Setup
MPT Section 1. Planning angles
Aperture PA (APA)
A given NIRSpec MSA observation must be executed at a specific telescope orientation angle so that the selected sources will fall into the open shutters as planned. Because of the telescope's orbital position and sunshield constraints, a given orientation may only be possible for limited periods during the year or not available at all. The Target Visibility Tools can be used to determine the range of feasible orientation angles for a target throughout the telescope's orbital cycle.
For most NIRSpec MOS observations, it is recommended to experiment with several different feasible Aperture Position Angles prior to initial proposal submission. The submitted APA is used to create place-holder or "planning visits" with MPT. Once a proposal is accepted, it will be assigned a fixed orientation and a corresponding window of time when observations will be made.
For proposal submission, use any feasible APA from the orientation angles provided by the JWST Target Visibility Tool for the time of observation. For final program submission, use the fixed orientation APA that has been assigned to your observation by the schedulers at STScI. This assigned angle will correspond to one or more plan windows for execution in the scheduling timeline.
The APA (an angle between 0 and 360 degrees) specifies the orientation of the cross-dispersion axis of the MSA aperture measured from North in the counterclockwise direction. Figure 2 shows how this angle is measured on the sky. The "Y" axis represents the cross-dispersion direction of the MSA.
True angle to target
The True angle to target field appears in the Planner, but is greyed out and cannot be changed by the user. This is the angle between the telescope's velocity vector at the center of the planning window and the telescope pointing. It is used to make small corrections to source positions at the MSA resulting from the velocity of the spacecraft.
The True angle to target offers a quick way to check target visibility: its value will not update if the selected APA is not feasible.
MPT Section 2. Primary Candidate List
The Primary Candidate List is a candidate set that should be defined in the NIRSpec MPT - Catalogs pane. In manual planning mode, select the appropriate list from the pull down menu.
MPT Section 3. Exposure setup
In section 3 of the Manual Planner the observer defines the exposure specification. Click the ADD button to add a new exposure specification. Each new exposure specification results in one or more new exposures. The number of new exposures resulting from an exposure specification is determined by the dither pattern specified.
The JWST Exposure Time Calculator (ETC) should be used to determine the best exposure parameters to optimize the signal-to-noise of your observation. An exposure is configured by setting the Grating/Filter combination, Readout Pattern, Number of Groups, and Number of Integrations.
Users should ultimately use the JWST Exposure Time Calculator for all sensitivity calculations.
The exposure parameters that the observer needs to define are listed in Table 1.
Table 1. Description of Science Parameters for a given exposure
|Grating/Filter||Select a grating/filter combination from the pull down menu. The article NIRSpec Dispersers and Filters describes all the available combinations for NIRSpec observing modes.|
Each exposure consists of a set of one or more integrations. Integrations consists of a set of nondestructive reads of the detector.
The detectors can be read in different ways. The available patterns are NRS, NRSRAPID, NRSIRS2, and NRSIRS2RAPID. These patterns are described in full detail in the article NIRSpec Detector Readout Modes and Patterns. The default pattern is NRS, which will average 4 frames on board (i.e. there are 4 frames in one Group).
Select the pattern that best suits your observation.
The number of groups in an integration. The number of groups, together with the Readout Pattern (i.e. the number of frames in a group) will determine the length or duration of an integration, using the specified options for averaging or not averaging frames.
|Integrations/Exp||The number of integrations comprising an exposure, where an integration is defined as a set of non-destructive reads.|
|Autocal||This option is available to automatically add calibration exposures to a science exposure. For the MOS, the options are NONE, WAVECAL, FLAT, and BOTH. NONE is the default and is recommended.|
|ETC Wkbk.Calc ID||The user should enter the ETC calculation ID from the associated ETC Workbook. See note below.|
Exposure specifications may be reorganized or removed as needed, using the New, Copy and Link, and Remove buttons, and the arrows at the left of the 'Exposure Setup' box. Each exposure specification will be used for each of the Pointing and Configurations specified below.
MPT Section 4. Pointing/Config setup
Configurations and Pointings
NIRSpec MSA configurations are described by a configuration file. Those configurations can be created with the Manual Planner as described below, or ingested to the Manual Planner from the automatic MPT Planner. It is possible to save a configuration off-line by exporting it from APT. A configuration file may also be imported into APT using the MPT Manual Planner. The only format supported for importing or exporting an MSA configuration file is comma-separated values (.csv).
Click New, Copy and Link, and/or Remove (as shown in Section 4 of Figure 1) to create or delete the configurations you want. New will create a new MSA configuration entry in the next row of the table. Table rows can be rearranged using the up and down arrows to the left of the table. Copy and Link can be used to make a copy of an existing configuration (first select the entry you want to copy).
Caution! Any changes made to the configuration (including renaming it) will apply to all table entries using that configuration.
Copy and Link is provided for users who wish to create a set of offset exposures from a Base Pointing, and to save overheads by linking them as a set of dithers applied to the base pointing. The Base Pointing, Dispersion Offset, and Cross-Dispersion Offset columns can be edited directly in this table. Offsets are in units of shutters.
By clicking on Edit config in the right column of a table entry, a window will pop open displaying the MSA shutter view for the selected MSA configuration. This window is the Manual Editor.
As an example, to create a set of nodded exposures that use the same MSA configuration in the Manual Planner -
- Click New to generate a new MSA configuration.
- Type in the base pointing.
- Type in "0.0" for the dispersion and cross-dispersion offsets.
- Click Copy and Link twice to create two new entries in the table. These will use the same MSA configuration as the first entry.
- Edit the second entry cross-dispersion offset to have a value of 1.0 (exactly 1 shutter up from the base pointing).
- Edit the third entry cross-dispersion offset to have a value of -1.0 (exactly 1 shutter down from the base pointing).
- Click Edit config in the right column of the first table entry (at the base pointing). Wait for the Manual Editior window to appear.
- Create the configuration you want by opening or closing shutters in the Manual Editor.
- When finished, click OK.
- To save this new Plan, give the plan a unique name, and click Finish Plan at the bottom of the main Planner window.
Manually editing a configuration
When the Manual Editor is open, the shutter view is presented with the sources of the candidate list used to generate the configuration, as shown in Figure 3. Other lists may be displayed by selecting them from the Parameters tab of this window. Note that all sources appear as black plus symbols in the Manual Editor, whether they are in configured slitlets or not.
It is possible to zoom in to view individual shutters in the Manual Editor. Zooming in or out is accomplished by depressing the right mouse button while dragging up or down. This is usually enabled on a trackpad by depressing two fingers at once and dragging in an upward or downward motion. Hovering the mouse over a single micro-shutter provides its position in the MSA and its state (commanded open or closed, stuck open or closed, etc.)
Individual operable shutters may be commanded opened or closed with a "Left Click" on the mouse. Also available are the Open all and Close all buttons. The metadata for each open shutter is tracked during load, so opening all shutters in the Manual Editor will be slow and is not recommended for casual use. The Manual Editor should be used to open shutters that correspond to sources of interest, as shown in Figure 4. There is a shortcut to make a long slit configuration: point the mouse at a column of shutters, and use "Ctrl+Left Click" to open (or close) the column of shutters.
For users who wish to observe moving targets with a long slit configuration at one of the Quadrant 4 Field Points in the MOS Spectroscopy template using WATA, columns can be opened in the following locations:
- Q4 Field Point 1 corresponds to shutter q4d615s196
- Q4 Field Point 2 corresponds to shutter q4d533s244
The MOS Custom Configuration Process article describes the process for extended sources.
Note that shutters open on sources will be designated as source shutters, and others are interpreted as background shutters (for Data Management System (DMS) pipeline calibration). There is currently no mechanism in APT for a user to specify a shutter without a source as a source shutter for DMS purposes (for extended sources, e.g.). Custom MSA configurations planned without the use of a Catalog will currently fail to be processed correctly. A fix is expected in APT 27.2.
Options exist to export and import MSA configurations. These options, however, are intended for expert users who wish to manipulate MSA configurations outside of APT. The MSA can only be configured after applying corrections to source positions at the MSA affected by instrument and telescope geometric distortions. A completed MSA configuration can be exported using the Export to CSV button. One can be imported with the Import CSV button. Export to CSV produces an ASCII file of comma-separated values that can be shared and imported into the Manual Planner with Import CSV. The exported CSV file has values of '0', '1', 's', or 'x' for each commanded open, commanded closed, failed open, or failed closed shutter, respectively. Additionally, an image of the configuration can be saved in SVG format.
APT files themselves can be shared; this is the best way to share plans and configuration details. At the bottom of this article is a tip for saving the target info from a plan to a table that can be exported and examined outside of APT. This format is more accessible and useful for tracking observed target information.
Continuing with the Manual Editor window features - three tabs are located at the bottom of the window: Pointing, Parameters, and Collapsed.
Under the Pointing tab (Figure 5) it is possible to give a name to the configuration, and specify appropriate pointing equatorial coordinates. Base Pointing RA and Dec values are required before the MSA configuration can be saved. If other MSA configurations have already been designed, their Pointing and Configuration will be available from the pull-down menus Copy Existing Pointing and Copy Existing Configuration. If the Base Pointing coordinates are within the Catalog area, the source positions from the Catalog will appear in the shutter view.
Under the Parameters tab, a Candidate set must be selected, even for plans generated with the Manual Planner. This implies that a Catalog is required as well. To further ensure that the standard calibration pipeline will not fail, there must be targets in planned slits. Figure 6 shows a detail of the Parameters tab design.
From the Parameters tab:
- The candidate set can be changed by selecting from the Candidates pull-down menu to show the positions of other sources near the sources of interest.
- The Master Background button, when selected, makes it possible to open scattered shutters in the MSA on areas of the sky that will be used for background measurement and subtraction from target spectra.
- The Add shutters plane to Aladin button will display the slitlets of each target in the Aladin viewer. When returning from Aladin to the main APT window, remember to click 'Form Editor' in APT to see the normal Manual Planner view.
The Collapsed tab view (Figure 7) shows each target's position in its own shutter, all plotted together in a single virtual shutter. The Source Centering Constraint is selectable, and though it has no effect by itself, it can be used to identify which planned sources fall outside the margin of interest. These shutter constraints are described in the NIRSpec MPT - Planner.
Finally, to confirm and accept this new configuration, click the OK button at the bottom of the Manual Editor window. This will return you to the Manual Planner view in APT, shown in Figure 1.
Generating a plan
Under Plan Name in the main window of the Manual Planner, assign a name to this manual plan and click Finish Plan. This will process and generate the plan and direct the user to the Plans pane of MPT, where it is possible to review and assess the quality of the plan.
After the Plan is saved, and an Observation is created from it, there is also a mechanism for saving the planned target info from exposures made with the Manual Planner or those automatically-generated using the MPT. The target positions, pointing, and shutter information can be saved to a .csv file. To do so, click on the "File" item from the main menu at the very top of the computer screen. From the pull-down menu, select Export → MSA Target Info. This mechanism makes it possible to track target coverage through all exposures of an Observation outside of APT. These files are ASCII and readable by Excel, for example.
Karakla, D. et al. 2014, Proc. SPIE 9149
The NIRSpec MSA Planning Tool for multi-object spectroscopy with JWST
This page has no comments.