version v1_0
date 03-Nov-2000

############################################################################
## Locus Parameters
##
## LOCUSFILEDIR tells where the locus files are.  These file names are
## currently hardcoded in etc/quasarsParamsRead.tcl
##
## The files are:
## lowzlocus.par -- ugri stellar locus
## midzlocus.par -- smaller ugri stellar locus for mid-z targets
## hizlocus.par  -- griz stellar locus
##
############################################################################

LOCUSFILEDIR $TARGET_DIR/examples

############################################################################
##
## Set high-z magnitude limit (NEW!  08/28/00, GTR)
##
## (OK, GTR, 09/22/00 -- Not necessarily final though)
############################################################################

HIZMAGLIMIT 20.5 #limiting magnitude in i', corrected for reddening

############################################################################
## Magnitude limits for Cap targets
##
## These are the magnitude limits for cap objects.  These only apply
## to low-z quasar candidates selected from the ugri color cube.
##
## Removed the the g' and r' limits (GTR, 08/28/00)
##
## (OK, GTR, 09/22/00 -- Not necessarily final though)
############################################################################

CAPILIMIT       19.2 #limiting magnitude in i', corrected for reddening

############################################################################
## Magnitude limits for Skirt targets
##
## These are the magnitude limits for skirt objects.  These only apply
## to low-z quasar candidates selected from the ugri color cube.
##
## Removed the the g' and r' limits (GTR, 08/28/00)
##
## (OK, GTR, 09/22/00 -- Not necessarily final though)
############################################################################

SKIRTILIMIT     19.2 #limiting magnitude in i', corrected for reddening

############################################################################
##
## These are the magnitudes at which Luptitudes deviate from regular
## magnitudes.  We need to know these number in order to correct
## colors of objects where one band is not detected.  These are used
## by the limitcorrection code.
##
############################################################################

LOWZULIMIT      22.7 #limiting magnitude to check error reasonableness in u'
LOWZGLIMIT      23.4 #limiting magnitude to check error reasonableness in g'
LOWZRLIMIT      23.0 #limiting magnitude to check error reasonableness in r'
LOWZILIMIT      22.4 #limiting magnitude to check error reasonableness in i'
LOWZZLIMIT      21.0 #limiting magnitude to check error reasonableness in z'

############################################################################
## Systematic Errors
##
## Despite our best efforts, the photometric errors will not
## incorporate all of the possible error in the determination of
## magnitudes for these objects.  As such add some additional error
## based on practical experience.
##
## NOTE: Xiaohui, or Heidi, please explain where these numbers come
## from, and comment on whether or not they are current.
##
############################################################################

#SYSUERR         0.1 #systematic photmetric error in u'
SYSUERR         0.03 #systematic photmetric error in u'
SYSGERR         0.03 #systematic photmetric error in g'
SYSRERR         0.03 #systematic photmetric error in r'
SYSIERR         0.03 #systematic photmetric error in i'
SYSZERR         0.03 #systematic photmetric error in z'

############################################################################
##
## NOTE: Heidi, or Xiaohui, please comment
##
## This parameter is used in the call to determineCapSkirt.
############################################################################

CAPSTARS        1500.0 #sets the limit on the boundary of the cap region based
                #        on the stellar density from the Bahcall-Soneira
                #        model (1500/sq degree for M<20)

############################################################################
## Increase error in red stars with asymmetric errors
##
## This is a place holder to deal with the asymmetric error at faint
## end.
##
############################################################################

BIGNSIGERRORS	8.0

############################################################################
## MINDETECT and MAXDETECT are parameters used in flag checking,
## basically, if the photometric error is smaller than MINDETECT, then
## the object should have be set BINNED1, otherwise, there is a
## problem with the image; similarly, if the photometric error is
## larger than MAXDETECT, then this object should not have BINNED1 */
##
############################################################################

MINDETECT	0.12
MAXDETECT	0.25


############################################################################
## GALAXY CUT PARAMETERS
## These parameters set the width and orientation of the cut along the 
## fundamental plane of galaxies within 3D color space.
## GALMAX and GALMIN are the width, while GAL_COEFF are the components
## of the normal to the fundamental plane.
##
## If GALCUTBYPLANE is 1, then use this galaxy cut, otherwise, just do
## a simple color cut.
############################################################################

GALMAX 0.4
GALMIN -0.1
GALXCOEFF -0.0279
GALYCOEFF -0.2350
GALZCOEFF 0.9716

GALCUTBYPLANE 0

############################################################################
## Toggle Switch for Rejection and Inclusion Boxes
##
## The CUTBOXES flag sets whether the various cuts like Astar, WD and W+M
## are implemented.  
##
## 1 implements cuts, 0 ignores cuts.
##
## For the North, this CUTBOXES should be 1.  In the South, we may set
## it to 0.  The flags following CUTBOXES control a specific cut (A
## star, WD, W+M).
##
## The TARGETMIDZ flag sets automatic targeting on midz objects.
## TARGETMIDZSOUTH allows for a brigther magnitude limit in the south for
## mid-z candidates.
##
## So, in the south, the following values should be used CUTBOXES = 0,
## TARGETMIDZ = 1, TARGETMIDZSOUTH = 1.
##
## (OK, GTR, 09/22/00)
############################################################################

