bimams.reavg - Function

Recompute sideband averages and channel averages based on channel data flags

Synopsis
reavg(out, dosort, reset, verbosity)

Description
This function recomputes the sideband averages and channel averages based on the channel data flags. It is currently implemented in glish and is rather slow. The plan is to implement it in C++ so it will run faster. In general, it should be run after channel data have been flagged. It is meant to be the AIPS++ analog of MIRIAD's uvwide task.

Yet to do: edge and blankf parameters, as in uvwide which allow the user to discard edge channels when recomputing averages, still must be added. Note that in uvwide, the default value of blankf is 0.033 which is why uvwide run with this default will compute different averages than the current implementation of reavg.

Arguments

out	the output dataset, if not specified the input dataset is modified and no new dataset is written
	Allowed:	String
	Default:	''
dosort	sort the data when doing subqueries, if F, will speed up execution, but should only be set to F if you are sure the dataset is already sorted in time-data description id-baseline order (the order in which mirfiller writes data when filling)
	Allowed:	Boolean
	Default:	T
reset	should all average data be recomputed? By default (reset=T), all averages recomputed regardless of the value of the existing flags, otherwise (reset=F), only averages with F flags are recomputed (i.e. averages flagged bad are left untouched). Note that setting reset=F will not increase the speed of the function.
	Allowed:	Boolean
	Default:	T
verbosity	Controls the level of informational messages, 0 = run quietly, higher numbers = more messages
	Allowed:	Integer
	Default:	1

Returns
T or fail

Example

# flag some data
- af := autoflag('neptune.ms');
- af.setselect(clip=[expr='ABS YY',min=0.001,max=50]);
# construct a bimams tool and assign it to a Glish variable named bms
- bms := bimams('neptune.ms');
# recompute sideband averages and print lots of messages during execution
- bms.reavg('neptune.ms.reavg',verbosity=3);
T

Next: bimams.reffreqs - Function Up: bimams - Tool Previous: bimams.polarids - Function Contents Index

	Package	bima
	Module	bimams
	Tool	bimams