Reference File
The msaflagopen
step uses a MSAOPER reference file.
MSAOPER Reference File
- REFTYPE:
MSAOPER
- Data model:
N/A
The MSAOPER reference file contains a list of failed MSA shutters and their failure state (stuck open, stuck closed, etc.)
Reference Selection Keywords for MSAOPER
CRDS selects appropriate MSAOPER references based on the following keywords. MSAOPER is not applicable for instruments not in the table. All keywords used for file selection are required.
Instrument |
Keywords |
---|---|
NIRSpec |
INSTRUME, EXP_TYPE, DATE-OBS, TIME-OBS |
Standard Keywords
The following table lists the keywords that are required to be present in all reference files. The first column gives the FITS keyword names. The second column gives the jwst data model name for each keyword, which is useful when using data models in creating and populating a new reference file. The third column gives the equivalent meta tag in ASDF reference file headers, which is the same as the name within the data model meta tree (second column).
FITS Keyword |
Data Model Name |
ASDF meta tag |
---|---|---|
AUTHOR |
model.meta.author |
author |
DATAMODL |
model.meta.model_type |
model_type |
DATE |
model.meta.date |
date |
DESCRIP |
model.meta.description |
description |
FILENAME |
model.meta.filename |
N/A |
INSTRUME |
model.meta.instrument.name |
instrument: {name} |
PEDIGREE |
model.meta.pedigree |
pedigree |
REFTYPE |
model.meta.reftype |
reftype |
TELESCOP |
model.meta.telescope |
telescope |
USEAFTER |
model.meta.useafter |
useafter |
NOTE: More information on standard required keywords can be found here: Standard Required Keywords
Type Specific Keywords for MSAOPER
In addition to the standard reference file keywords listed above, the following keywords are required in MSAOPER reference files, because they are used as CRDS selectors (see Reference Selection Keywords for MSAOPER):
Keyword |
Data Model Name |
---|---|
EXP_TYPE |
model.meta.exposure.type |
Reference File Format
The MSAOPER reference files are json format.
The fields are:
- title:
Short description of the reference file
- reftype:
Should be “MSAOPER”
- pedigree:
Should be one of “DUMMY”, “GROUND” or “INFLIGHT”
- author:
Creator of the file
- instrument:
JWST Instrument; should be “NIRSPEC”
- exp_type:
EXP_TYPEs this file should be used with; should be “NRS_IFU|NRS_MSASPEC”
- telescope:
Should be “JWST”
- useafter:
Exposure datetime after which this file is applicable
- descrip:
Description of reference file
- msaoper:
- Q:
Quadrant; should be an integer 1-4
- x:
x location of shutter (integer, 1-indexed)
- y:
y location of shutter (integer, 1-indexed)
- state:
state of shutter; should be “closed” or “open”
- TA state:
TA state of shutter; should be “closed” or “open”
- Internal state:
Internal state of shutter; should be “closed”, “normal” or “open”
- Vignetted:
Is the shutter vignetted? Should be “yes” or “no”
- history:
Description of the history relevant to this file; might point to documentation