mirfiller.select - Function

select data from the input Miriad dataset.

Synopsis
select(defpass, splwin, winav, sbandav)

Description
Correllation data stored in a Miriad dataset are stored in spectral windows and so-called wideband channels. In BIMA data, the latter are used to store wideband averages. BIMA data contains an average for each window and one for each entire sideband. This function allows one to select which spectral line windows (via splwin) and which wideband channels (via winav and sbandav) to pass.

As a way of minimizing the amount the user has to type in selecting windows, mirfiller supports a notion of a default window passing mode, which can be adapted to the data found in the Miriad dataset. Controlled via the defpass parameter, it specifies for each type of input window or channel what to pass (usually all or none) if it is not specified via the splwin, winav, or sbandav parameters. See defpass below for currently available modes.

Each call to this function completely overrides previously selections.

Arguments

defpass	a string indicating the default window passing mode to use. This mode affects the which kinds of windows get passed when they are not explicitly specified by the other parameters. See general description above for more details.
	Allowed:	'default' - use the mode that was set (or assumed) at construction (see constructor description for more information); 'rawbima' - use a default appropriate for uncalibrated BIMA data: pass all spectral line windows and both side band averages but no window averages; 'calbima' - use a default appropriate for calibrated data: pass all spectral line windows but no wideband averages; 'all' - pass all windows and wideband channels by default; 'none' - pass no windows or wideband channels by default, require that they be specified explicitly with select().
	Default:	'default'
splwin	a list of one-based spectral window indicies to load.
	Default:	[], the defpass parameter controls how this is interpreted
winav	a list of one-based window average indicies to load. An index of 1 means load the average of the first spectral window.
	Default:	[], the defpass parameter controls how this is interpreted
sbandav	a string indicating which sideband averages to load.
	Allowed:	'default' - allow the defpass parameter to control sideband average selection; 'lsb' - the lower sideband; 'usb' - the upper sideband; 'all' - both sidebands; 'none' - neither sideband.
	Default:	'default'

Example

# open a miriad dataset; watch the logger for a summary and
#   mirfiller's guess as to what windows you'll probably want.
frommir := mirfiller('3c273')

# load the windows that mirfiller thinks you'll want.
frommir.fill('3c273.ms')

# load all data into '3c273all.ms'
frommir.select(defpass='all');
frommir.fill('3c273all.ms')

# load only the sideband averages to an MS called 3c273wide.ms
frommir.select(defpass='none', sbandav='all')   
frommir.fill('3c273wide.ms')

# load only the first four spectral line windows and their
#   corresponding averages
frommir.select(defpass='none', splwin=[1:4], winav=[1:4])
frommir.fill('3c273_1-4.ms');

Next: mirfiller.summary - Function Up: mirfiller - Tool Previous: mirfiller - Constructor Contents Index

	Package	bima
	Module	mirfiller
	Tool	mirfiller