| 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 |