Skip to content
GitLab
Switch branch/tag
Find file Normal viewHistoryPermalink
data_model.md 20.8 KB
Newer Older
Jiafeng's avatar
Update ifs_data_model.md    
Jiafeng committed
1 
# L1-IFS Data model
Xiong Yifei's avatar
Update data_model.md    
Xiong Yifei committed
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89 
## 单次曝光处理_File：CSST_IFS_type_yyyymmddHHMMSS_yyyymmddHHMMSS_obsid_camera_L1_VER_process.fits
### File name description
type:     目标类型，4位字符串,对于科学数据为‘SCIE’\
yyyymmdd: 八位数观测日期，如20240101\
HHMMSS:   六位数UT观测时间，如122838\
两组时间为起始曝光时间和结束曝光时间\
obsid:    CSST统一的曝光编号，从相应0级数据继承\
camera:   光谱仪编号,1位字符串,红端为“R”,蓝端为“B”,红蓝拼接后的全谱为“A”\
L1:       表示文件为1级科学观测数据\
VER:      版本号，1位字符串和4位数字的组合,如R4203是DRP中RSS处理模块 v4.2.03 版本\
process:  8位字符串,代表8步基本数据处理流程，由字母表示,含义如下:
```
e：已抽谱
w：已进行波长定标
n：已对平场归一
r：已扣除宇宙线
f：已进行流量定标
c：已生成三维数据块
g: 已完成天体测量位置（IFS-WCS）定标
```
### File contents
| HDU  | data                    | note       |
|------|-------------------------|------------|
| HDU0 | None                    | PrimaryHDU |
| HDU1 | FLUX                    | ImageHDU   |
| HDU2 | IVAR                    | ImageHDU   |
| HDU3 | MASK                    | ImageHDU   |

