PreFlagger

Flag given baselines, time slots, etc.

inputs

type

type:

string

default:

preflagger

doc:

Case-insensitive step type; must be ‘preflagger’ (or ‘preflag’) .

abstime

type:

string[]

doc:

Ranges of absolute UTC date/time given as st..end or val+-delta. Each value (except delta) must be given as a date/time in casacore MVTime format, for instance 12-Mar-2010/11:31:00.000. A delta value must be given as a time (for instance 1:30:0 or 20s) .

default:

[]

amplmax

type:

float

default:

1e+30

doc:

Correlation data with amplitude > amplmax will match .

amplmin

type:

float

default:

-1e+30

doc:

Correlation data with amplitude < amplmin will match. It can be given per correlation. For example, amplmin=[100,,,100] matches data points with XX or YY amplitude < 100. The non-specified amplitudes get the default value.

azimuth

type:

float[]

default:

[]

doc:

Ranges of azimuth angles given as st..end or val+-delta. Each value has to be given as a casacore direction like 12:34:56.789 or 12h34m56.789, 12.34.56.789 or 12d34m56.789, or a value followed by a unit like rad or deg .

baseline

doc:

See Description of baseline selection parameters.

type:

string[]

default:

[]

blmax

type:

float

default:

-1

doc:

If blmax > 0, baselines with length > blmax meter will match .

blmin

type:

float

default:

-1

doc:

If blmin > 0, baselines with length < blmin meter will match .

chan

type:

string

default:

""

doc:

The given channels will match (start counting at 0). Channels exceeding the number of channels are ignored. Similar to msin, it is possible to specify the channels as an expression of nchan. Furthermore, .. can be used to specify ranges. For example: chan=[0..nchan/32-1, 31*nchan/32..nchan-1] to flag the first and last 2 or 8 channels (depending on 64 or 256 channels in the observation).

corrtype

type:

string

default:

""

doc:

Correlation type to match? Must be auto, cross, or an empty string .

count.path

type:

string?

doc:

The directory where to create the flag percentages table. If empty, the path of the input MS is used .

count.save

type:

boolean

default:

False

doc:

If true, the flag percentages per frequency are saved to a table with extension .flagfreq and percentages per station to a table with extension .flagstat. The basename of the table is the MS name (without extension) followed by the stepname and extension.

elevation

type:

string?

doc:

Ranges of elevation angles (similar to azimuth). For example: 0deg..10deg

expr

type:

string?

default:

""

doc:

Expression of preflagger keyword sets (see above). Operators AND, OR, and NOT are possible (or their equivalents &&,&, ||, |, and !). Parentheses can be used to change precedence order. For example: c1 and (c2 or c3)

freqrange

type:

string

default:

""

doc:

Channels in the given frequency ranges will match. Each value in the vector is a range which can be given as start..end or start+-delta. A value can be followed by a unit like KHz. If only one value in a range has a unit, the unit is also applied to the other value. If a range has no unit, it defaults to MHz. For example: freqrange=[1.2 .. 1.4 MHz, 1.8MHz+-50KHz] flags channels between 1.2MHz and 1.4MHz and between 1.75MHz and 1.85MHz. The example shows that blanks can be used at will.

imagmax

type:

float

default:

1e+30

doc:

Correlation data with imaginary complex part > imagmax will match .

imagmin

type:

float

default:

-1e+30

doc:

Correlation data with imaginary complex part < imagmin will match .

lst

type:

string[]

default:

[]

doc:

Ranges of Local Apparent Sidereal Times like 1:30:0 +- 20min. The LST of a time slot is calculated for the array position, thus not per antenna.

mode

type:

string

default:

set

doc:

Case-insensitive string telling what to do with the flags of the data matching (or not matching) the selection criteria given in the other parameters. Must be ‘set’, ‘setcomplement’/’setother’, ‘clear’ or ‘clearcomplement’/’clearother’ .

phasemax

type:

float

default:

1e+30

doc:

Correlation data with phase > phasemax (in radians) will match .

phasemin

type:

float

default:

-1e+30

doc:

Correlation data with phase < phasemin (in radians) will match .

realmax

type:

float

default:

1e+30

doc:

Correlation data with real complex part > realmax will match .

realmin

type:

float

default:

-1e+30

doc:

Correlation data with real complex part < realmin will match .

reltime

type:

string[]

default:

[]

doc:

Ranges of times (using .. or +-) since the start of the observation. A time can be given like 1:30:0 or 20s .

step_name

type:

string

default:

preflag

doc:

unique name for the step .

timeofday

type:

string?

default:

[]

doc:

Ranges of UTC time-of-day given as st..end or val+-delta. Each value must be given as 12:34:56.789, 12h34m56.789, or as a value followed by a unit like h, min, or s .

timeslot

type:

string[]

default:

[]

doc:

Time slot sequence numbers. First time slot is 0. st..end means end inclusive .

uvmmax

type:

float

default:

-1

doc:

If uvmmax > 0, baselines with UV-distance > uvmmax meter will match .

uvmmin

type:

float

default:

-1

doc:

If uvmmin > 0, baselines with UV-distance < uvmmin meter will match. Note that the UV-distance is the projected baseline length .