| | 61 | |
| | 62 | * psphot options. |
| | 63 | |
| | 64 | There are a variety of options and settings for psphot. These are controlled by command line optional arguments as well as by the "recipes" file located in the "share/ippconfig/" directory in your IPP installation. On my machine this is "/Volumes/data/PS1/code/ipp/default.darwin/share/ippconfig". The default recipes are in "share/ippconfig/recipes", with camera-specific overriding configuration files in the camera subdirectories in "share/ippconfig", e.g. "share/ippconfig/gpc1" for the PS1 GPC1 camera. |
| | 65 | |
| | 66 | Here's an example of a recipes file for psphot: |
| | 67 | |
| | 68 | <pre> |
| | 69 | SAVE.OUTPUT BOOL TRUE |
| | 70 | SAVE.BACKMDL BOOL FALSE |
| | 71 | SAVE.BACKMDL.STDEV BOOL FALSE |
| | 72 | SAVE.BACKGND BOOL FALSE |
| | 73 | SAVE.BACKSUB BOOL FALSE |
| | 74 | SAVE.RESID BOOL FALSE |
| | 75 | SAVE.PSF BOOL FALSE |
| | 76 | LOAD.PSF BOOL FALSE |
| | 77 | SAVE.PLOTS BOOL FALSE |
| | 78 | |
| | 79 | # the zero point is used to set a basic scale for DVO |
| | 80 | # XXX it may not currently be read : double check this (EAM) |
| | 81 | ZERO_POINT F32 25.000 # zero point used by DVO |
| | 82 | ZERO_PT F32 25.000 # zero point used by DVO |
| | 83 | |
| | 84 | OUTPUT.FORMAT STR PS1_DEV_1 |
| | 85 | |
| | 86 | # these parameter govern how the background is measured |
| | 87 | BACKGROUND.XBIN S32 128 # size of background superpixels |
| | 88 | BACKGROUND.YBIN S32 128 # size of background superpixels |
| | 89 | IMSTATS_NPIX S32 10000 # number of pixels to use for sky estimate boxes: |
| | 90 | |
| | 91 | SKY_BIAS F32 0.0 # offset applied to measured sky (FOR TESTING) |
| | 92 | SKY_FIT_ORDER S32 0 |
| | 93 | SKY_FIT_LINEAR BOOL FALSE |
| | 94 | SKY_STAT STR FITTED_MEAN_V4 # statistic used to measure background |
| | 95 | SKY_CLIP_SIGMA F32 2.0 # statistic used to measure background |
| | 96 | SKY_SIG F32 1.0 # optional sky error for |
| | 97 | |
| | 98 | # allowed values for SKY_STAT: |
| | 99 | # SAMPLE_MEAN, SAMPLE_MEDIAN, CLIPPED_MEAN, ROBUST_MEAN, ROBUST_QUARTILE, FITTED_MEAN |
| | 100 | |
| | 101 | # masking parameters (XXX EAM : rework this to use psRegion like ANALYSIS_REGION) |
| | 102 | XMIN F32 0 # minimum valid x-coord |
| | 103 | XMAX F32 0 # maximum valid x-coord |
| | 104 | YMIN F32 0 # minimum valid y-coord |
| | 105 | YMAX F32 0 # maximum valid y-coord |
| | 106 | |
| | 107 | # peak finding |
| | 108 | PEAKS_SMOOTH_SIGMA F32 1.0 # smoothing kernel sigma in pixels |
| | 109 | PEAKS_SMOOTH_NSIGMA F32 2.0 # smoothing kernel width in sigmas |
| | 110 | PEAKS_NSIGMA_LIMIT F32 25.0 # peak significance threshold |
| | 111 | PEAKS_NSIGMA_LIMIT_2 F32 5.0 # peak significance threshold |
| | 112 | PEAKS_NMAX S32 0 # on first pass, only keep NMAX peaks (0 == all) |
| | 113 | PEAKS_MIN_GAUSS F32 0.5 # Minimum valid fraction of kernel |
| | 114 | |
| | 115 | # parameters to control the selection of the peak in the Sx,Sy plane |
| | 116 | MOMENTS_SCALE F32 0.25 |
| | 117 | MOMENTS_SN_MIN F32 100.0 # min S/N to measure moments |
| | 118 | MOMENTS_SX_MAX F32 50.0 |
| | 119 | MOMENTS_SY_MAX F32 50.0 |
| | 120 | MOMENTS_AR_MAX F32 1.5 # maximum axial ratio: 1 / AR < (sx / sy) < AR |
| | 121 | |
| | 122 | # basic object statistics |
| | 123 | SKY_INNER_RADIUS F32 15 # square annulus for local sky measurement |
| | 124 | SKY_OUTER_RADIUS F32 25 # square annulus for local sky measurement |
| | 125 | PSF_MOMENTS_RADIUS F32 3 # calculate initial source moments with this radius |
| | 126 | PSF_SN_LIM F32 50 # minimum S/N for stars used for PSF model |
| | 127 | PSF_MAX_NSTARS S32 200 # limit number of stars used for PSF model |
| | 128 | PSF_CLUMP_NSIGMA F32 1.5 # region of Sx,Sy plane to use for selecting PSF stars |
| | 129 | PSF_CLUMP_GRID_SCALE F32 0.5 # size of Sx,Sy image pixel |
| | 130 | |
| | 131 | PSF_CLUMP_NX S32 1 # subdivide image in to NX x NY regions for |
| | 132 | PSF_CLUMP_NY S32 1 # selecting PSF stars |
| | 133 | </pre> |
| | 134 | |
| | 135 | |
| | 136 | |
| | 137 | Currently 'psphot' does not output it's options or have an help message. This is something that is being worked on and in fact might even be a result of our efforts to understand psphot better. |
