Debian Codegraph @

stdred/ccdred/proc/ccdcorrect.prg

raw
1 ! @(#)ccdcorrect.prg 19.1 (ES0-DMD) 02/25/03 14:15:59
2 !@(#)ccdcorrect.prg 19.1 (ESO) 02/25/03 14:15:59
3 !+++++++++++++++++++++++++++++++++++++++++++++++++++++++
4 !.COPYRIGHT (C) 1993 European Southern Observatory
5 !.IDENT ccdcorrect.prg
6 !.AUTHOR Rein H. Warmels, ESO-Garching
7 !.KEYWORDS Direct imaging, CCD package
8 !.PURPOSE Do the requested calbration correction on the input image
9 !.USE @s ccdcorrect p1 p2 p3
10 !. p1 = input frame
11 !. p2 = output frame
12 !. p3 = processing option
13 !.VERSION 930423 RHW Creation
14 !.VERSION 971113 SW input frame has to be internaly renamed (see swolf)
15 !.VERSION 971201 SW illum.correc. has to be split for SKY and SCREEN-FF,
16 ! CHECK if FF has already be ill.corr.!
17 !-------------------------------------------------------
18 DEFINE/PARAM P1 ? I "Enter input frame [no default]:"
19 DEFINE/PARAM P2 ? I "Enter output frame [no default]:"
20 DEFINE/PARAM P3 {CCDCORS(1:10)} C "Enter calibration to be done:"
21
22 !
23 ! here for trimming and pixel correction
24 IF P3(2:2) .EQ. "T" THEN ! check if trimming is needed
25 IF P1 .EQ. "{P2}" THEN
26 EXTRACT/IMAGE &d = {P1}{IM_SEC}
27 COPY/II &d {P2}
28 WRITE/DESCR {P2} CCDSTAT/I/2/1 1 ! write descriptor status
29 DELETE/IMAGE &d NO
30 ELSE
31 EXTRACT/IMAGE {P2} = {P1}{IM_SEC}
32 ENDIF
33 ENDIF
34 !
35 IF P3(3:3) .EQ. "P" THEN ! check if pixel correction is needed
36 IF FX_METH(1:1) .EQ. "A" THEN ! use modify/area command
37 MODIFY/AREA {P1},{FX_TABLE} {P2} {FX_FPAR(1)} {FX_NOISE}
38
39 ELSEIF FX_METH(1:1) .EQ. "C" THEN ! use modify/column command
40 MODIFY/COLUMN {P1},{FX_TABLE} {P2} V
41
42 ELSEIF FX_METH(1:1) .EQ. "R" THEN ! use modify/row command
43 MODIFY/ROW {P1},{FX_TABLE} {P2} V
44
45 ELSE ! use modify/pixels command
46 MODIFY/PIXELS {P1},{FX_TABLE} {P2} {FX_FACT} {FX_FPAR} ? {FX_NOISE}
47 ENDIF
48 WRITE/DESCR {P2} CCDSTAT/I/3/1 1 ! write descriptor status
49 P3(3:3) = "X" !<--- [email protected] (13.11.97) otherwise next IF's are
50 !always FALSE although they should be TRUE (e.g. XXPBXX)
51
52 P1 = "{P2}" !<--- [email protected] (13.11.97) change name of parameter
53 !in order to get the right computations in the following
54 !IF statements!!! One has to use the CORRECTED version
55 !for the computations!
56 ENDIF
57 !
58 ! *** here the part for the basic correction
59 IF P3(1:6) .EQ. "OXXXXX" THEN ! overscan
60 COMPUTE/IMAGE -
61 {P2} = {P1} - {CCDSCAN}
62 WRITE/DESCR {P2} CCDSTAT/I/1/1 1 ! overscan correction done
63
64 ELSEIF P3(1:6) .EQ. "XXXBXX" THEN ! bias
65 COMPUTE/IMAGE -
66 {P2} = {P1} - {SC_BSFRM}
67 WRITE/DESCR {P2} CCDSTAT/I/4/1 1 ! bias correction done
68 !
69 ELSEIF P3(1:6) .EQ. "OXXBXX" THEN ! overscan + bias
70 COMPUTE/IMAGE -
71 {P2} = {P1} - {CCDSCAN} - {SC_BSFRM}
72 WRITE/DESCR {P2} CCDSTAT/I/1/1 1 ! overscan correction done
73 WRITE/DESCR {P2} CCDSTAT/I/4/1 1 ! bias correction done
74 !
75 ! *** here the part including the dark corection
76 ELSEIF P3(1:6) .EQ. "XXXXDX" THEN ! dark
77 COMPUTE/IMAGE -
78 {P2} = {P1} - {CCDDARK}*{SC_DKFRM}
79 WRITE/DESCR {P2} CCDSTAT/I/5/1 1 ! dark correction done
80
81 ELSEIF P3(1:6) .EQ. "OXXXDX" THEN ! overscan + dark
82 COMPUTE/IMAGE -
83 {P2} = {P1} - {CCDSCAN} - {CCDDARK}*{SC_DKFRM}
84 WRITE/DESCR {P2} CCDSTAT/I/1/1 1 ! overscan correction done
85 WRITE/DESCR {P2} CCDSTAT/I/5/1 1 ! dark correction done
86
87 ELSEIF P3(1:6) .EQ. "XXXBDX" THEN ! bias + dark
88 COMPUTE/IMAGE -
89 {P2} = {P1} - {SC_BSFRM} - {CCDDARK}*{SC_DKFRM}
90 WRITE/DESCR {P2} CCDSTAT/I/4/1 1 ! bias correction done
91 WRITE/DESCR {P2} CCDSTAT/I/5/1 1 ! dark correction done
92
93 ELSEIF P3(1:6) .EQ. "OXXBDX" THEN ! overscan + bias + dark
94 COMPUTE/IMAGE -
95 {P2} = {P1} - {CCDSCAN} - {SC_BSFRM} - {CCDDARK}*{SC_DKFRM}
96 WRITE/DESCR {P2} CCDSTAT/I/1/1 1 ! overscan correction done
97 WRITE/DESCR {P2} CCDSTAT/I/4/2 1,1 ! bias, dark correction done
98 !
99 ! *** here the part with flat correction
100 ! if flatfield corrections has to be done (illumination correction) one has to
101 ! guarantee that the result frame will be used for these corrections. That's
102 ! the reason why the name of the 'input' frame has to be changed to the name
103 ! of the result frame in this part of the procedure ([email protected], 01.12.97)
104 ELSEIF P3(1:6) .EQ. "XXXXXF" THEN ! flat
105 COMPUTE/IMAGE -
106 {P2} = {P1}*{CCDFLAT}/{SC_FFFRM}
107 WRITE/DESCR {P2} CCDSTAT/I/6/1 1 ! flat correction done
108 P1 = "{P2}" !if ill.corr or fringe.corr has to be done: change name
109
110 ELSEIF P3(1:6) .EQ. "OXXXXF" THEN ! overscan + flat
111 COMPUTE/IMAGE -
112 {P2} = ({P1} - {CCDSCAN})*{CCDFLAT}/{SC_FFFRM}
113 WRITE/DESCR {P2} CCDSTAT/I/1/1 1 ! overscan correction done
114 WRITE/DESCR {P2} CCDSTAT/I/6/1 1 ! flat correction done
115 P1 = "{P2}" !if ill.corr or fringe.corr has to be done: change name
116
117 ELSEIF P3(1:6) .EQ. "XXXBXF" THEN ! bias + flat
118 COMPUTE/IMAGE -
119 {P2} = ({P1} - {SC_BSFRM})*{CCDFLAT}/{SC_FFFRM}
120 WRITE/DESCR {P2} CCDSTAT/I/4/1 1 ! bias correction done
121 WRITE/DESCR {P2} CCDSTAT/I/6/1 1 ! flat correction done
122 P1 = "{P2}" !if ill.corr or fringe.corr has to be done: change name
123
124 ELSEIF P3(1:6) .EQ. "XXXXDF" THEN ! dark + flat
125 COMPUTE/IMAGE -
126 {P2} = ({P1} - {CCDDARK}*{SC_DKFRM}) * {CCDFLAT}/{SC_FFFRM}
127 WRITE/DESCR {P2} CCDSTAT/I/5/2 1,1 ! dark, flat correction done
128 P1 = "{P2}" !if ill.corr or fringe.corr has to be done: change name
129
130 ELSEIF P3(1:6) .EQ. "OXXBXF" THEN ! overscan + bias + flat
131 COMPUTE/IMAGE -
132 {P2} = ({P1} - {CCDSCAN} - {SC_BSFRM}) * {CCDFLAT}/{SC_FFFRM}
133 WRITE/DESCR {P2} CCDSTAT/I/1/1 1 ! overscan correction done
134 WRITE/DESCR {P2} CCDSTAT/I/4/1 1 ! bias correction done
135 WRITE/DESCR {P2} CCDSTAT/I/6/1 1 ! flat correction done
136 P1 = "{P2}" !if ill.corr or fringe.corr has to be done: change name
137
138 ELSEIF P3(1:6) .EQ. "OXXXDF" THEN ! overscan + dark + flat
139 COMPUTE/IMAGE -
140 {P2} = ({P1} - {CCDSCAN} - {CCDDARK}*{SC_DKFRM}) * {CCDFLAT}/{SC_FFFRM}
141 WRITE/DESCR {P2} CCDSTAT/I/1/1 1 ! overscan correction done
142 WRITE/DESCR {P2} CCDSTAT/I/5/2 1,1 ! dark, flat correction done
143 P1 = "{P2}" !if ill.corr or fringe.corr has to be done: change name
144
145 ELSEIF P3(1:6) .EQ. "XXXBDF" THEN ! bias + dark + flat
146 COMPUTE/IMAGE -
147 {P2} = ({P1} - {SC_BSFRM} - {CCDDARK}*{SC_DKFRM}) * {CCDFLAT}/{SC_FFFRM}
148 WRITE/DESCR {P2} CCDSTAT/I/4/3 1,1,1 ! bias dark, flat correction done
149 P1 = "{P2}" !if ill.corr or fringe.corr has to be done: change name
150
151 ELSEIF P3(1:6) .EQ. "OXXBDF" THEN ! overscan + bias + dark + flat
152 COMPUTE/IMAGE {P2} = -
153 ({P1}-{CCDSCAN} - {SC_BSFRM} - {CCDDARK}*{SC_DKFRM}) * {CCDFLAT}/{SC_FFFRM}
154 WRITE/DESCR {P2} CCDSTAT/I/1/1 1 ! overscan correction done
155 WRITE/DESCR {P2} CCDSTAT/I/4/3 1,1,1 ! bias dark, flat correction done
156 P1 = "{P2}" !if ill.corr or fringe.corr has to be done: change name
157 ENDIF
158 !
159 ! *** here the part for the less frequently used corrections
160 IF P3(7:8) .EQ. "IX" THEN
161 IF M$EXISTD(SC_FFFRM,"ILLFLAT") .EQ. 1 .OR. -
162 M$EXISTD(SC_FFFRM,"SKYFLAT") .EQ. 1 THEN !illum.corr. already done
163 WRITE/OUT "*** WARNING: flatfield has already been illumination corrected"
164 WRITE/OUT "*** '{SC_ILFRM}' will not be applied!"
165 ELSE
166 IF M$EXISTD(SC_ILFRM,"ILLCOR") .EQ. 1 THEN !illum.corr. by dome-flat
167 COMPUTE/IMAGE -
168 {P2} = {P1}/{CCDILLUM}*{SC_ILFRM}
169 WRITE/DESCR {P2} CCDSTAT/I/7/1 1 ! illum correction done
170 ELSE IF M$EXISTD(SC_ILFRM,"SKYCOR") .EQ. 1 THEN !illum.corr. by dome-flat
171 COMPUTE/IMAGE -
172 {P2} = {P1}*{CCDILLUM}/{SC_ILFRM}
173 WRITE/DESCR {P2} CCDSTAT/I/7/1 1 ! illum correction done
174 ELSE
175 WRITE/OUT "*** ERROR: No proper illumination correction frames specified!"
176 WRITE/OUT "*** Use ILLCOR/CCD or SKYCOR/CCD to create correction frame."
177 ENDIF
178 ENDIF
179
180 ELSEIF P3(7:8) .EQ. "XQ" THEN
181 COMPUTE/IMAGE -
182 {P2} = {P1} - {CCDFRING}*{SC_FRFRM}
183 WRITE/DESCR {P2} CCDSTAT/I/8/1 1 ! fringe correction done
184
185 ELSEIF P3(7:8) .EQ. "IQ" THEN
186 IF M$EXISTD(SC_ILFRM,"ILLCOR") .EQ. 1 THEN !illum.corr. by dome-flat
187 COMPUTE/IMAGE -
188 {P2} = {P1}*{CCDILLUM}*{SC_ILFRM} - {CCDFRING}*{SC_FRFRM}
189 ELSE IF M$EXISTD(SC_ILFRM,"SKYCOR") .EQ. 1 THEN !illum.corr. by dome-flat
190 COMPUTE/IMAGE -
191 {P2} = {P1}*{CCDILLUM}/{SC_ILFRM} - {CCDFRING}*{SC_FRFRM}
192 ELSE
193 WRITE/OUT "*** ERROR: No proper illumination correction frames specified!"
194 WRITE/OUT "*** Use ILLCOR/CCD or SKYCOR/CCD to create correction frame."
195 ENDIF
196 WRITE/DESCR {P2} CCDSTAT/I/7/2 1,1 ! illum, fringe correction done
197 ENDIF
198 !
199 RETURN