NIRSpec MSA Masking Template Parameters

JWST's NIRSpec MSA Masking template, available in the Astronomer’s Proposal Tool (APT), is used to apply one or more masks to the micro-shutter assembly (MSA).


 Format definitions...

Purple text indicates the parameter is Limited Access.

Boldface italics type indicates the name of an APT parameter or a value for a parameter.

(warning)Red text indicates restrictions on a parameter.

(red star) Black text indicates an important note.

Brown text indicates notes for the developers.

Green text indicates the name of the parameter used by Commanding.

Items in brackets - <value> - are required values.

Items in square brackets - [<value>] - are optional.

This engineering feature allows the user to apply a set of zero-potential or tri-state masks to the MSA; one each for the 171-side and the 365-side of the specified quadrants. Masking of multiple quadrants can be done in a single visit by specifying multiple quadrant numbers.

There are implicit special requirements  SPECIAL COMMANDING MSA Short Detection and NO PARALLEL  attached to visits created by this template. In order to prepare the files needed for the special commanding request the commanding staff need to be notified.

The following parameters define MSA Masking.

FieldDetailsValueNotes
General Information
Observation Numberassign observation numbernumber
Observation Labelprovide observation labeltextoptional
Observation Commentsprovide observation commentstextoptional
Special Requirementsspecify special requirementschoose from listif needed
Template specific information
Mask Typeselect a mask typeZERO_POTENTIAL, TRI_STATE
Quadrant Listselect a quadrantchoose from list

 General information  

The following parameters are generic to all templates, and are not discussed in this article: Observation Number, Observation Label, Observation Comments,  and Special Requirements.

Mask Type

MASK TYPE [MASKTYPE] = ZERO_POTENTIAL, TRI_STATE

This parameter specifies the type of mask to update.

Quadrant List

QUADLIST [QUADLIST]QUADRANT 1, QUADRANT 2, QUADRANT 3, QUADRANT 4

This parameter specifies the quadrant(s) to be masked. You may specify one to four unique quadrants. Specifying a list of multiple quadrants will execute the procedure on the quadrants one-by-one in the order specified.

Change log

 Click here to expand...

Version 2 (April 19, 2019)

  1. Editorial change (moved change log to main article)


Version 1 (June 15, 2017)

  1. This is the converted Word File from Chapter 39.