CUTBOXES	1      
CUTASTARS	1
CUTWD		1
CUTWM		1
TARGETMIDZ	1
TARGETMIDZSOUTH	0

############################################################################
## A Star Box Limits
##
## These parameters set the constraints of the Astar cut in the
## stellar locus within the relevant bands.  Objects within this box
## are removed, unless CUTBOXES is 0.  FIRST sources should in this
## box should NOT be rejected.
##
## Rationale for these limits.  If you change the limits, please
## change these comments.  
##
## Between redshift 2.5 and 3.0, quasars have g'-r' colors of about
## 0.1+/-0.l
##
## UGMINASTAR=0.7 -- The UVX cut is at or below 0.8.  We can go to 0.7
## if we impose cuts on the red colors.
##
## UGMAXASTAR=1.4 -- A stars are dwindling by here and we are in
## danger of cutting high-redshift quasars if we go much redder.
##
## GRMAXASTAR=0.00 -- Much redder than this will cut into the 2.5 < z
## < 3.0 quasar regime.
##
## GRMINASTAR=-0.5 -- We need a blue limit because we don't want to
## throw out interesting objects, especially if the density of A stars
## is low blueward of this.
##
## RIMINASTAR=-0.5 -- We need a blue limit because we don't want to
## throw out interesting objects, especially if the density of A stars
## is low blueward of this.
##
## RIMAXASTAR=0.2 -- Helps keep from rejecting real quasars
##
## IZMINASTAR=-0.4 -- We need a blue limit because we don't want to
## throw out interesting objects, especially if the density of A stars
## is low blueward of this.
##
## IZMAXASTAR=0.2 -- Helps keep from rejecting real quasars
##
## (OK, GTR, 09/22/00)
############################################################################

UGMINASTAR 	0.7
UGMAXASTAR	1.4
GRMINASTAR 	-0.5
GRMAXASTAR	0.0
RIMINASTAR 	-0.5
RIMAXASTAR	0.2
IZMINASTAR 	-0.4
IZMAXASTAR	0.2

############################################################################
## Mid-z Box Limits
##
## These parameters set the constraints of the Mid-z inclusion
## box(es).  Quasars with 2.5 < z < 3.0 tend to have colors that put
## them very close to, or in the stellar locus.  In order to keep from
## missing too many such objects, we may choose to cut into the locus
## to get some more of these objects.  This will have a significant
## negative effect upon the efficiency of the algorithm as a whole;
## however, it may be worth it.
##
## Currently, there are two distinct regions.  This is largely because
## there is a small gap in u'-g' between where the stellar locus "end"
## and the quasars population "begins".  NOTE: If we set the
## parameters right, we should be able to do it with one box.
##
## NOTE: This is an INCLUSION box and should NOT be tied to the A star
## rejection box in any way.
##
## Rationale for these limits.  If you change the limits, please
## change these comments.
##
## Between redshift 2.5 and 3.0, quasars have g'-r' colors of about
## 0.1+/-0.l
##
## UGMINMIDZ=0.6 -- This is slightly bluer than the red limit 
## of UVX quasars.
##
## UGMAXMIDZ=1.5 -- Objects redder than this will be picked out as
## high-redshift candidates.
##
## GRMINMIDZ=0.00 -- Right now this is the same as the red edge of the
## A star box.  
## 
## GRMAXMIDZ=0.20 -- This cut is slightly redder than the end of the
## stellar locus and allows us to dip into the locus slightly.
##
## RIMINMIDZ=-0.10 -- Further constrains color box.  
## 
## RIMAXMIDZ=0.40 -- Further constrains color box.
##
## IZMINMIDZ=-0.10 -- Further constrains color box.  
## 
## IZMAXMIDZ=0.40 -- Further constrains color box.
##
## (OK, GTR, 09/22/00 -- But test the MINMIDZDIST parameter)
############################################################################

UGMINMIDZ  	0.6
UGMAXMIDZ  	1.5 
GRMINMIDZ	0.00
GRMAXMIDZ 	0.20
RIMINMIDZ	-0.10
RIMAXMIDZ 	0.40
IZMINMIDZ	-0.10
IZMAXMIDZ 	0.40