### HDU0
#### Header of `csst_ifs_rss`
| Level 1 extension header keywords (new) |                                                                     |        |                                                                                                          |
|-----------------------------------------|---------------------------------------------------------------------|--------|----------------------------------------------------------------------------------------------------------|
| Keyword                                 | Description                                                         | Format | Remark                                                                                                   |
| Standard keywords                       |                                                                     |        |                                                                                                          |
| XTENSION                                | IMAGE extension                                                     | C8     | 'IMAGE   '                                                                                               |
| BITPIX                                  | Number of bits per data pixel                                       | I4     | -32                                                                                                      |
| NAXIS                                   | Number of data axes                                                 | I4     | 3                                                                                                        |
| NAXIS1                                  | Number of spatial bins in X axis                                    | I4     | 32                                                                                                       |
| NAXIS2                                  | Number of spatial bins in Y axis                                    | I4     | 32                                                                                                       |
| NAXIS3                                  | Number of wavelength bins                                           | I4     | NWAVE                                                                                                    |
| Image processing keywords               |                                                                     |        |                                                                                                          |
| PROCESS                                 | RSS process record                                                  | C8     | ‘bewnrfcg’                                                                                               |
| RSS_VER                                 | version of RSS code                                                 | C5     |                                                                                                          |
| FLUXUNIT                                | Flux unit                                                           | C20    | 1E-17 erg/s/cm2/Å/arcsec2                                                                                |
| HISTORY                                 | Time of last image processing                                       | C80    |                                                                                                          |
| BIAS_MAS                                |  The file name of the master bias.                                  | C80    |                                                                                                          |
| DARK_MAS                                |  The file name of the master dark                                   | C80    |                                                                                                          |
| FLAT_MAS                                | The file name of the master flat                                    | C80    |                                                                                                          |
| LAMP_MAS                                |  The file name of the master lamp                                   | C80    |                                                                                                          |
| TRACFILE                                |  The reference file of trace                                        | C80    |                                                                                                          |
| PTOWFILE                                |  The reference file of pixel-to-wavelength solution                 | C80    |                                                                                                          |
| STDSTAR                                 |  The filename of the stardard star.                                 | C80    |                                                                                                          |
| HASCTE                                  | Has CTE correction                                                  | C01    | T or F                                                                                                   |
| HASSAT                                  | Has satellite correction                                            | C01    | T or F                                                                                                   |
| HASSCA                                  | Has stray light correction                                          | C01    | T or F                                                                                                   |
| QCFLUX                                  | The counts of NAN+INF in flux                                       | I4     |                                                                                                          |
| QCIV                                    | The counts of NAN+INF in IV                                         | I4     |                                                                                                          |
|                                         |                                                                     |        |                                                                                                          |
| IFS-WCS Calibration keywords            |                                                                     |        |                                                                                                          |
| WCSCAL_S                                | Determination of WCS calibration completion                         | I4     | The completion status is determined according to different situations, 0 means no operation is performed |
| WCSCAL_V                                | Version of WCS calibration                                          | Cxx    |                                                                                                          |
| WCSCAL_P                                | Name of the  configuration file used for WCS calibration            | Cxx    |                                                                                                          |
| WCS_TLM                                 | Time of last wcs calibration                                        | Cxx    | Time of the last WCS calibration                                                                         |
| RADECSYS                                | Frame of reference of coordinates                                   | C08    | 'ICRS' or 'FK5'                                                                                          |
| EQUINOX                                 |                                                                     | R4     | always 2000.0                                                                                            |
| CD1_1                                   | Coordinate transformation matrix element                            | R8     |                                                                                                          |
| CD1_2                                   | Coordinate transformation matrix element                            | R8     |                                                                                                          |
| CD2_1                                   | Coordinate transformation matrix element                            | R8     |                                                                                                          |
| CD2_2                                   | Coordinate transformation matrix element                            | R8     |                                                                                                          |
| CTYPE1                                  | Right Ascension, gnomonic projection                                | C8     | 'RA---TAN'                                                                                               |
| CTYPE2                                  | Declination, gnomonic projection                                    | C8     | 'DEC--TAN'                                                                                               |
| CUNIT1                                  | Units of coordinate increment and value                             | C4     | 'DEG'                                                                                                    |
| CUNIT2                                  | Units of coordinate increment and value                             | C4     | 'DEG'                                                                                                    |
| CRPIX1                                  | Pixel coordinate of reference point                                 | R8     |                                                                                                          |
| CRPIX2                                  | Pixel coordinate of reference point                                 | R8     |                                                                                                          |
| CRVAL1                                  | RA of reference point                                               | R8     | deg                                                                                                      |
| CRVAL2                                  | DEC of reference point                                              | R8     | deg                                                                                                      |
| CSYER1                                  | Systematic error in coordinate                                      | R8     | deg                                                                                                      |
| CSYER2                                  | Systematic error in coordinate                                      | R8     | deg                                                                                                      |
| CTYPE3                                  | The type of wavelength array                                        | C8     | 'WAVE-LIN' or 'WAVE-LOG'                                                                                 |
| CUNIT3                                  | unit of wavelength array                                            | C8     | Angstrom                                                                                                 |
| CRPIX3                                  | Starting pixel                                                      | R8     |                                                                                                          |
| CRVAL3                                  | The central wavelength wv0 of first pixel                           | R8     | Angstrom                                                                                                 |
| CD3_3                                   | wavelength dispersion per pixel                                     | R8     | Angstrom                                                                                                 |
| GGUIFILE                                | Geometric data object file of the guider camera relative to the IFS | Cxx    |                                                                                                          |
| IGUIFILE                                | Image data object file for guider accompanying observations         | Cxx    |                                                                                                          |
| GMCIFILE                                | Geometric data object file of the MCI relative to the IFS           | Cxx    |                                                                                                          |
| IMCIFILE                                | Image data object file for MCI accompanying observations            | Cxx    |
Jiafeng's avatar
Update ifs_data_model.md    
Jiafeng committed
90
Xiong Yifei's avatar
Update data_model.md    
Xiong Yifei committed
91 
## 多次曝光叠加_File: CSST_IFS_CUBE_{OBJ_id}_{VER_cube}_{LIN/LOG}_{STM_cube}.fits
Jiafeng's avatar
Update ifs_data_model.md    
Jiafeng committed
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153 

### File contents

| HDU  | data                    | note       |
|------|-------------------------|------------|
| HDU0 | None                    | PrimaryHDU |
| HDU1 | FLUX                    | ImageHDU   |
| HDU2 | IVAR                    | ImageHDU   |
| HDU3 | MASK                    | ImageHDU   |
| HDU4 | EXP_NUM                 | ImageHDU   |
| HDU5 | LSF                     | ImageHDU   |
| HDU6 | WEIGHT_MARTIX           | ImageHDU   |
| HDU7 | rRSS_FILE_LIST          | BinTableHDU|

### HDU0

#### Header of `csst_ifs_cube`

