./guide
getps.pro

Last modification date:

Thu Jun 2 23:56:08 2005

Routine Summary  2 routines

procedure getps, scan, [ifnum=integer], [intnum=integer], [plnum=integer], [fdnum=integer], [tau=float], [tsys=float], [ap_eff=float], [smthoff=integer], [units=string], [noweight=flag]
This procedure retrieves and calibrates a total power position switched scan pair.

procedure dopsint, s1_off, s1_on, s2_off, s2_on, tau, tsys, ap_eff, smthoff, units[, ret_tsys][, ret_tau]	private
This procedure calibrates a single integration from a position switched scan pair.

Routine Details

getps

procedure getps, scan, [ifnum=integer], [intnum=integer], [plnum=integer], [fdnum=integer], [tau=float], [tsys=float], [ap_eff=float], [smthoff=integer], [units=string], [noweight=flag]

This procedure retrieves and calibrates a total power position switched scan pair. These data are usually taken with the "OnOff" or "OffOn" procedures. This procedure will reject data not taken with one of those two procedures. This code should be used as a template for the user who may wish to develop more sophisticated calibration schemes. The routine produces a spectrum calibrated in Ta (K). Other recognized units are 'Ta*' and 'Jy'.

The only required parameter is the scan number. This can be either scan in the sequence of two total power scans, and the paired scan is determined from the header. Arguments to identify the IF number, polarization number and feed number are optional. The program calculates Tsys based on the Tcal values, and cal_on/cal_off phases. The user can override this calculation by entering a zenith system temperature. The procedure will then correct the Tsys for the observed elevation. If the data are calibrated to Ta* or Jy, then additional parameters are used. A zenith tau value may be specified, and an aperture efficiency may be specified. The user is *strongly* encouraged to enter values for these calibration parameters, but they will be estimated if none is provided.

A parameter called smthoff can be used to smooth the reference spectrum prior to calibration. In certain cases this can improve the signal to noise ratio, but it may degrade baseline shapes and artificially emphasize spectrometer glitches. Use with care. A value of smthoff=16 is often a good choice.

All averaging is done using dcaccum and accumave. This means that integrations are weighted using the default weight given in dcaccum. To turn off this weighting so that all integrations have equal weight in the average, use the /noweight flag.

Version

$Id: getps.pro,v 1.20 2005/05/30 04:03:43 bgarwood Exp $

Parameters
scan in, required integer	M&C scan number

Keywords
ifnum in, optional integer	IF number (starting with 0)
intnum in, optional integer	Integration number (default=all}
plnum in, optional integer	polarization number (default 0)
fdnum in, optional integer	feed number (default 0)
tau in, optional float	tau at zenith
tsys in, optional float	tsys at zenith
ap_eff in, optional float	aperture efficiency
smthoff in, optional integer	smooth factor for reference spectrum
units in, optional string	takes the value 'Jy', 'Ta', or 'Ta*'
noweight in, optional flag	if set, the default weighting is turned off and all integrations are averaged with the same weight (1.0).

dopsint

private

procedure dopsint, s1_off, s1_on, s2_off, s2_on, tau, tsys, ap_eff, smthoff, units[, ret_tsys][, ret_tau]

This procedure calibrates a single integration from a position switched scan pair. This is currently an internal function used only by getps.

Version

$Id: getps.pro,v 1.20 2005/05/30 04:03:43 bgarwood Exp $