############################################################################
## White Dwarf Box Limits
##
## Reject very blue objects that are more likely to be white dwarfs
## than quasars.  There is a region of color space where white dwarfs
## are the dominant stellar objects.  We can reject most of this color
## space in order to increase the efficiency of quasars target
## selection without a significant hit in completeness.  Objects in
## this box should not be selected (unless they are FIRST sources).
##
## Rationale for these limits.  If you change the limits, please
## change these comments.
##
## UGMINWD=-0.8 -- Technically, we don't need this limit, but we
## impose one so that we don't miss anything really interesting that
## is not in a dense WD region.
##
## UGMAXWD=0.7 -- Technically, we don't need this limit, but we
## impose one so that we don't miss anything really interesting that
## is not in a dense WD region.
##
## GRMINWD=-0.8 -- Technically, we don't need a blue limit, but we
## impose one so that we don't miss anything really interesting that
## is not in a dense WD region.
##
## GRMAXWD=-0.1 -- There are very few known quasars bluer than this
## limit.  There are some near z=0.5, but their r'-i' colors are red
## (0.2 to 0.3).  
##
## RIMINWD=-0.6 -- See GRMINWD
##
## RIMAXWD=-0.1 -- There are very few known quasars bluer than this
## limit.  Exceptions are z=0.4 and z=0.8 to z=1.4; however, they are
## redder in either g'-r' or i'-z'.  
##
## IZMINWD=-1.0 -- See GRMINWD
##
## IZMAXWD=-0.1 -- Many quasars are bluer than this, but not very many
## with blue r'-i' colors.  
##
## (OK, GTR, 09/22/00)
############################################################################

UGMINWD		-0.8
UGMAXWD		0.7
GRMINWD		-0.8
GRMAXWD		-0.1 
RIMINWD		-0.6  
RIMAXWD		-0.1
IZMINWD		-1.0
IZMAXWD		-0.1

############################################################################
## White Dwarf + M Star Box Limits
##
## Reject unresolved pairs of white dwarfs and M stars.  There is a
## region of color space where unresolved white dwarfs and M stars
## stick out from the stellar locus.  The density of real quasars is
## not very high here, but we want to investigate all stellar sources
## outside of the stellar locus as much as possible.  This cut rejects
## the region that is most heavily contaminated by these objects.
## Objects in this box should not be selected (unless they are FIRST
## sources).
##
## Rationale for these limits.  If you change the limits, please
## change these comments.
##
## GRMINWM=-0.3 -- WD+M pairs shouldn't have colors much bluer than
## this.
##
## GRMAXWM=1.4 -- We need to impose a red limit to keep from throwing
## away high-redshift candidates.  1.4 is about the middle of the
## stellar locus in the M star region.  We could probably push this
## even bluer.
##
## RIMINWM=0.6 -- There are quasars bluer than this.
##
## RIMAXWM=2.0 -- WD+M objects should not be redder than this, and we
## don't want to miss anything interesting since the WD+M density
## should be low past this.
##
## IZMINWM=0.4 -- Helps keep from rejecting real quasars
##
## IZMAXWM=1.2 -- Helps keep from rejecting real quasars
##
## GERRMAXWM=0.2 -- If the errors are too large, then it is difficult
## to say if this object really is in the box or not.  This
## essentially imposes a magnitude limit in g'. 
##
## (OK, GTR, 09/22/00)
############################################################################

GRMINWM		-0.3
#GRMAXWM		1.4
GRMAXWM		1.25
RIMINWM		0.6
RIMAXWM		2.0
IZMINWM		0.4
IZMAXWM		1.2
GERRMAXWM	0.2

############################################################################
##
## if INTERP_CENTER flag is set, add errInterCenter in the error term
## in the relavant band
##
############################################################################

#ERRINTERPCENTER		0.5
ERRINTERPCENTER		0.1

############################################################################
##
## We will delete objects with i < IBRIGHTSATUR for the moment, due to a
## known problem with PHOTO (version 5.0) when dealing with removal of
## cosmic rays for bright stars.  IBRIGHT is the magnitude limit
## of the spectrographs.  Good targets brighter than this are flagged,
## but not targeted.
##
############################################################################

IBRIGHT		15.0
IBRIGHTINTERP	16.5

############################################################################
##
## maximum speed for non-moving object
##
############################################################################

MAXV		0.2
MAXVSIG		3

############################################################################
##
## cut off galaxies redder than u-g = UGMINGALAXY
##
############################################################################

UGMINGALAXY 	0.9

############################################################################
##
## High redshift quasars candidates can be flagged as QSO_HIZ if they
## are red enough.  This parameter defines how red "red enough" is.
##
## u'-g' = 1.25 is about the median color of a z=3.0 quasar.
## u'-g' = 1.5 is the red edge of the mid-z box.
##
############################################################################

UGMINHIGHZ	1.5

############################################################################
##
## cut out faint UVX quasars selected as HIZ ##
##
############################################################################

UGMAXFAINT	0.9
GRMAXFAINT	0.8

############################################################################
##
## If any band error is larger than CHILDERROR and it is a child, it always
## indicates image problem
##
############################################################################

CHILDERROR	1.0

############################################################################
##
## galaxy region cut : this is the BCG region on the color-color
## diagram, which we require MINGALSIG*4 sigma out of stellar locus
##
## OBSOLETE
############################################################################

GRMINGAL	1.5
GRMAXGAL	2.0
RIMINGAL	0.4
RIMAXGAL	0.7
MINGALSIG	1.0 

############################################################################
##
## Output diagnostics for rejected and accpeted objects?
##
## (OK, GTR, 09/22/00)
############################################################################

DIAGREJECT	1
DIAGACCEPT	1