| | 1 | Let's run some UH88 Tek cam images in IPP 2.6.1 |
| | 2 | (This assumes you've installed IPP 2.6.1 and aren't totally clueless) |
| | 3 | |
| | 4 | == Configuration == |
| | 5 | |
| | 6 | * Modifications to site.config |
| | 7 | Add two directories for your data and work files (the Data file isn't crucial) |
| | 8 | |
| | 9 | TEKDATA STR <where your data is> |
| | 10 | TEKWORK STR <where IPP can dump its data> |
| | 11 | |
| | 12 | * Modifications to system.config |
| | 13 | Add camera information for TEK under "Setups for each camera system" and "camera names as expected by DVO". (This could already be done) |
| | 14 | CAMERAS METADATA |
| | 15 | TEK STR tek/camera.config |
| | 16 | |
| | 17 | DVO.CAMERAS METADATA |
| | 18 | TEK STR tek |
| | 19 | |
| | 20 | * Initiating new database |
| | 21 | Create a new project mysql database for your data. (This assumes you've done the preliminary dbadmin setup) |
| | 22 | dbadmin project DBserver DBuser DBname |
| | 23 | pxadmin -create -dbname DBname |
| | 24 | Where DBserver, DBuser, and DBname are defined by the user |
| | 25 | |
| | 26 | * Fits Headers of Input Images |
| | 27 | Here we shall assume a basic knowledge of fits headers and correct setup of the camera. (It is likely your images will be problem free) |
| | 28 | |
| | 29 | |
| | 30 | * Tek's configuration files |
| | 31 | I added a tek config folder under /jfang/psconfig/default.linrh/share/ippconfig/ and named it "tek". In this folder, I copied over isp camera's configuration files from /jfang/psconfig/default.linrh/share/ippconfig/isp/ and edited them: |
| | 32 | |
| | 33 | In format.config, cmf.config, cmp.config: |
| | 34 | Edited the TELESCOP, INSTRUME, and DETECTOR fields. |
| | 35 | I modified these fields: |
| | 36 | FPA.NAME STR NAXIS |
| | 37 | CELL.TRIMSEC.SOURCE STR VALUE |
| | 38 | CELL.BIASSEC.SOURCE STR HEADER |
| | 39 | CELL.TRIMSEC STR [21:2068,1:2048] |
| | 40 | CELL.BIASSEC STR BIASSEC |
| | 41 | FPA.FILTER STR FILTER |
| | 42 | CELL.XBIN STR CCDBIN1 |
| | 43 | CELL.YBIN STR CCDBIN2 |
| | 44 | |
| | 45 | In dvo.config: |
| | 46 | CATDIR /media/usbdisk/scr1/catdir.synth.grizy/ |
| | 47 | DATE-KEYWORD DATE-OBS |
| | 48 | DATE-MODE YYYY-MM-DD |
| | 49 | UT-KEYWORD UT |
| | 50 | JD-KEYWORD JD |
| | 51 | |
| | 52 | In ppImage.config: |
| | 53 | I turned off all dark and shutter fields to FALSE. |
| | 54 | |
| | 55 | In psastro.config, I changed the catalog path: |
| | 56 | DVO.CATDIR STR /media/usbdisk/scr1/catdir.synth.grizy/ |
| | 57 | |
| | 58 | In camera.config, I modified file formats and filter: |
| | 59 | FORMATS METADATA |
| | 60 | TEK STR tek/format.config |
| | 61 | CMP STR tek/cmp.config |
| | 62 | CMF STR tek/cmf.config |
| | 63 | END |
| | 64 | |
| | 65 | FILTER.ID METADATA |
| | 66 | R STR R |
| | 67 | END |
| | 68 | |
| | 69 | DVO.CAMERADIR STR tek |
| | 70 | |
| | 71 | == Data Injection and Registration== |
| | 72 | |
| | 73 | * How to inject data |
| | 74 | I used the ipp_serial_inject.pl command. Looked at the notes for Essence Test to figure it out. |
| | 75 | |
| | 76 | ipp_serial_inject.pl --workdir path://TEKWORK/ --dbname DBname path_to_data/XXX.fits |
| | 77 | |
| | 78 | The data can be register in one of two ways |
| | 79 | |
| | 80 | ipp_serial_register.pl --dbname DBname |
| | 81 | |
| | 82 | or by calling pantasks (the data can then be registered in parallel) |
| | 83 | |
| | 84 | pantasks |
| | 85 | module pantasks.pro |
| | 86 | module.tasks |
| | 87 | all.off |
| | 88 | controller host add HOSTNAME |
| | 89 | register.on |
| | 90 | run |
| | 91 | |
| | 92 | you can observe the status of the processing with |
| | 93 | status |
| | 94 | controller status |
| | 95 | and once the processing is done |
| | 96 | stop |
| | 97 | |
| | 98 | == Detrend Construction == |
| | 99 | |
| | 100 | To make the detrend files it is a simple matter of executing the appropriate dettool calls |
| | 101 | |
| | 102 | dettool -dbname DDBname -definebyquery -det_type XXX -filelevel FPA -workdir path://TEKWORK/ -inst TEK -telescope UH88 -select_exp_type YYY |
| | 103 | |
| | 104 | where XXX represents the type of detrend you want to construct (BIAS, FLAT, etc.) and YYY represents the name in the fits headers that corresponds to the appropriate frames (BIAS, FLATFIELD, FLAT, etc.) It is important to call the dettool commands in the correct order (BIAS before DARK before FLAT, etc.) otherwise IPP will crash. For Tek data it is okay to leave the filelevel at FPA (since each image represents the entire focal plane array) but on mosaic cameras it may be necessary to replace FPA with CHIP. |
| | 105 | |
| | 106 | The dettool places the detrend frames into a queue which can then be executed by pantasks or by |
| | 107 | |
| | 108 | ipp_serial_detrend.pl --dbname DBname |
| | 109 | |
| | 110 | Many things can go wrong at this point. Maybe IPP expects overscan but your images don't contain it, maybe your fits header is wrong, maybe your trying to make a FLAT before a DARK. Extensive examination of .log and .trace files may be necessary to debug the problem. |
| | 111 | |
| | 112 | If you have a problem and wish to abort a detrend run, note the number of the run in IPPMonitor and call |
| | 113 | |
| | 114 | dettool -updatedetrun -dbname vysostest1 -det_id # -state drop |
| | 115 | |
| | 116 | This will prevent IPP from trying to execute the rest of an aborted run |
| | 117 | |
| | 118 | == Chip and Camera == |
| | 119 | |
| | 120 | * The Chip step |
| | 121 | |
| | 122 | Executing the chip step can occur in pantasks or from the command line with |
| | 123 | |
| | 124 | ipp_serial_chip.pl --dbname DBname |
| | 125 | |
| | 126 | in either case no preliminary calls are necessary. |
| | 127 | |
| | 128 | * WCS headers |
| | 129 | |
| | 130 | For the camera step, WCS headers are crucial for the astrometry. Naturally you will need to know this for the camera at the current time. This should already be in the images. |
| | 131 | |
| | 132 | The header looks like the following |
| | 133 | |
| | 134 | CTYPE1 = 'RA---TAN' |
| | 135 | CTYPE2 = 'DEC--TAN' |
| | 136 | CRPIX1 = 1024 |
| | 137 | CRPIX2 = 1024 |
| | 138 | CRVAL1 = 358.37 |
| | 139 | CRVAL2 = 54.9575 |
| | 140 | CDELT1 = 0.22 |
| | 141 | CDELT2 = 0.22 |
| | 142 | CD1_1 = -6.100000E-5 |
| | 143 | CD1_2 = 0 |
| | 144 | CD2_1 = 0 |
| | 145 | CD2_2 = 6.100000E-5 |
| | 146 | |
| | 147 | The CD matrix determines rotation. Hopefully a manual entry of the above information will be unnecessary. |
| | 148 | |
| | 149 | * The camera step |
| | 150 | |
| | 151 | Like the chip step a call in pantasks or from the command line will do |
| | 152 | |
| | 153 | ipp_serial_camera.pl --dbname DBname |
| | 154 | |
| | 155 | * How do rerun chip/camera step |
| | 156 | Queue it up again: |
| | 157 | > chiptool -queue -exp_type OBJECT |
| | 158 | Or you can replace exp_type with whatever field you would like to use in your queue, like a specific image you want to queue up. |
| | 159 | |
| | 160 | == Warping == |
| | 161 | |
| | 162 | * To be added when it works |
| | 163 | |
| | 164 | == Difference == |
| | 165 | |
| | 166 | * To be added when it works |
| | 167 | |
| | 168 | == Stacking == |
| | 169 | |
| | 170 | * To be added when it works |