2MAPPS Software Interface Specification QUA10 3.4 (011119; D. Kirkpatrick) Interface Name: QA Cal Information Table (CIT) Type of Interface: ASCII text Written By: SCANSCI _________________________________ R. Hurt Read By: offline analysis program ________________ R. Stiening DBMAN ___________________________________ T. Evans File Name: qacit.{yymmdd}, where {yymmdd} is the file creation date. This file lives at /l7/ops/citdb. Description: The QA Cal Information Table (CIT) contains a record of cal scans observed by either of the 2MASS observing facilities. Only scans that have passed through version 3.0 OPS processing are included here. Each entry contains basic information on the scan (tile number, date, hemisphere, scan number, RA and Dec centers, etc.), derived information (seeing shapes, backgrounds, zero points, etc.), and telemetry (focus setting, airmass, relative humidity, etc.). Steps needed to create the CIT file: After a new night has been processed through version 3.0 OPS, a {yymmddh}.cit file is created and deposited into the /l7/ops/sitdb/ncit/ directory. Once a week, on Wednesday, the accumulated nightly files will be concatenated into an updated table by running the makecit script. The result is the CIT file described in this document. The file architecture parallels that of the SIT documented in SIS QUA07. However, many of the date fields contained in the SIT are not computed for cal scans, so the corresponding entries in the CIT are filled with null values. These are noted in the document below. File header: The header is in standard IPAC table header format. The first line gives the version number, run date, and run time for the program (the customized software) creating the file. The second and third header lines give the date and time that the file was last modified by IPAC or by UMass, respectively. The fourth header line lists the number of actual entries in the table, not counting the header lines. Each of the first four header lines is in A60 format. The 5th-8th header lines (in A787 format) give the field identifier, data type, and units for each column in the file. An example header line is shown below: \ YYYYMMDD HHMMSS Date last run by customized software VX.X 99XXXX. \ YYYYMMDD HHMMSS Date last modified at IPAC. \ YYYYMMDD HHMMSS Date last modified at UMass. \ NNNNN data rows in this file. | Tile | Date |H|Scn|S| Ra | Dec | Glat | Glon |A|D|C| ... | int | int |c|int| | real | real | real | real |i|i|i| ... | | | | | | | | | | | | | ... | | | | | | deg | deg | deg | deg | | | | ... Specification of Output Variables --------------------------------- Basic Scan Info: cols Name Description Units Type Format Null Range Source ------- ------ ------------------------------------- ------- ---- -------- ---- ----- ------ 001-007 Tile Tile number -- int I7 -- 90004-92409 log/{yymmddh}.lgo 008-014 Date Observation date -- int I7 -- 000101 to 030101 or log/{yymmddh}.lgo 970521 to 991231 015-016 H Observatory location -- int A2 -- n or s log/{yymmddh}.lgo 017-020 Scn Nightly scan number -- int I4 -- 1 to 999 log/{yymmddh}.lgo 021-022 S Scanning direction -- int I2 -- 0 or 1 log/{yymmddh}.lgo 023-032 RA RA of scan center point (J2000) deg r*4 F10.4 -- 0. to 360. datequal/{yymmddh}.pfqqas 033-042 Decl Dec of scan center point (J2000) deg r*4 F10.4 -- -90. to 90. datequal/{yymmddh}.pfqqas 043-052 Glat Approx. galactic lat. of scan center deg r*4 F10.4 -- 0. to 360. computed by SCANSCI 053-062 Glon Approx. galactic long. of scan center deg r*4 F10.4 -- -90. to 90. computed by SCANSCI 063-064 A Array configuration (original/modified) -- int I2 -- 0 or 1 computed by SCANSCI 065-066 D Dithering pattern (non-optimal/optimal) -- int I2 -- 0 or 1 computed by SCANSCI 067-068 C Calibration strategy (old/new) -- int I2 -- 0 or 1 computed by SCANSCI 069-075 NJ Number of J band detections -- int I7 -- 0 to 999999 s{nnn}/qual/sq{nnn}.bmg 076-082 NH Number of H band detections -- int I7 -- 0 to 999999 s{nnn}/qual/sq{nnn}.bmg 083-089 NK Number of Ks band detections -- int I7 -- 0 to 999999 s{nnn}/qual/sq{nnn}.bmg 090-096 Jdens (not computed; placeholder for now) -- r*4 F7.3 -9.9 0. to 6. (not yet computed) 097-103 Hdens (not computed; placeholder for now) -- r*4 F7.3 -9.9 0. to 6. (not yet computed) 104-110 Kdens Log of Ks max. src density (Ks<14.0 mag) -- r*4 F7.3 -- 0. to 6. s{nnn}/qual/galworks.tbl 111-117 Nbmg Number of detections after bandmerging -- int I7 -- 0 to 999999 s{nnn}/qual/sq{nnn}.bmg 118-124 Jsh Average J seeing shape in scan -- r*4 F7.3 -9.9 0. to 9. datequal/q{yymmddh}.psf.see 125-131 Hsh Average H seeing shape in scan -- r*4 F7.3 -9.9 0. to 9. datequal/q{yymmddh}.psf.see 132-138 Ksh Average Ks seeing shape in scan -- r*4 F7.3 -9.9 0. to 9. datequal/q{yymmddh}.psf.see 139-145 MxJsh Maximum J seeing shape in scan -- r*4 F7.3 -9.9 (set to null) (not computed for cals) 146-152 MxHsh Maximum H seeing shape in scan -- r*4 F7.3 -9.9 (set to null) (not computed for cals) 153-159 MxKsh Maximum Ks seeing shape in scan -- r*4 F7.3 -9.9 (set to null) (not computed for cals) 160-169 Jbg Average J frame background DN r*4 F10.3 -9.9 0. to 99999. datequal/q{yymmddh}.bgrnd 170-179 Hbg Average H frame background DN r*4 F10.3 -9.9 0. to 99999. datequal/q{yymmddh}.bgrnd 180-189 Kbg Average Ks frame background DN r*4 F10.3 -9.9 0. to 99999. datequal/q{yymmddh}.bgrnd 190-196 Jrat J image aspect ratio -- r*4 F7.3 -9.9 0. to 1. datequal/q{yymmddh}.psf.see 197-203 Hrat H image aspect ratio -- r*4 F7.3 -9.9 0. to 1. datequal/q{yymmddh}.psf.see 204-210 Krat Ks image aspect ratio -- r*4 F7.3 -9.9 0. to 1. datequal/q{yymmddh}.psf.see (Notes: Tile - The following lists all currently recognized cal tiles: Tile# Std Name ----- -------- 90004 FS4 90009 Oph_n9a 90013 FS13 90021 BRI0021-0214 90067 M67 90091 P091-D 90121 S121-E 90161 P161-D 90191 LHS191 90217 S217-D 90234 S234-E 90247 P247-U 90273 S273-E 90279 S279-F 90290 P290-D 90294 S294-D 90301 S301-D 90312 S312-T 90533 P533-D 90547 L547 90565 P565-C 90808 S808-C 90860 S860-D 90867 S867-V 90868 T868-53850 90893 S893-D 92026 LHS2026 92202 BRI2202-1119 92397 LHS2397a 90028 FS28 <--- used only during engineering 90023 FS23 <--- used only during engineering 90221 P221-C <--- used only during engineering 90330 P330-E 90266 P266-C 90272 P272-D 90182 P182-E 90813 S813-D 92409 ABELL2409 Special Cal Fields Used only for 6x LMC/SMC Data: Tile# Std Name ----- -------- 90298 90299 90400 90401 90402 H - s=south (observed from CTIO); n=north (observed from Mt. Hopkins) S - 0=south-going; 1=north-going. Ra - RA of scan center point; this is "RAcp" in SIS pos12. Dec - Dec of scan center point; this is "DECcp" in SIS pos12. Glat - Approximate galactic latitude as computed from RA and Dec above Glon - Approximate galactic longitude as computed from RA and Dec above A - for north: 0 for <990913n, 1 for >=990913n for south: always 0 D - for north: 0 for <970607n, 1 for >=970607n for south: always 1 C - for north: 0 for <971011n, 1 for >=971011n for south: always 1 ) Astrometric Components: cols Name Description Units Type Format Null Range Source ------- ------ ------------------------------------- ------- ---- -------- ---- ----- ------ 211-214 Nty Number of Tycho-2 stars in scan -- int I4 0 (set to null) (not computed for cals) 215-223 Dew Difference of tile and scan E-W asec r*4 F9.3 -- -9999.999 to 99999.999 datequal/{yymmddh}.pfqqas 224-232 Ddec Difference of tile and scan Dec asec r*4 F9.3 -- -9999.999 to 99999.999 datequal/{yymmddh}.pfqqas 233-241 MrgS Coverage margin, south end asec r*4 F9.3 -- -9999.999 to 99999.999 datequal/{yymmddh}.pfqqas 242-250 MrgN Coverage margin, north end asec r*4 F9.3 -- -9999.999 to 99999.999 datequal/{yymmddh}.pfqqas (Notes: Dew - Known as "XSDifEq" in SIS pos12, this is the X-scan difference between equatormost 6-deep frame center (3-band average) and the corresponding tile/cal endpoint. A positive value implies the scan is too far east. Ddec - In-scan difference between reconstructed scan placement and perfect placement with respect to the tile; this is ISDifT in SIS pos12. MrgS - Known as "ISCMrgS" in SIS pos12, this is the in-scan coverage margin at south end of tile. Compares Dec of southmost 6-deep frame center (3-band average) with Dec of tile/cal south endpoint. A positive value implies excess coverage and a negative value missing coverage. MrgN - Known as "ISCMrgN" in SIS pos12, this is the in-scan coverage margin at north end of tile. Compares Dec of northmost 6-deep frame center (3-band average) with Dec of tile/cal north endpoint. A positive value implies excess coverage and a negative value missing coverage. Photometric Components: cols Name Description Units Type Format Null Range Source ------- ------ ------------------------------------- ------- ---- -------- ---- ----- ------ 251-257 Jpsp J photometric sensitivity parameter -- r*4 F7.3 -9.9 0. to 30. computed by SCANSCI 258-264 Hpsp H photometric sensitivity parameter -- r*4 F7.3 -9.9 0. to 30. computed by SCANSCI 265-271 Kpsp Ks photometric sensitivity parameter -- r*4 F7.3 -9.9 0. to 30. computed by SCANSCI 272-280 Jzp J phot. zero point, extinction corrected mag r*4 F9.4 -9.9 -1. to 1. datequal/q{yymmddh}.cal 281-289 Hzp H phot. zero point, extinction corrected mag r*4 F9.4 -9.9 -1. to 1. datequal/q{yymmddh}.cal 290-298 Kzp Ks phot. zero point, extinction corrected mag r*4 F9.4 -9.9 -1. to 1. datequal/q{yymmddh}.cal 299-307 Jrzp J photometric zero point RMS mag r*4 F9.4 -9.9 -1. to 1. datequal/q{yymmddh}.cal 308-316 Hrzp H photometric zero point RMS mag r*4 F9.4 -9.9 -1. to 1. datequal/q{yymmddh}.cal 317-325 Krzp Ks photometric zero point RMS mag r*4 F9.4 -9.9 -1. to 1. datequal/q{yymmddh}.cal 326-332 Jovlp Maximum J overlap diff. in scan block mag r*4 F7.3 -9.9 (set to null) (not computed for cals) 333-339 Hovlp Maximum H overlap diff. in scan block mag r*4 F7.3 -9.9 (set to null) (not computed for cals) 340-346 Kovlp Maximum Ks overlap diff. in scan block mag r*4 F7.3 -9.9 (set to null) (not computed for cals) (Notes: Jpsp - this is Jsh*(Jbg^0.29) Hpsp - this is Hsh*(Hbg^0.29) Kpsp - this is Ksh*(Kbg^0.29) ) Untracked Seeing Components: cols Name Description Units Type Format Null Range Source ------- ------ ------------------------------------- ------- ---- -------- ---- ----- ------ 347-353 Jsee J Seetracker score -- r*4 F7.3 -9.9 -1. to 99. {yymmddh}.seetrack 354-360 Hsee H Seetracker score -- r*4 F7.3 -9.9 -1. to 99. {yymmddh}.seetrack 361-367 Ksee Ks Seetracker score -- r*4 F7.3 -9.9 -1. to 99. {yymmddh}.seetrack 368-373 Jlen J Untracked length arcsec int I6 -9 0 to 3800 {yymmddh}.seetrack 374-379 Hlen H Untracked length arcsec int I6 -9 0 to 3800 {yymmddh}.seetrack 380-385 Klen Ks Untracked length arcsec int I6 -9 0 to 3800 {yymmddh}.seetrack Background Residual Components: cols Name Description Units Type Format Null Range Source ------- ------ ------------------------------------- ------- ---- -------- ---- ----- ------ 386-390 Jn3s J coadd noise 3 sigma counter -- int I5 -9 (set to null) datequal/{yymmddh}.cnoise 391-395 Hn3s H coadd noise 3 sigma counter -- int I5 -9 (set to null) datequal/{yymmddh}.cnoise 396-400 Kn3s Ks coadd noise 3 sigma counter -- int I5 -9 (set to null) datequal/{yymmddh}.cnoise 401-405 Jcn4 J coadd noise (4th worst) -- r*4 F5.1 -9.9 (set to null) datequal/{yymmddh}.cnoise 406-410 Hcn4 H coadd noise (4th worst) -- r*4 F5.1 -9.9 (set to null) datequal/{yymmddh}.cnoise 411-415 Kcn4 Ks coadd noise (4th worst) -- r*4 F5.1 -9.9 (set to null) datequal/{yymmddh}.cnoise Banding Diagnostics: cols Name Description Units Type Format Null Range Source ------- ------ ------------------------------------- ------- ---- -------- ---- ----- ------ 416-419 Jbl J band. count, left (0.1 DN/Hi-SNR amp) -- int I4 -9 0 to 49 datequal/q{yymmddh}.bandaid 420-423 Hbl H band. count, left (0.1 DN/Hi-SNR amp) -- int I4 -9 0 to 49 datequal/q{yymmddh}.bandaid 424-427 Kbl Ks band. count, left (0.1 DN/Hi-SNR amp) -- int I4 -9 0 to 49 datequal/q{yymmddh}.bandaid 428-431 Jbr J band. count, right (0.1 DN/Hi-SNR amp) -- int I4 -9 0 to 49 datequal/q{yymmddh}.bandaid 432-435 Hbr H band. count, right (0.1 DN/Hi-SNR amp) -- int I4 -9 0 to 49 datequal/q{yymmddh}.bandaid 436-439 Kbr Ks band. count, right (0.1 DN/Hi-SNR amp) -- int I4 -9 0 to 49 datequal/q{yymmddh}.bandaid Quadrant Jumps: cols Name Description Units Type Format Null Range Source ------- ------ ------------------------------------- ------- ---- -------- ---- ----- ------ 440-443 Jjp J jump counter -- int I4 -9 0 to 49 datequal/q.backjump.sum 444-447 Hjp H jump counter -- int I4 -9 0 to 49 datequal/q.backjump.sum 448-451 Kjp K jump counter -- int I4 -9 0 to 49 datequal/q.backjump.sum Defacto Quality Factor Summaries: cols Name Description Units Type Format Null Range Source ------- ------ ------------------------------------- ------- ---- -------- ---- ----- ------ 452-456 DF1 Nightly phot. calibration factor -- r*4 F5.1 -9.9 0.0 to 1.0 computed by SCANSCI 457-461 DF2 Sensitivity factor -- r*4 F5.1 -9.9 0.0 to 1.0 computed by SCANSCI 462-466 DF3 Ave. and max. seeing shape factor -- r*4 F5.1 -9.9 0.0 to 1.0 computed by SCANSCI 467-471 DF4 Untracked seeing *factor* -- r*4 F5.1 -9.9 0.0 to 1.0 computed by SCANSCI 472-476 DF5 Airglow background residual factor -- r*4 F5.1 -9.9 0.0 to 1.0 computed by SCANSCI 477-481 DF6 (placeholder; not used currently) -- r*4 F5.1 -9.9 (set to null) (not computed for cals) 482-486 DF7 Untracked seeing *flag* -- r*4 F5.1 -9.9 0.0 to 1.0 computed by SCANSCI Override Summaries: cols Name Description Units Type Format Null Range Source ------- ------ ------------------------------------- ------- ---- -------- ---- ----- ------ 487-489 OS Final score override -- int I3 -9 0 or 10 {yymmddh}.qagrade 490-494 OF1 Nightly phot. calibration factor -- r*4 F5.1 -9.9 (set to null) (not computed for cals) 495-499 OF2 Sensitivity factor -- r*4 F5.1 -9.9 (set to null) (not computed for cals) 500-504 OF3 Ave. and max. seeing shape factor -- r*4 F5.1 -9.9 (set to null) (not computed for cals) 505-509 OF4 Untracked seeing *factor* -- r*4 F5.1 -9.9 (set to null) (not computed for cals) 510-514 OF5 Airglow background residual factor -- r*4 F5.1 -9.9 (set to null) (not computed for cals) 515-519 OF6 (placeholder; not used currently) -- r*4 F5.1 -9.9 (set to null) (not computed for cals) 520-524 OF7 Untracked seeing *flag* -- r*4 F5.1 -9.9 (set to null) (not computed for cals) (Note: If OS is not null (-9), its value is the overridden value for the final score.) Final Quality Scores: cols Name Description Units Type Format Null Range Source ------- ------ ------------------------------------- ------- ---- -------- ---- ----- ------ 525-527 Q2 Quality score from v2 processing -- int I3 -- 10 (by definition) 528-530 Q3 Quality score from v3 processing -- int I3 -- 0 or 10 computed by SCANSCI Special Flag Fields: cols Name Description Units Type Format Null Range Source ------- ------ ------------------------------------- ------- ---- -------- ---- ----- ------ 531-534 F00 H-band glitch -- int I4 -9 0 or 1 {yymmddh}.qagrade 535-538 F01 DB phot overlap downgrade (clouds) -- int I4 -9 0 or 1 {yymmddh}.qagrade 539-542 F02 DB phot overlap downgrade (non-clouds) -- int I4 -9 0 or 1 {yymmddh}.qagrade 543-546 F03 Coadd anomaly flag -- int I4 -9 0 or 1 filled in by SCANSCI 547-550 F04 (blank) -- int I4 -9 (set to null) (not used for cals) 551-554 F05 Ladybug flag -- int I4 -9 0 or 1 {yymmddh}.qagrade 555-558 F06 (blank) -- int I4 -9 (set to null) (not used for cals) 559-562 F07 (blank) -- int I4 -9 (set to null) (not used for cals) 563-566 F08 (blank) -- int I4 -9 (set to null) (not used for cals) 567-570 F09 (blank) -- int I4 -9 (set to null) (not used for cals) 571-574 F10 (blank) -- int I4 -9 (set to null) (not used for cals) 575-578 F11 (blank) -- int I4 -9 (set to null) (not used for cals) Blank Fields: cols Name Description Units Type Format Null Range Source ------- ------ ------------------------------------- ------- ---- -------- ---- ----- ------ 579-586 Bla0 (blank) -- int I8 -9 (unknown) {yymmddh}.qagrade 587-594 Bla1 (blank) -- int I8 -9 (unknown) {yymmddh}.qagrade 595-602 Bla2 (blank) -- int I8 -9 (unknown) {yymmddh}.qagrade 603-610 Bla3 (blank) -- int I8 -9 (unknown) {yymmddh}.qagrade 611-618 Bla4 (blank) -- int I8 -9 (unknown) {yymmddh}.qagrade 619-626 Bla5 (blank) -- int I8 -9 (unknown) {yymmddh}.qagrade 627-634 Bla6 (blank) -- int I8 -9 (unknown) {yymmddh}.qagrade 635-642 Bla7 (blank) -- int I8 -9 (unknown) {yymmddh}.qagrade 643-650 Bla8 (blank) -- int I8 -9 (unknown) {yymmddh}.qagrade 651-658 Bla9 (blank) -- int I8 -9 (unknown) {yymmddh}.qagrade Released Data Flags: cols Name Description Units Type Format Null Range Source ------- ------ ------------------------------------- ------- ---- -------- ---- ----- ------ 659-661 R0 Scan in Sampler Release? -- int I3 0 (set to null) (not used for cals) 662-664 R1 Scan in 1IDR? -- int I3 0 (set to null) (not used for cals) 665-667 R2 Scan in 2IDR? -- int I3 0 (set to null) (not used for cals) 668-670 R3 (blank) -- int I3 0 (set to null) (not used for cals) 671-673 R4 (blank) -- int I3 0 (set to null) (not used for cals) Read Note Field: cols Name Description Units Type Format Null Range Source ------- ------ ------------------------------------- ------- ---- -------- ---- ----- ------ 674-675 W Is there special note for this scan? -- int I2 -- 0 or 1 {yymmddh}.qagrade (Notes: W - This field will be 0 if no special note pertains to this scan or 1 if there is a special note, in which case the QAreview for the night should be consulted for additional info. ) Telemetry Fields: cols Name Description Units Type Format Null Range Source ------- ------ ------------------------------------- ------- ---- -------- ---- ----- ------ 676-682 Focus Focus setting -- int I7 -99999 -30000 to 30000 /home/roc/obslogs/info/sci.info 683-692 sr_UT Universal Time at start of scan hr r*4 F10.6 -9.9 0. to 24. /home/roc/obslogs/info/sci.info 693-702 sr_LST Local Sidereal Time at start of scan hr r*4 F10.6 -9.9 0. to 24. /home/roc/obslogs/info/sci.info 703-712 sr_HA Hour Angle at start of scan hr r*4 F10.6 -9.9 -6. to 6. /home/roc/obslogs/info/sci.info 713-717 ZD Zenith Distance deg r*4 F5.1 -9.9 0. to 90. /home/roc/obslogs/info/sci.info 718-724 Air_M Airmass -- r*4 F7.3 -9.9 1. to 5.0 /home/roc/obslogs/info/sci.info 725-727 RH Relative Humidity % int I3 -9 0 to 99 /home/roc/obslogs/info/sci.info 728-732 Baro Barometric reading in Hg r*4 F5.1 -9.9 25. to 35. /home/roc/obslogs/info/sci.info 733-738 Air_T Air temperature deg C r*4 F6.1 -99.9 -20. to 40. /home/roc/obslogs/info/sci.info 739-744 Tel_T Telescope tube girdle temperature deg C r*4 F6.1 -99.9 -20. to 40. /home/roc/obslogs/info/sci.info 745-750 Rng_T Head ring temperature deg C r*4 F6.1 -99.9 -20. to 40. /home/roc/obslogs/info/sci.info 751-764 sr_JD Julian Day at start of scan day r*4 F14.5 -- 2400000. to 2500000. computed by SCANSCI Statistics on Tile: cols Name Description Units Type Format Null Range Source ------- ------ ------------------------------------- ------- ---- -------- ---- ----- ------ 765-768 Nob Number of obs of tile in SIT -- int I4 -- 1 to 999 off line program at UMass 769-774 Depch Epoch diff, this obs - earliest obs days int I6 -- 0 to 9999 off line program at UMass 775-780 Depcm Epoch diff, last obs - earliest obs days int I6 -- 0 to 9999 off line program at UMass 781-787 BrKPS Ks mag of brightest point src at Ks mag r*4 F7.3 -- -9.999 to 99.999 off line program at UMass (Notes: Nob - Number of observations of this tile in the current SIT file, regardless of which observatory obtained the data. Depch - Difference in date between this observation of the tile and the earliest observation of the tile in the SIT. Depcm - Difference in date between last observation of this tile in the SIT and the earliest observation in the SIT.