NIRCam PIL Template Parameters
JWST's NIRCam PIL template, available in the Astronomer’s Proposal Tool (APT), is used for calibration observations for the NIRCam instrument.
Introduction
Purple text indicates the parameter is Limited Access.
Boldface italics type indicates the name of an APT parameter or a value for a parameter.
Red text indicates restrictions on a parameter.
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.
These parameters are required to obtain observations with the PIL in the short wavelength beam of Module A or Module B. Note that this type of observation must be executed as a prime, as it requires an external pointing. The special requirement, PARALLEL, therefore, is not allowed.
The NIRCam PIL template consists of the following parameters:
| Field | Details | Values | Notes |
|---|---|---|---|
| General Information | |||
| Observation Number | assign observation number | number | |
| Observation Label | provide observation label | text | optional |
| Observations Comments | provide observation comments | text | optional |
| Target Name | select Target Name | choose from list | from Target List |
| Special Requirements | specify special requirements | choose from list | if needed |
| Template Specific Information | |||
select Module | choose A or B | ||
select Short Filter | choose from list | ||
| Readout Pattern | select readout pattern | choose from list | |
| Number of Groups/Integration | specify number of groups per integration | number | |
| Number of Integrations/Exposure | specify number of integrations per exposure | number | |
General Information
The following parameters are generic to all templates, and are not discussed in this article: Observation Number, Observation Label , Observations Comments, Target Name, and Special Requirements.
Target Name
Select the TARGET NAME [TBD] from the list of targets previously entered (see list of targets).
Module
MODULE [MODULE] = A, B
This parameter specifies the module that is to be used.
Filters
For each exposure, specify the SHORT FILTER, READOUT PATTERN, NUMBER OF GROUPS/INTEGRATION, and NUMBER OF INTEGRATIONS/EXPOSURE.
Short Filter
Select the name of each short wavelength filter [FILTSHORT] you wish to use (see Table 1). There is no limit on the number of filters, but there is a limit of 100 minutes for total exposure time in PIL observations. At 102±1 minutes, the NFSW will autonomously command the ICE to retract the PIL. In the event that NFSW does not issue a command to retract the PIL, at 105±1 minutes the ICE hardware timer will retract the PIL.
Table 1. Filters Available for PIL Imaging
Filters | Filters |
|---|---|
F187N | WLP8+F150W2 |
F212N | WLM8+F150W |
F150W | WLM8+F200W |
| F182M | WLM8+F150W2 |
F200W | MASKRND+F150W |
| F210M | MASKRND+F200W |
F140M | MASKRND+F150W2 |
WLP4 | MASKBAR+F150W |
PINHOLES+F150W | MASKBAR+F200W |
PINHOLES+F200W | MASKBAR+F150W2 |
GDHS0+F140M | MASKIPR+F150W |
GDHS0+F150W2 | MASKIPR+F200W |
GDHS60+F140M | MASKIPR+F150W2 |
GDHS60+F150W2 | F162M+F150W2 |
WLP8+F150W | F164N+F150W2 |
WLP8+F200W |
Readout Pattern
READOUT PATTERN [READOUT PATTERN] = RAPID, BRIGHT1, BRIGHT2, SHALLOW2, SHALLOW4, MEDIUM2, MEDIUM8, MEDIUMDEEP2, MEDIUMDEEP8, DEEP2, DEEP8
This field specifies the readout pattern to be used to obtain the data. MEDIUMDEEP2 and MEDIUMDEEP8 are available for Cycle 4 and later.
Number of Groups/Integration
NUMBER OF GROUPS/INTEGRATION [NGROUPS] specifies the number of groups in an integration. The maximum NUMBER OF GROUPS is 10 for all READOUT PATTERNS except DEEP2 and DEEP8, for which it is 20.
Number of Integrations/Exposure
NUMBER OF INTEGRATIONS/EXPOSURE [NINTS] specifies the number of times the integration is repeated. The maximum value is 10.