NAME:
	r_br_apm
 PURPOSE:
       Creates a ps or gif file containing plots of red vs blue-red:
	ps.ps or .gif: All matched objects
	ps_m_52.ps or .gif: All matched objects with non zero 0.5-2 keV flux
	ps_m_41.ps or .gif: All matched objects with non zero 4.5-10 keV flux
	Outputs to screen or ps file or gif
 CALLING SEQUENCE:
	r_br_apm,xmmdb,apmdb,apmcat[,ps=ps,gif=gif,ionly=ionly,offmax=offmax,
		field=field]
 INPUTS:
	xmmdb:The xmm database to be searched. Must start with 'dbase/... '
	apmdb: The apm  "    	"	"	"	"	"
 	apmat: catalogue file on which apmdb is based 
		eg: 'dss/phl_apmcat.fct'
 OPTIONAL INPUT KEYWORDS:
	ionly: if set only objects with non-sero imag are searched in wfc db
		note this can only be called with an 'otherdb' containing
		and item labelled 'i'.
	offmax: STRING!!!!maximum offax angle of xmm objects to be matched. 
		If not set, all xmm objects are matched 
 OPTIONAL OUTPUT PARAMETERS:
	ps: file name of output ps file
	gif:file name of output gif file. Only active if ps is not set
		If neither set the output is sent to an IDL graphics window
	field:name of field (if directory in named after field)
 EXAMPLE:
	r_br_wfc,'xmm','apm',xmmno[,offmax='5.0',ps='col_wfc_5to10.ps']
 CALLED PROCEDURES:
	match_obj, astrolib procedures,select_classes,avoid_offplot,select_cond
	ogif,cgif,ops,cps
 MODIFICATION HISTORY:
	31-Oct-2000  Original by Suzanne Aigrain
	07-Nov-2000  S. Aigrain: determines range itself
	-1-DEC-2000  S. Aigrain: adapted to apm e/eo or r/rb from wfc i/gi
	04-Dec-2000  S. Aigrain: added arrows

(See /home/xmmssc/soft/idl/pro/colplots/r_br_apm.pro)


Suzanne Aigrain <visitor2@ast.cam.ac.uk>
Last modified: Thu Feb 15 12:56:17 2001