AstrometricCalibration Data Product#
FITS HDU Structure#
Image HDU 1D array: (c); c is an array of calibration measurements of the following lengths: (boresight: length 2 (RA, DEC), plate scale: length 1 (float), north angle: length 1 (float), average offset: length 2 (floats) of average boresight offset in RA/DEC [deg], distortion coeffs: length dependent on order of polynomial fit but the last value should be an int describing the polynomial order). Image HDU 3D array for (frames,row,col): (f=varies with number of input images, r=varies with CFAM, c=varies with CFAM) ERR HDU array: (1,c) DQ HDU array: (c) Below is an example.
Index |
Name |
Datatype |
Array Size |
|---|---|---|---|
0 |
Primary |
None |
0 |
1 |
Image |
float64 |
(39,) |
2 |
ERR |
float64 |
(1, 39) |
3 |
DQ |
uint16 |
(39,) |
Header#
Primary Header (HDU 0)#
Keyword |
Datatype |
Example Value |
Description |
|---|---|---|---|
SIMPLE |
bool |
True |
conforms to FITS standard |
BITPIX |
int |
8 |
array data type |
NAXIS |
int |
0 |
number of array dimensions |
EXTEND |
bool |
True |
Denotes FITS extensions |
VISITID |
str |
-999 |
Visit ID |
CDMSVERS |
str |
331 |
CDMS pipeline build |
FSWDVERS |
str |
1.1.3 |
Version of CGI FSW dictionaries |
TELESCOP |
str |
ROMAN |
Telescope name |
INSTRUME |
str |
CGI |
Instrument designation |
DETECTOR |
str |
EXCAM |
Name of the detector |
ORIGIN |
str |
DRP |
The Science Support Center at Caltech/IPAC |
FILETIME |
str |
2026-02-20T04:32:39.090345+… |
Time of file creation |
DATAVERS |
int |
1 |
Data file version |
PROGNUM |
str |
-999 |
Program Number |
EXECNUM |
str |
-999 |
Execution Plan Number |
CAMPAIGN |
str |
-999 |
Campaign Number |
SEGMENT |
str |
-999 |
Segment Number |
OBSNUM |
str |
-999 |
Observing Scenario Number |
VISNUM |
str |
-999 |
Visit Number |
CPGSFILE |
str |
-999 |
Associated Campaign-level XML file |
AUXFILE |
str |
-999 |
Associated AUX file |
VISTYPE |
str |
-999 |
Visit File type |
OBSNAME |
str |
-999 |
User-defined label |
TARGET |
str |
-999 |
Name of pointing target |
RA |
float |
-999.0 |
Right Ascension |
DEC |
float |
-999.0 |
Declination |
EQUINOX |
float |
2000.0 |
J2000 |
RAPM |
float |
-999.0 |
RA proper motion |
DECPM |
float |
-999.0 |
Dec proper motion |
ROLL |
float |
-999.0 |
Telescope Roll orientation |
PITCH |
float |
-999.0 |
Telescope Pitch orientation |
YAW |
float |
-999.0 |
Telescope Yaw orientation |
PSFREF |
str |
N/A |
T/F target is a PSF reference |
OPGAIN |
str |
-999 |
Planned EXCAM EM gain or ‘AUTO’ |
PHTCNT |
str |
-999 |
T/F Photon counting mode or ‘AUTO’ |
FRAMET |
str |
-999 |
Planned exposure time or ‘AUTO’ |
FILENAME |
str |
cgi_0089001001001001027_202… |
The name of the file |
MOCK |
bool |
True |
Only used for simulated data examples |
PA_V3 |
float |
-999.0 |
Observatory position angle |
PA_APER |
float |
-999.0 |
Position angle in the CGI aperture |
SVB_1 |
float |
-999.0 |
Sun unit vector in the body frame axis 1 |
SVB_2 |
float |
-999.0 |
Sun unit vector in the body frame axis 2 |
SVB_3 |
float |
-999.0 |
Sun unit vector in the body frame axis 3 |
WBJ_1 |
float |
-999.0 |
S/C angular momentum axis 1 |
WBJ_2 |
float |
-999.0 |
S/C angular momentum axis 2 |
WBJ_3 |
float |
-999.0 |
S/C angular momentum axis 3 |
Image Header (HDU 1)#
Keyword |
Datatype |
Example Value |
Description |
|---|---|---|---|
XTENSION |
str |
IMAGE |
Image extension |
BITPIX |
int |
-64 |
array data type |
NAXIS |
int |
1 |
number of array dimensions |
NAXIS1 |
int |
39 |
Raw data axis 1 size |
PCOUNT |
int |
0 |
number of parameters |
GCOUNT |
int |
1 |
number of groups |
BUNIT |
str |
-999 |
Physical unit of the array (brightness unit) |
ARRTYPE |
str |
SCI |
Whether it is the smaller SCI frame or full ENG frame |
SCTSRT |
str |
2024-03-08T07:02:57.172 |
Spacecraft timestamp of first packet for this image frame in UTC |
SCTEND |
str |
2024-03-08T07:03:00.147 |
Spacecraft timestamp of last packet for this image frame in UTC |
STATUS |
int |
0 |
Housekeeping packet health check status |
HVCBIAS |
int |
0 |
HV Clock bias |
OPMODE |
str |
RESERVED |
EXCAM readout operational mode |
EXPTIME |
float |
-999.0 |
Exposing stage duration (seconds) |
EMGAIN_C |
float |
-999.0 |
Commanded gain |
UNITYG |
int |
0 |
DAC value corresponding to unity gain |
EMGAINA1 |
float |
-0.065984 |
Gain voltage conversion coefficient A1 |
EMGAINA2 |
float |
264.89 |
Gain voltage conversion coefficient A2 |
EMGAINA3 |
float |
0.0030209 |
Gain voltage conversion coefficient A3 |
EMGAINA4 |
float |
0.027807 |
Gain voltage conversion coefficient A4 |
EMGAINA5 |
float |
-1.7636e-05 |
Gain voltage conversion coefficient A5 |
GAINTCAL |
float |
-95.0 |
Gain calc temperature calibration point |
EXCAMT |
float |
-88.14958 |
EXCAM temperature |
EMGAIN_A |
float |
-1.0 |
Actual gain |
KGAINPAR |
float |
-999.0 |
Scaling factor convert DN to electrons (e-/DN) |
BLNKTIME |
float |
-999.0 |
commanded blanking (seconds) |
BLNKCYC |
int |
-999 |
commanded blanking (cycles) |
EXPCYC |
int |
-999 |
Exposing stage duration (cycles) |
OVEREXP |
int |
-999 |
over-illumination flag |
NOVEREXP |
float |
-999.0 |
Number of pixels overexposed /100 |
ISPC |
int |
0 |
Photon counting mode 0 or 1 (telemetered) |
PROXET |
float |
-999.0 |
Thermal strap I/F, EXCam ProxE heater |
FCMLOOP |
str |
-999 |
Control state FCM loop |
FCMPOS |
float |
-999.0 |
Last known position of coarse FCM stage |
FSMINNER |
str |
-999 |
Control state FSM inner loop |
FSMLOS |
str |
-999 |
Control state FSM LOS loop |
FSMPRFL |
str |
-999 |
FSM profile |
FSMRSTR |
int |
-999 |
FSM Raster 0 (False) 1 (True) 2 (Unknown) |
FSMSG1 |
float |
-999.0 |
Fast Steering Mirror SG1 Avg (V) |
FSMSG2 |
float |
-999.0 |
Fast Steering Mirror SG2 Avg (V) |
FSMSG3 |
float |
-999.0 |
Fast Steering Mirror SG3 Avg (V) |
FSMX |
float |
-999.0 |
Fast Steering Mirror X Avg (mas) |
FSMY |
float |
-999.0 |
Fast Steering Mirror Y Avg (mas) |
EACQ_ROW |
float |
-999.0 |
Desired pixel row for acquisition |
EACQ_COL |
float |
-999.0 |
Desired pixel col for acquisition |
SB_FP_DX |
float |
-999.0 |
X pix offset from EXCAM center, FPAM alignment |
SB_FP_DY |
float |
-999.0 |
Y pix offset from EXCAM center, FPAM alignment |
SB_FS_DX |
float |
-999.0 |
X pix offset from EXCAM center, FSAM alignment |
SB_FS_DY |
float |
-999.0 |
Y pix offset from EXCAM center, FSAM alignment |
DMZLOOP |
str |
-999 |
Control state DM zernike loop |
1SVALID |
int |
-999 |
1 sec derived values are valid |
Z2AVG |
float |
-999.0 |
Z2 (tip) average averaged across input frames |
Z2RES |
float |
-999.0 |
Average Z2 (tip) residual averaged across input |
Z2VAR |
float |
-999.0 |
Variance Z2 (tip) across input frames |
Z3AVG |
float |
-999.0 |
Z3 (tilt) average averaged across input frames |
Z3RES |
float |
-999.0 |
Average Z3 (tilt) residual averaged across inpu |
Z3VAR |
float |
-999.0 |
Variance Z3 (tilt) across input frames |
10SVALID |
int |
-999 |
10 sec derived values are valid |
Z4AVG |
float |
-999.0 |
Z4 (Focus) coeff for 10000 frames |
Z4RES |
float |
-999.0 |
Z4 (Focus) coeff res for 10000 frames |
Z5AVG |
float |
-999.0 |
Z5 (Astigmatism) coeff for 10000 frames |
Z5RES |
float |
-999.0 |
Z5 (Astigmatism) coeff res for 10000 frames |
Z6AVG |
float |
-999.0 |
Z6 (Astigmatism) coeff for 10000 frames |
Z6RES |
float |
-999.0 |
Z6 (Astigmatism) coeff res for 10000 frames |
Z7AVG |
float |
-999.0 |
Z7 (Coma) coeff for 10000 frames |
Z7RES |
float |
-999.0 |
Z7 (Coma) coeff res for 10000 frames |
Z8AVG |
float |
-999.0 |
Z8 (Coma) coeff for 10000 frames |
Z8RES |
float |
-999.0 |
Z8 (Coma) coeff res for 10000 frames |
Z9AVG |
float |
-999.0 |
Z9 (Trefoil) coeff for 10000 frames |
Z9RES |
float |
-999.0 |
Z9 (Trefoil) coeff res for 10000 frames |
Z10AVG |
float |
-999.0 |
Z10 (Trefoil) coeff for 10000 frames |
Z10RES |
float |
-999.0 |
Z10 (Trefoil) coeff res for 10000 frames |
Z11AVG |
float |
-999.0 |
Z11 (Spherical) coeff for 10000 frames |
Z11RES |
float |
-999.0 |
Z11 (Spherical) coeff res for 10000 frames |
Z12AVG |
float |
-999.0 |
Z12 (Flux ref) coeff for 10000 frames |
Z13AVG |
float |
-999.0 |
Z13 (Shear X) coeff for 10000 frames |
Z14AVG |
float |
-999.0 |
Z14 (Shear Y) coeff for 10000 frames |
SPAM_H |
float |
-999.0 |
SPAM micron +H |
SPAM_V |
float |
-999.0 |
SPAM micron +V |
SPAMNAME |
str |
-999 |
closest named position |
SPAMSP_H |
float |
-999.0 |
set point for named position |
SPAMSP_V |
float |
-999.0 |
set point for named position |
FPAM_H |
float |
-999.0 |
FPAM micron +H |
FPAM_V |
float |
-999.0 |
FPAM micron +V |
FPAMNAME |
str |
-999 |
closest named position |
FPAMSP_H |
float |
-999.0 |
set point for named position |
FPAMSP_V |
float |
-999.0 |
set point for named position |
LSAM_H |
float |
-999.0 |
LSAM micron +H |
LSAM_V |
float |
-999.0 |
LSAM micron +V |
LSAMNAME |
str |
-999 |
closest named position |
LSAMSP_H |
float |
-999.0 |
set point for named position |
LSAMSP_V |
float |
-999.0 |
set point for named position |
FSAM_H |
float |
-999.0 |
FSAM micron +H |
FSAM_V |
float |
-999.0 |
FSAM micron +V |
FSAMNAME |
str |
-999 |
closest named position |
FSAMSP_H |
float |
-999.0 |
set point for named position |
FSAMSP_V |
float |
-999.0 |
set point for named position |
CFAM_H |
float |
-999.0 |
CFAM micron +H |
CFAM_V |
float |
-999.0 |
CFAM micron +V |
CFAMNAME |
str |
-999 |
closest named position |
CFAMSP_H |
float |
-999.0 |
set point for named position |
CFAMSP_V |
float |
-999.0 |
set point for named position |
DPAM_H |
float |
-999.0 |
DPAM micron +H |
DPAM_V |
float |
-999.0 |
DPAM micron +V |
DPAMNAME |
str |
-999 |
closest named position |
DPAMSP_H |
float |
-999.0 |
set point for named position |
DPAMSP_V |
float |
-999.0 |
set point for named position |
DATETIME |
str |
-999 |
TAI Time of preceding 1Hz HK packet |
FTIMEUTC |
str |
-999 |
Frame time at readout (UTC) |
DATALVL |
str |
CAL |
Data level: ‘L1’, ‘L2a’, L2b’, ‘L3’, ‘L4’, ‘TDA’, ‘CAL’ |
MISSING |
int |
0 |
Flagged if header keywords are missing |
FRMTYPE |
str |
NUM |
Specifies which frame collection routine was used based on instrument EVRs |
ISHOWFSC |
int |
0 |
Denotes whether the frames are collected as a part of the HOWFSC loop. |
ISACQ |
int |
0 |
Denotes whether this frame was taken during acquisition |
SPBAL |
int |
0 |
Denotes whether this frame was taken during speckle balance |
ISFLAT |
int |
0 |
Denotes whether this frame was taken during the AAC flat activity |
SATSPOTS |
int |
0 |
Denotes whether the frame contains satellite spots based on a combination of visit type and EXCAM collection command |
MJDSRT |
float |
60722.0 |
Exposure start time (MJD) |
MJDEND |
float |
60722.00069 |
Exposure end time (MJD) |
FILE0 |
str |
cgi_0089001001001001027_202… |
File name for the n-th science file used |
DESMEAR |
bool |
True |
Desmearing used in L1→L2a pipeline (0/1) |
CTI_CORR |
bool |
False |
CTI correction applied to frame (0/1) |
IS_BAD |
bool |
False |
Frame deemed bad (0/1) |
FWC_PP_E |
float |
-999.0 |
Full well capacity, EM gain register (e-) |
FWC_EM_E |
float |
-999.0 |
Full well capacity, image area pixel (e-) |
SAT_DN |
float |
-999.0 |
DN saturation |
RECIPE |
str |
{“name”: “l2b_to_boresight”… |
DRP recipe and steps; paths to noise maps, calib |
DRPVERSN |
str |
3.1 |
corgidrp version that produced this file |
DRPCTIME |
str |
2026-02-20T04:32:39.295 |
When this file was saved |
KGAIN_ER |
float |
0.0 |
Kgain error |
RN |
float |
-999.0 |
Read noise (e-) |
RN_ERR |
float |
-999.0 |
Read noise uncertainty (e-) |
FRMSEL01 |
float |
1.0 |
Bad Pixel Fraction < This Value. Doesn’t includ |
FRMSEL02 |
bool |
False |
Are we selecting on the OVEREXP flag? |
FRMSEL03 |
float |
-999.0 |
tip rms (Z2VAR) threshold |
FRMSEL04 |
float |
-999.0 |
tilt rms (Z3VAR) threshold |
FRMSEL05 |
float |
-999.0 |
tip bias (Z2RES) threshold |
FRMSEL06 |
float |
-999.0 |
tilt bias (Z3RES) threshold |
STAR1 |
str |
-999 |
Position of astrometric reference star 1 (x,y pixels) |
STAR2 |
str |
-999 |
Position of astrometric reference star 2 (x,y pixels) |
STAR3 |
str |
-999 |
Position of astrometric reference star 3 (x,y pixels) |
STAR4 |
str |
-999 |
Position of astrometric reference star 4 (x,y pixels) |
STAR5 |
str |
-999 |
Position of astrometric reference star 5 (x,y pixels) |
DATATYPE |
str |
AstrometricCalibration |
Calibration data type |
DRPNFILE |
int |
2 |
# of files used to create this processed frame |
F0POS |
float |
80.55342878952176 |
-69.51409683261818 |
HISTORY |
str |
Marked 0 frames as bad: M… |
Processing history |
ERR Header (HDU 2)#
Keyword |
Datatype |
Example Value |
Description |
|---|---|---|---|
XTENSION |
str |
IMAGE |
Image extension |
BITPIX |
int |
-64 |
array data type |
NAXIS |
int |
2 |
number of array dimensions |
NAXIS1 |
int |
39 |
Raw data axis 1 size |
NAXIS2 |
int |
1 |
Raw data axis 2 size for SCI frames (1200) or ENG frames (2200) |
PCOUNT |
int |
0 |
number of parameters |
GCOUNT |
int |
1 |
number of groups |
EXTNAME |
str |
ERR |
FITS extension name |
TRK_ERRS |
bool |
False |
Whether individual errors are tracked (T/F) |
HISTORY |
str |
Boresight calibration compl… |
Processing history |
DQ Header (HDU 3)#
Keyword |
Datatype |
Example Value |
Description |
|---|---|---|---|
XTENSION |
str |
IMAGE |
Image extension |
BITPIX |
int |
16 |
array data type |
NAXIS |
int |
1 |
number of array dimensions |
NAXIS1 |
int |
39 |
Raw data axis 1 size |
PCOUNT |
int |
0 |
number of parameters |
GCOUNT |
int |
1 |
number of groups |
BSCALE |
int |
1 |
Linear factor in scaling equation. Needed for non-standard FITS data types |
BZERO |
int |
32768 |
Offset for 16-bit unsigned data type (FITS format determined) |
EXTNAME |
str |
DQ |
FITS extension name |
COMMENT |
str |
DQ not meaningful for this … |