| 157 | | Further discussion on configuration file options, command line options, etc coming soon. |
| | 156 | |
| | 157 | Some options for relastro are summarized here. These can either be provided on the command line or in your camera's dvo.config file: |
| | 158 | * RELASTRO_SIGMA_LIM |
| | 159 | * If set and nonzero, than measurements with photometry errors larger than this value are not considered in the analysis |
| | 160 | * RELASTRO_SRC_MEAS_TOOFEW |
| | 161 | * If an object has this many detections or fewer, do not consider the object during the analysis. This is particularly effective at filtering out spurious measurements. |
| | 162 | * +photflags |
| | 163 | * During reduction, the IPP sets a number of quality flags. Those flags which correspond to problematic detections (e.g. saturation, cosmic rays, etc) can be excluded during relastro analysis by using this option. The specific bitmask defining which flags are problematic is listed in the Photcodes.dat DVO table as ASTROM_BAD_MASK |
| | 164 | * instmag |
| | 165 | * Set this to a range of instrumental magnitudes to consider. This can be used to filter out faint or saturated objects |
| | 166 | |
| | 167 | === Evaluating the Fit === |
| | 168 | |
| | 169 | There are several ways to ascertain whether relastro did a satisfactory job during fitting. |
| | 170 | |
| | 171 | * '''Textual output from relastro''' |
| | 172 | Relastro outputs lines like this to the terminal during --update-chips |
| | 173 | {{{ |
| | 174 | image 3 : Nstars: 591 |
| | 175 | scatter limit: 0.826633 based on 403 detections; using 377 of 591 for fit |
| | 176 | scatter limit: 0.290518 based on 403 detections; using 376 of 591 for fit |
| | 177 | scatter limit: 0.288850 based on 403 detections; using 379 of 591 for fit |
| | 178 | }}} |
| | 179 | |
| | 180 | This says the following: For the third image (each chip is a separate "image"), there are 591 stars which pass all filtering criteria. By comparing these detections to each object's average position, the 3-sigma scatter is .826633 pixels. 377 detections have scatter less than this, and are being used to update the astrometry solution. This process repeats two more times, and the final 3-sigma scatter appears to be .289 pixels. |
| | 181 | |
| | 182 | * ''' DVO table values ''' |
| | 183 | The average (.cpt) dvo table has two fields -- RA_ERR and DEC_ERR -- which lists the positional uncertainty for each object (e.g. the error on the weighted mean of the measurements ~ rms/sqrtN). These values are updated each time relastro --update-objects is run. They are reported in arcseconds. These values can be extracted in DVO via the command |
| | 184 | |
| | 185 | {{{ |
| | 186 | avextract ra dec dra ddec |
| | 187 | }}} |
| | 188 | |
| | 189 | The help information avextract --help fields seems to mislabel dra and ddec as being in degrees; I believe they are still arcseconds. |