| keyword   | value                 | comment                                           | fill value   | type | module                   |
|-----------|:----------------------|---------------------------------------------------|--------------|------|--------------------------|
| RSS_VER   | R6100                 | version of RSS code                               | RXXXX        |str   | csst_ifs_cube            |
| CUB_VER   | C6100                 | version of CUBE code                              | CXXXX        |str   | csst_ifs_cube            |
| COV_VER   | C6100                 | version of CUBE code                              | CXXXX        |str   | csst_ifs_cube            |
| LSF_VER   | C6100                 | version of CUBE code                              | CXXXX        |str   | csst_ifs_cube            |
| FLUXUNIT  | '1E-17 erg/s/cm2/A/arcsec2' | unit of flux                                | '1E-17 erg/s/cm2/A/arcsec2'|str   | csst_ifs_cube |
| FLUXSCALE | 1                     | Intensity unit scaling                            | 1            |I8    | csst_ifs_cube            |
| FLUXZERO  | 0                     | Intensity zeropoint                               | 0            |I8    | csst_ifs_cube            |
|TELESCOP	| CSST                  | Telescope used to acquire data		            | CSST         |str   | csst_ifs_cube            |
|INSTRUMENT	| IFS                   | Identifier for instrument used to acquire data    | IFS          |str   | csst_ifs_cube            |
|OBJID      | 174053.8-534326'      | ID of Object(in the form of HHMMSS.S+DDMMSS)      | hhmmss.sddmmss|str  | csst_ifs_cube            |
|NEXP       | 50                    | number of science exposures combined              | 0            |I8    | csst_ifs_cube            |
|EXPTIME    | 60000                 | Total exposure time                               | 0            |f32   | csst_ifs_cube            |
|MJDMIN     | 2459955.2275463       | Minimum OBS MJD across all exposures              | -9999        |f32   | csst_ifs_cube            |
|MJDMAX     | 2459955.39282407      | Maximum OBS MJD across all exposures              | -9999        |f32   | csst_ifs_cube            |
|MJDMED     | 2459955.34074074      | Median OBS MJD across all exposures               | -9999        |f32   | csst_ifs_cube            |
|WCSCAL_VER | A6101                 | Version of WCS calibration	                    | AXXX         |str   | csst_ifs_cube            |
|WCSCAL_P	|                       | file for WCS calibration 	                        |  "?"         |str   | csst_ifs_cube            |
|RADECSYS	| FK5                   | Frame of reference of coordinates                 | FK5          |str   | csst_ifs_cube            |
|EQUINOX    | 2000.0                |                                                   | 2000.0       |str   | csst_ifs_cube            |
|OBJRA	    | 265.22407917          | Object R.A. (J2000 deg.)                          | -9999        |f32   | csst_ifs_cube            |
|OBJDEC     | -53.72406389          | Object Dec. (J2000 deg.)                          | -9999        |f32   | csst_ifs_cube            |
|CENRA	    | 265.2240087483441     | Plate center R.A. (J2000 deg.)	R4	            | -9999        |f32   | csst_ifs_cube            |
|CENDEC	    | -53.72410555664603    | Plate center Dec. (J2000 deg.)	R4	            | -9999        |f32   | csst_ifs_cube            |
|CTYPE3	    | 'LIN'                 | The type of wavelength array                      | 'LIN'        |str   | csst_ifs_cube            |
|CRPIX3	    | 1.0                   | Starting pixel	                                | -9999        |f32   | csst_ifs_cube            |
|CRVAL3	    | 3500.0                | The central wavelength wv0 of first pixel 	    | -9999        |f32   | csst_ifs_cube            |
|CD3_3	    | 1.75                  | wavelength dispersion per pixel	                | -9999        |f32   | csst_ifs_cube            |
|CUNIT3	    | 'Angstrom'            | unit of wavelength                                | 'Angstrom'   |str   | csst_ifs_cube            |
|CRPIX1	    | 49.0                  | Reference pixel	                                | -9999        |f32   | csst_ifs_cube            |
|CRPIX2	    | 52.0                  | Reference pixel	                                | -9999        |f32   | csst_ifs_cube            |
|CRVAL1	    | 265.22407917          | RA of reference point	                            | -9999        |f32   | csst_ifs_cube            |
|CRVAL2     | -53.72406389	        | Dec of reference point	                        | -9999        |f32   | csst_ifs_cube            |
|CD1_1	    | -2.7777777777777E-05  | Coordinate transformation matrix element	        | -9999        |f32   | csst_ifs_cube            |
|CD1_2	    | 0.0                   | Coordinate transformation matrix element	        | -9999        |f32   | csst_ifs_cube            |
|CD2_1	    | 0.0                   | Coordinate transformation matrix element	        | -9999        |f32   | csst_ifs_cube            |
|CD2_2	    | 2.7777777777778E-05   | Coordinate transformation matrix element	        | -9999        |f32   | csst_ifs_cube            |
|CTYPE1     | 'RA---TAN'	        | Declination, gnomonic projection	                | 'RA---TAN'   |str   | csst_ifs_cube            |
|CTYPE2     | 'DEC--TAN'	        | Declination, gnomonic projection	                | 'DEC--TAN'   |str   | csst_ifs_cube            |
|CUNIT1	    | 'deg'                 | Units of coordinate increment and value	        | 'deg'        |str   | csst_ifs_cube            |
|CUNIT2	    | 'deg'                 | Units of coordinate increment and value	        | 'deg'        |str   | csst_ifs_cube            |
|EBVGAL     | 0	                    | Galactic reddening E(B-V)	                        | -9999        |f32   | csst_ifs_cube            |
|CHECKSUM   | 0                     |checksum                                           | 1            |I8    | csst_ifs_cube            |