=
=  This is the modification parameters file for test image 2 supplied with
=  version 1.0 of DoPHOT.  This provides an example of a parameters file with
=  ALL valid parameters specified, even though some take on the default 
=  values.  
=
FWHM = 2.7             Approx FWHM of objects (pixels) along major axis.
AXIS_RATIO = 0.95      For star objects.  AR=b/a; b=minor axis.
TILT = 0.0             Angle of major axis in degrees; +x=0; +y=90.
SKY = 27.0             Approximate mean sky value in data numbers.
NFITBOX_X = 11         Size of fit box in the x-direction.
NFITBOX_Y = 11         Size of fit box in the y-direction.
MASKBOX_X = 5          Size of mask box size in x.
MASKBOX_Y = 5          Size of mask box size in y.
APBOX_X = 23.0         Size of aperture photometry box in x.
APBOX_Y = 23.0         Size of aperture photometry box in y.
IBOTTOM = -53          Lowest allowed data value in data numbers.
ITOP = 30000           Maximum allowed data value in data numbers.
THRESHMIN = 512.0      Value of lowest threshold.
THRESHMAX = 10000.0    Value of maximum threshold.
THRESHDEC = 1.0        Threshold decrement in powers-of-2.
EPERDN = 7.4           Electrons per data number.
RDNOISE = 45.1         Readout noise in electrons.
=
AUTOSCALE = 'NO'       Auto-scaling of sizes by FWHM.
AUTOTHRESH = 'NO'      Auto-scaling of thresholds.
=
PARAMS_DEFAULT = 'param_default1_0'  Default parameters file name.
PARAMS_OUT = 'param_out_n2041_bsh'   Output parameters file name.
IMAGE_IN = 'image_in_n2041_b'        Input image name. 
IMAGE_OUT = ' '                      Output image name.
OBJECTS_IN = ' '                     Input object list file name.
OBJECTS_OUT = 'obj_out_n2041_bsh'    Output object list file name.
SHADOWFILE_IN = ' '                  Input shadow file name.
SHADOWFILE_OUT = ' '                 Output shadow file name.
LOGFILE = 'logfile_n2041_bsh'        Log file name.  TERM for screen.
LOGVERBOSITY = 2                     Verbosity of log file; (0-4).
=
=
=  OCCASIONALLY UPDATED PARAMETERS.  These parameters tend to not change for a 
=  set of images obtained during a single observing run or for frames of a 
=  single field.  The defaults for the flags PSFTYPE, SKYTYPE, and OUTTYPE are
=  PGAUSS, PLANE, and FULL, respectively.
=
RESIDNOISE = 0.2       Fraction of noise to ADD to noise file.
FOOTPRINT_NOISE = 1.2  Expand stars in noise file by this amount.
NPHSUB = 1             Limiting surface brightness for subtractions.
NPHOB = 1              Limiting surface brightness for obliterations.
ICRIT = 5              Obliterate if # of pixels > ITOP exceeds this.
CENTINTMAX = 50000.0   Obliterate if central intensity exceeds this.
CTPERSAT = 1.0e4       Assumed intensity for saturated pixels.
STARGALKNOB = 1.5      Star/galaxy discriminator.
STARCOSKNOB = 1.0      Object/cosmic-ray discriminator.
SNLIM7 = 10.0          Minimum S/N for 7-parameter fit.
SNLIM = 0.5            Minimum S/N for a pixel to be in fit subraster.
SNLIMMASK = 4.0        Minimum S/N through mask to identify an object.
SNLIMCOS  = 3.0        Minimum S/N to be called a cosmic ray.
NBADLEFT = 0           Ignore pixels closer to the left edge than this.
NBADRIGHT = 0          Ignore pixels closer to the right edge than this.
NBADTOP = 0            Ignore pixels closer to the top edge than this.
NBADBOT = 0            Ignore pixels closer to the bottom edge than this.
=
PSFTYPE = 'PGAUSS'        PSF type: (PGAUSS)
SKYTYPE = 'HUBBLE'        SKY type: (PLANE, HUBBLE)
OBJTYPE_IN = 'COMPLETE'   Input format: (COMPLETE, INTERNAL)
OBJTYPE_OUT = 'INTERNAL'  Output format: (COMPLETE, INCOMPLETE, INTERNAL)
=
=
=  RARELY UPDATED PARAMETERS.  These are specialized parameters that rarely
=  need changing even when measuring images of very different sorts of fields
=  and/or from different telescope/detector combinations.
=
NFITITER = 10          Maximum number of iterations.
NPARAM = 7             Maximum number of PSF fit parameters.
NFITMAG = 4            No. of PSF parameters to get magnitudes.
NFITSHAPE = 7          No. of PSF parameters to get shape and mags.
NFITBOXFIRST_X = 31    Size of fit box in x for first pass.
NFITBOXFIRST_Y = 31    Size of fit box in y for first pass.
CHI2MINBIG = 16        Critical CHI-squared for a large object.
XTRA = 25              We need more S/N if some pixels are missing.
SIGMA1 = 0.10          Max. frac. scatter in sigma_x for stars.
SIGMA2 = 0.10          Max. scatter in xy cross term for stars.
SIGMA3 = 0.10          Max. frac. scatter in sigma_y for stars.
ENUFF4 = 0.50          Fraction of pixels needed for 4-param fit.
ENUFF7 = 0.65          Fraction of pixels needed for 7-param fit.
COSOBLSIZE = 0.9       Size of obliteration box for a cosmic ray.
APMAG_MAXERR = 0.1     Max anticipated error for aperture phot report.
PIXTHRESH = 1.0        Trigger on pixels higher than noise*PIXTHRESH.
BETA4 = 1.0            R**4 coefficient modifier.
BETA6 = 1.0            R**6 coefficient modifier.
=
=
=  AUTO SCALING PARAMETERS.  These parameters are used only if the auto-scaling
=  flags are turned on.  Box sizes, and threshold levels can be scaled 
=  according to the FWHM of objects and the sky and readout noise values.
=
SCALEFITBOX = 3.0      Size of fit box in units of FWHM.
FITBOXMIN = 5.0        Smallest allowed fit box size.
SCALEAPBOX = 6.0       Size of aperture phot box in units of FWHM.
APBOXMIN = 7.0         Smallest allowed aperture phot box size.
SCALEMASKBOX = 1.5     Size of mask box in units of FWHM.
AMASKBOXMIN = 5.0      Smallest allowed mask box size.
SIGMAIBOTTOM = 10.0    Level of IBOTTOM below sky in units of noise.
SIGMATHRESHMIN = 2.0   Level of THRESHMIN above sky in units of noise.
=
=
=  PARAMETER LIMITS.  These variables limit the legal ranges of the PSF and 
=  sky parameters.  Be sure to understand their function well before changing 
=  any of these values.  Positive values refer to fractional changes; negative
=  values to absolute changes; zero ABSLIM's turn the corresponding tests off.
=
RELACC1 = 0.01         Convergence criterion for sky.
RELACC2 = -0.03        Convergence criterion for x-position.
RELACC3 = -0.03        Convergence criterion for y-position.
RELACC4 = 0.01         Convergence criterion for for central intensity.
RELACC5 = 0.03         Convergence criterion for sigma-x.
RELACC6 = 0.1          Convergence criterion for sigma-xy.
RELACC7 = 0.03         Convergence criterion for sigma-y.
ABSLIM1 = -1.0e8       Allowed range for sky value.
ABSLIM2 = -1.0e3       Allowed range for x-position.
ABSLIM3 = -1.0e3       Allowed range for y-position.
ABSLIM4 = -1.0e8       Allowed range for central intensity.
ABSLIM5 = -1.0e3       Allowed range for sigma-x.
ABSLIM6 = -1.0e3       Allowed range for sigma-xy.
ABSLIM7 = -1.0e3       Allowed range for sigma-y.
END
