NAME

bandpar -- Calculate photometric parameters of a passband

USAGE

bandpar obsmode

DESCRIPTION

This task computes the photometric parameters of a passband. The passband can either be read from a file, calculated as the combined throughputs of the individual HST components, or calculated from certain functional forms, such as a Gaussian or a rectangular window. The passband is specified by an expression in the obsmode task parameter. See the help file for calcband for a description of the syntax of this expression.

This task computes eleven different photometric parameters. These are:

	 NAME		PARAMETER
	=======		=========
	URESP		Flux (in flam) of a star that produces a response
			of one photon per second in this passband
	PIVWV		Passband pivot wavelength
	BANDW		Passband rms width
	FWHM		Full width half max of equivalent gaussian
	WPEAK		Wavelength at peak throughput
	TPEAK		Peak bandpass throughput
	AVGLAM		Passband average wavelength
	QTLAM		Dimensionless efficiency
	EQUVW		Passband equivalent width
	RECTW		Passband rectangular width
	EMFLX		Equivalent monochromatic flux

In addition to computing these photometric parameters, this task computes two parameters used in the computation of the equivalent monochromatic flux:

	 NAME		PARAMETER
	=======		=========
	REFWAVE		The reference wavelength
	TLAMBDA		The throughput at the reference wavelength

Unless specified by the user, the reference wavelength is set to the average wavelength of the passband (AVGWV). The photometric parameters are defined by the equations:

	URESP = H * C / (AREA * INT(THRU * LAM))

	PIVWV = SQRT(INT(THRU * LAM) / INT (THRU / LAM))

	BANDW = BARLAM * SQRT(INT(THRU * LN(LAM / BARLAM) ** 2 / LAM) /
			      INT(THRU / LAM)

	FWHM = SQRT(8 * LOG(2)) * BANDW
 
	BARLAM = INT(THRU * LN(LAM) / LAM) / INT(THRU / LAM)

	TPEAK = MAX(THRU)

	AVGWV = INT(THRU * LAM) / INT(THRU)

	QTLAM = INT(THRU / LAM)

	EQUVW = INT(THRU)

	RECTW = INT(THRU) / MAX(THRU)

	EMFLX = URESP * RECTW * (TPEAK / TLAMBDA)

In these formulas, INT() denotes the integral with repect to lambda, SQRT() denotes square root, LN() the natural logarithm, LOG() the common logairthm, and MAX() the maximum function. The variable LAM is wavelength, THRU is the total throughput, which is a function of wavelength, AREA is the telescope area, and H and C are the usual physical constants.

The photometric parameters are printed on STDOUT and optionally saved in a table. Which parameters are printed and saved is controlled by the hidden parameter photlist. By default, all parameters will be printed.

PARAMETERS

obsmode [string]

The command the specifies the synthetic passband. The command syntax is described in the help file for calcband. The photometric parameters of more than one passband can be computed by putting the commands in a file, one per line, and setting obsmode to the name of the file preceded by an "@" character, e.g. "@filename". The keywords which form an obsmode are explained further in the obsmode task.

(output = "none") [string]

The name of the output table containing the photometric parameters. If this parameter is set to "none" or left blank, no output table will be created. But output will still be sent to STDOUT regardless of the value of this parameter.

(photlist = "all") [string]

A comma separated list of the photometric parameters to print. The value "all" prints all the photometric parameters. Placing a "~" in front of the list causes all the parameters except the named parameters to be printed. The two auxiliary parameters REFWAVE and TLAMBDA are printed by default if EMFLX is printed and not printed by default if EMFLX is not printed.

(refwave = INDEF) [real]

The reference wavelength used in the computation of EMFLX. If this parameter is set to INDEF, the average wavelength (AVGWAV) will be calculated and used in its place. The units of the wavelength must be angstroms.

(wavetab = "") [file name]

Name of an optional wavelength table or file. An appropriate table can be generated by using the genwave task. If a table is used, the wavelength column name must be "WAVELENGTH". If an ASCII file is used the first column is taken to be the wavelength column. The subdirectory 'synphot$data has ASCII wavelength tables useful for specific HST passbands.

If no wavelength table is specified, the task generates a wavelength set which covers the range where the passband is non-zero. Wavelengths are spaced logarithmically over this range. If there is more than one passband, the range is computed based on all the passbands.

(refdata = "") [pset name]

Parameter set for reference data used in calculations. This pset contains the following parameters:

area = 45238.93416:  HST telescope area in cm**2.

grtbl = "mtab$*.tmg":  HST graph table.  By default, this
        uses the more recent version. 

cmptbl = "mtab$*.tmc":  Instrument component table.  By 
        default, this uses the more recent version.

EXAMPLES

1. Calculate the photometric parameters for the wfpc and f555w filter.

sy> bandpar wfpc,f555w

2. Calculate the pivot wavelength and rms bandwidth for each of the Johnson passbands.

sy> bandpar @ubvri.lis output=johnson.tab phot=pivwv,bandw

The file ubvri.lis contains the lines:

band(u)
band(b)
band(v)
band(r)
band(i)

3. Calculate the photometric parameters for the wfpc and the f555w filter, setting the reference wavelength to 5500 angstroms. Don't print the reference wavelength.

sy> bandpar wfpc,f555w refwave=5500 phot=~refwave

REFERENCES

Written by B.Simon

SEE ALSO

calcband