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.2 #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.1 #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.1 #limiting magnitude in i', corrected for reddening

############################################################################
## 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.
##
## These are a factor of 4 smaller than they should be b/c we multiply
## them by 4 in the code.
##
## OK (GTR, 06/14/01)
############################################################################

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

############################################################################
##
## This parameter is used in the call to determineCapSkirt.
##
## OBSOLETE (GTR, 06/14/01)
############################################################################

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)

############################################################################
## Deal with faint red objects that have large errors.
##
## Increase error in red stars with asymmetric errors.
##
## Also, cut out objects that are redder than g-r=GRBIGNSIGERRORCUT
##
## These apply to ugri color selection only!
##
## Actually, BIGNSIGERRORS is now OBSOLETE.
##
############################################################################

BIGNSIGERRORS	10.0
GRBIGNSIGERRORCUT	1.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
MAXMINDETECTMAG	23.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.
##
## 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.1
##
## 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)
############################################################################

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		0.9
#RIMINWM		0.5
#RIMAXWM		1.2
#IZMINWM		0.4
#IZMAXWM		0.9

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 < IBRIGHTINTERP 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 ##
##
## This has changed considerably.  First cut on GRMAXFAINT < 1.0.
## Then if the u-g color is less than 0.8 AND the object is faint,
## reject it.  Also, if the u-g color is between 0.8 and 2.5 reject it
## -- even if it is bright.
##
## I couldn't find any other way to deal with the objects that were
## being selected by the griz algorithm that were really normal stars.
## Most of the (real) quasars that this would miss are found by the
## ugri algorithm anyway.  Especially the high-z extention of the ugri
## algorithm.
##
## (OK, GTR, 06/14/01)
############################################################################

UGMAXFAINT1	0.8	
UGMAXFAINT2	2.5
GRMAXFAINT	1.0 

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

CHILDERROR	1.0

############################################################################
##
## Object selected from data with the bad u3 chip need to have their
## errors increased.  This is the parameter that does it.  However, it
## is largely overridden by the "badamp" flag.  See the code.
##
############################################################################

BADAMPERROR	10.0

############################################################################
##
## Parameters for high-z color cuts
##
## UGRHIZUGMIN=1.5 -- Roughly the color of a z=3 quasar 
##
## UGRHIZUMIN=20.60 -- High-z quasars are generally fainter than this.
## Excludes nearly all z<2.2 quasars.  Not complete for 2.2 < z < 3.0.
##
## UGRHIZGRMAX=1.2 -- Redder than this there are too many red stars.
##
## UGRHIZRIMAX=0.8 -- Helps reject red stars so that we can go redder
## than g-r<0.5 above.
##
## UGRHIZSLOPE=0.44 -- Defined by the slope of the stellar locus
##
## UGRHIZOFFSET=0.46 -- Distance from zeropoint of locus
##
## UGRHIZIZMIN=-1.00 -- Gets rid of some bogus targets
##
##
## GRIHIZUGMIN=1.5 and GRIHIZUMIN=20.60 -- Real high-z quasar are
## either red in u-g or faint in u'.  These are not significantly
## different from the u-g>2.0 and u>21.0 cuts used in the Fan papers.
##
## GRIHIZGRMIN1=0.7 -- Avoids A-stars.  Using g-r>1.0 causes z=3.5 and
## z=3.6 quasars to be missed.  Going as blue as g-r>0.5 causes z=1
## quasars to fall into the selection region.
##
## GRIHIZGRMIN2=2.1 -- Avoids M-stars.  Using g-r>2.3 contributes to
## the dip in the selection function at z=4.5.  g-r>2.1 is a good
## comprimise.  g-r>2.0 would be better (nearly 100% efficiency).
##
## GRIHIZSLOPE=0.44 -- Set by slope of stellar locus.
##
## GRIHIZOFFSET=0.33 -- Stay this far away from locus.
##
## GRIHIZIZMAX=0.60 -- Get rid of M-star contamination.  i-z<0.25
## causes the dip in the selection function at z=4.5.
##
## GRIHIZIZMIN=-1.00 -- Gets rid of some bogus targets
##
##
## RIZHIZUMIN=21.50 and RIZHIZGMIN=21.00 -- Real high-z quasars should
## be fainter than this.
##
## RIZHIZRIMIN=0.60 -- Avoid contamination from blue stars
##
## RIZHIZSLOPE=0.52 -- Set by slope of locus.
##
## RIZHIZOFFSET=0.37 -- Avoid stellar locus by this much.
##
## RIZHIZIZMIN=-1.00 -- Gets rid of some bogus targets
##
## (Needs to be finalized, GTR, 03/15/01)
## (Final?, GTR, 06/14/01)
############################################################################

UGRHIZUGMIN	1.5
UGRHIZUMIN	20.60
UGRHIZGRMAX	1.2
#UGRHIZRIMAX	0.8
UGRHIZRIMAX	0.3
UGRHIZSLOPE	0.44
#UGRHIZOFFSET	0.46
UGRHIZOFFSET	0.56
UGRHIZIZMIN	-1.00

GRIHIZUGMIN	1.5
GRIHIZUMIN	20.60
GRIHIZGRMIN1	0.7
GRIHIZGRMIN2	2.1
GRIHIZSLOPE	0.44
#GRIHIZOFFSET	0.33
GRIHIZOFFSET	0.358
GRIHIZIZMAX	0.60
GRIHIZIZMIN	-1.00

RIZHIZUMIN	21.50
RIZHIZGMIN	21.00
RIZHIZRIMIN	0.60
RIZHIZSLOPE	0.52
#RIZHIZOFFSET	0.37
RIZHIZOFFSET	0.412
RIZHIZIZMIN	-1.00


############################################################################
##
## Color cut for UVX selection
##
############################################################################

UVXUGMAX	0.6

############################################################################
##
## Output diagnostics for rejected and accpeted objects?
##
## For normal operations these should be set to 0.
##
## (OK, GTR, 09/22/00)
############################################################################

DIAGREJECT	0
DIAGACCEPT	0