WFSC NIRCam Coarse Phasing Template Parameters

JDox will be unavailable from Friday, April 12th, starting at noon through Sunday, April 14th, due to a planned outage. We apologize for any inconvenience.

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.

(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.

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:

FieldDetailsValues Notes
General Information   
Observation Numberassign observation number

number


Observation Label provide observation labeltextoptional
Observation Commentsprovide observation commentstextoptional
Targetselect Target Namechoose from listfrom Target List
Special Requirementsspecify special requirementschoose from listif needed
Template Specific Information   
Expected Number of WFC Commandsspecify Expected Number of WFC Commandsnumber1 - 2100

Module

select ModuleA, B
Primary Dither Typeselect Primary Dither TypeNONE, WFSC
In Focus Imaging Parameters
Configurationdefault valuessee table
Readout Patternselect Readout PatternRAPID, BRIGHT1
Number of Groups/Integrationspecify number of groupsnumber
Number of Integrations/Exposurespecify number of integrationsnumber
DHS Imaging Parameters
Configurationsdefault valuessee table

Readout Pattern

select Readout PatternRAPID, BRIGHT1
Number of Groups/Integrationspecify number of groupsnumber
Number of Integrations/Exposurespecify number of integrationsnumber

Plus/Minus 8 Waves Defocus Imaging Parameters

Configurationsdefault valuessee table
Readout Patternselect Readout PatternRAPID, BRIGHT1
Number of Groups/Integrationspecify number of groupsnumber
Number of Integrations/Exposurespecify number of integrationsnumber

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 

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
StepSW PupilSW FilterLW PupilLW FilterSubarray

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. (warning)The range is 1-10.

Number of Integrations/Exposure

NUMBER OF INTEGRATIONS/EXPOSURE [NINTS] field specifies the number of times the integration is repeated. (warning)The range is 1-10.

DHS Imaging Parameters

Configurations

The following configurations will be used to obtain the data.

DHS Imaging
StepSW PupilSW FilterLW PupilLW FilterSubarray

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. (warning)The range is 1-10.

Number of Integrations/Exposure

NUMBER OF INTEGRATIONS/EXPOSURE [NINTS] field specifies the number of times the integration is repeated. (warning)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
StepSW PupilSW FilterLW PupilLW FilterSubarray

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. (warning)The range is 1-10.

Number of Integrations/Exposure

NUMBER OF INTEGRATIONS/EXPOSURE [NINTS] field specifies the number of times the integration is repeated. (warning)The range is 1-10.

Change log

December 16, 2022

  1. PROPINSTJWST-91148 In Introduction, changed "default" to "required" for SENSING CONTROL.


Version 5(December 8, 2021)

  1. PROPINSTJWST-91490 Added constraint on solar system targets to Target parameter.


Version 4 (February 10, 2021)

  1. PROPINSTJWST-91471 - Added Primary Dither Type section.
  2. PROPINSTJWST-91389 - Added Expected Number of WFC Commands section.


Version 3 (April 19, 2019)

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


Version 2 (August 16, 2018)

  1. PR 90519 - Revised developer note in Introduction section to include Segment Guide Star SR exception.


Version 1 (May 8, 2017)

This is the converted Word File from Chapter 60.