| | 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 | UH8KDATA STR <where you data is> |
| | 10 | UH8KWORK 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 | UH8K STR uh8k/camera.config |
| | 16 | |
| | 17 | DVO.CAMERAS METADATA |
| | 18 | UH8K STR uh8k |
| | 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://UH8KWORK/ --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 vysostest1 -definebyquery -det_type XXX -filelevel CHIP -workdir path://UH8KWORK/ -inst UH8K -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. |
| | 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 DBname -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 | |
| | 133 | * The camera step |
| | 134 | |
| | 135 | Like the chip step a call in pantasks or from the command line will do |
| | 136 | |
| | 137 | ipp_serial_camera.pl --dbname DBname |
| | 138 | |
| | 139 | * How do rerun chip/camera step |
| | 140 | Queue it up again: |
| | 141 | > chiptool -queue -exp_type OBJECT |
| | 142 | 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. |
| | 143 | |
| | 144 | == Warping == |
| | 145 | |
| | 146 | * To be added when it works |
| | 147 | |
| | 148 | == Difference == |
| | 149 | |
| | 150 | * To be added when it works |
| | 151 | |
| | 152 | == Stacking == |
| | 153 | |
| | 154 | * To be added when it works |