WFSC NIRCam Coarse Phasing Template Parameters
The NIRCam Coarse Phasing Template, available in the Astronomer’s Proposal Tool (APT), is used to define WFSC Coarse NIRCam Phasing Operations.
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.
The following parameters are used to define Wavefront Sensing and Control Coarse NIRCam Phasing Operations. A Wavefront Control File (provided by the WFSC Scientist) containing 3 mirror control groups must be uploaded prior to the execution of a Coarse Phasing visit.
Coarse Phasing measurements consist of a series of steps that collect NIRCam images of an isolated star, interspersed with mirror control groups. Each imaging step within the series consists of two exposures which may optionally be separated by a small (few pixel) dither. There are three types of exposures: In-focus Imaging, DHS Imaging, and Plus/Minus 8 Defocus Imaging. All the exposures of a given type use the same exposure parameters, and all three types of exposures must be specified.
In addition to the following template parameters, this template will have the Special Requirement WAVEFRONT SENSING added with a default required value of SENSING_CONTROL , and DMS PRIORITY with a value of ELEVATED .
This template cannot be used in parallel and cannot have parallels attached.
Note for developers: the default PCS MODE should be TRACK. If the user overrides this value, a warning should be given, unless the SEGMENT GUIDE STAR special requirement is used.
The NIRCam Coarse Phasing 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 |
| Observation Comments | provide observation comments | text | optional |
| Target | select Target Name | choose from list | from Target List |
| Special Requirements | specify special requirements | choose from list | if needed |
| Template Specific Information | |||
| Expected Number of WFC Commands | specify Expected Number of WFC Commands | number | 1 - 2100 |
| select Module | A, B | ||
| Primary Dither Type | select Primary Dither Type | NONE, WFSC | |
| In Focus Imaging Parameters | |||
| Configuration | default values | see table | |
| Readout Pattern | select Readout Pattern | RAPID, BRIGHT1 | |
| Number of Groups/Integration | specify number of groups | number | |
| Number of Integrations/Exposure | specify number of integrations | number | |
| DHS Imaging Parameters | |||
| Configurations | default values | see table | |
| select Readout Pattern | RAPID, BRIGHT1 | ||
| Number of Groups/Integration | specify number of groups | number | |
| Number of Integrations/Exposure | specify number of integrations | number | |
Plus/Minus 8 Waves Defocus Imaging Parameters | |||
| Configurations | default values | see table | |
| Readout Pattern | select Readout Pattern | RAPID, BRIGHT1 | |
| Number of Groups/Integration | specify number of groups | number | |
| Number of Integrations/Exposure | specify number of integrations | number | |
General Information
The following parameters are generic to all templates, and are not discussed in this article: Observation Number, Observation Label, Observation Comments, Target Name, and Special Requirements.
Target
Select the TARGET NAME from the list of targets previously entered. If a solar system target is selected, APT shows a warning.
Expected Number of WFC Commands
EXPECTED NUMBER OF WFC COMMANDS = 1 - 2100
The number of WFC commands expected with this proposal. Default is 170.
Module
MODULE [MODULE] = A, B
This parameter specifies the MODULE to be used to obtain the data.
Primary Dither Type
PRIMARY DITHER TYPE = NONE, WFSC (default)
Select the dither type for this observation. The WFSC dither type is specified in the NircamImagingSubpixel table in the PRD (future link to PRD).
In-Focus Imaging Parameters
Configuration
The following configuration will be used to obtain the data.
| In-Focus Imaging | |||||
|---|---|---|---|---|---|
| Step | SW Pupil | SW Filter | LW Pupil | LW Filter | Subarray |
1 | CLEAR | F212N | F405N | F444W | SUB96DHSPILx |
For Subarray, x = A or B, based on the Module selected.
Exposure Specifications
For each exposure to be executed, specify the READOUT PATTERN, NUMBER OF GROUPS/INTEGRATION, and NUMBER OF INTEGRATIONS/EXPOSURE.
Readout Pattern
READOUT PATTERN [READOUT PATTERN] = RAPID, BRIGHT1
This field specifies the readout pattern to be used to obtain the data.
Number of Groups/Integration
NUMBER OF GROUPS/INTEGRATION [NGROUPS] specifies the number of groups in an integration. The range is 1-10.
Number of Integrations/Exposure
NUMBER OF INTEGRATIONS/EXPOSURE [NINTS] field specifies the number of times the integration is repeated. The range is 1-10.
DHS Imaging Parameters
Configurations
The following configurations will be used to obtain the data.
| DHS Imaging | |||||
|---|---|---|---|---|---|
| Step | SW Pupil | SW Filter | LW Pupil | LW Filter | Subarray |
2 | GDHS0 | F150W2 | F405N | F444W | FULL |
3 | Execute WFC File group 1 | ||||
4 | GDHS0 | F150W2 | F405N | F444W | FULL |
5 | Execute WFC file group 2 | ||||
6 | GDHS60 | F150W2 | F405N | F444W | FULL |
7 | Execute WFC file group 3 | ||||
8 | GDHS60 | F150W2 | F405N | F444W | FULL |
Exposure Specifications
For each exposure to be executed, specify the READOUT PATTERN, NUMBER OF GROUPS/INTEGRATION, and NUMBER OF INTEGRATIONS/EXPOSURE.
Readout Pattern
READOUT PATTERN [READOUT PATTERN] = RAPID, BRIGHT1
This field specifies the readout pattern to be used to obtain the data.
Number of Groups/Integration
NUMBER OF GROUPS/INTEGRATION [NGROUPS] specifies the number of groups in an integration. The range is 1-10.
Number of Integrations/Exposure
NUMBER OF INTEGRATIONS/EXPOSURE [NINTS] field specifies the number of times the integration is repeated. The range is 1-10.
Plus/Minus 8 Waves Defocus Imaging Parameters
Configurations
The following configurations will be used to obtain the data.
| Plus/Minus 8 waves defocus Imaging | |||||
|---|---|---|---|---|---|
| Step | SW Pupil | SW Filter | LW Pupil | LW Filter | Subarray |
9 | WLP8 | F212N | F405N | F444W | FULL |
10 | WLM8 | F212N | F405N | F444W | FULL |
Exposure Specifications
For each exposure to be executed, specify the READOUT PATTERN, NUMBER OF GROUPS/INTEGRATION, and NUMBER OF INTEGRATIONS/EXPOSURE.
Readout Pattern
READOUT PATTERN [READOUT PATTERN] = RAPID, BRIGHT1
This field specifies the readout pattern to be used to obtain the data.
Number of Groups/Integration
NUMBER OF GROUPS/INTEGRATION [NGROUPS] specifies the number of groups in an integration. The range is 1-10.
Number of Integrations/Exposure
NUMBER OF INTEGRATIONS/EXPOSURE [NINTS] field specifies the number of times the integration is repeated. The range is 1-10.