AIPS NRAO AIPS HELP file for HLPSPFLG in 31DEC24



As of Sun Jun 23 9:30:08 2024


HLPSPFLG Run-time help for task SPFLG

C-----------------------------------------------------------------------
OFFZOOM
This option resets any zoom factors and zoom center.  The image is
actually shown in zoom only during flagging operations (where zoom may
help you point more accurately), during the setting of the zoom and of
the black-and-white or color enhancements, and during image loading.
C-----------------------------------------------------------------------
OFFTRANS
This option turns of any black-and-white enhancements done in TVFIDDLE
or TVTRANSF.
C-----------------------------------------------------------------------
OFFCOLOR
This options turns of any color enhancements done in TVFIDDLE or
TVPSEUDO.  Has no effect if the image is in black and white.
C-----------------------------------------------------------------------
TVFIDDLE
This option allows you to set the zoom factor and center to blow up the
data plot for more accurate cursor positioning.  It also allows you to
alter the look-up-tables.  Button A selects image enhancement, altering
between black-and-white and the AIPS-standard color contours.  Button B
increments the zoom or resumes zoom-center mode, while button C
decrements the zoom or resumes zoom-center mode.  Button D ends the
enhancing and returns to the menu.  Instructions appear on the terminal.
C-----------------------------------------------------------------------
TVTRANSF
This option allows you to set the black-and-white transfer function
using the TV cursor to control intercept and slope.  Buttons A and B
turn a plot of the LUT on and off, button C reverses the sign of the
slope, and button D ends the enhancement and returns to the menu.
Instructions appear on the terminal.
C-----------------------------------------------------------------------
TVPSEUDO
This option allows you to set the color transfer function using the TV
cursor.  Button A loops through all possible RGB triangles, button B
selects a circle in hue (which is very useful for phase displays),
button C selects several color contours, and button D ends the
enhancement and returns to the menu.  As in AIPS, the TV cursor is used
to adjust the colors within the selected function.  Instructions appear
on the terminal.
C-----------------------------------------------------------------------
DO WEDGE ?
This option switches between displaying and not displaying an intensity
step wedge on the TV below the data display.  The wedge can help you
adjust and understand the black-and-white or color transfer function.
C-----------------------------------------------------------------------
DO LABEL ?
This option switches between displaying and not displaying axis labels
on the time and channel axes.  If a wedge is displayed, the channel/IF
axis label is replaced with labels on the intensity wedge.
C-----------------------------------------------------------------------
CHAR MULT
This option appears only when the task starts with characters that are
currently, or by default, larger than the minimum (7x9 pixels).  It
allows you to set the scaling factor to an integer between 1 and 5.  If
you enter a value outside this range, the character size is not changed.
The task tries to defend itself from menus that become too large for the
screen.
C-----------------------------------------------------------------------
LOAD LOG
This option is displayed when the amplitude transfer function is LINear
and allows you to request a LOG transfer function instead.  The
available functions are in order LINear, LOG, SQRT, and LOG2 (a more
extreme log) and may be requested cyclically.  The image is immediately
reloaded with the new transfer function.
C-----------------------------------------------------------------------
LOAD SQRT
This option is displayed when the amplitude transfer function is LOG
and allows you to request a SQRT transfer function instead.  The
available functions are in order LINear, LOG, SQRT, and LOG2 (a more
extreme log) and may be requested cyclically.  The image is immediately
reloaded with the new transfer function.
C-----------------------------------------------------------------------
LOAD LOG2
This option is displayed when the amplitude transfer function is SQRT
and allows you to request a LOG2 transfer function instead.  The
available functions are in order LINear, LOG, SQRT, and LOG2 (a more
extreme log) and may be requested cyclically.  The image is immediately
reloaded with the new transfer function.
C-----------------------------------------------------------------------
LOAD LIN
This option is displayed when the amplitude transfer function is LOG2
and allows you to request a LINear transfer function instead.  The
available functions are in order LINear, LOG, SQRT, and LOG2 (a more
extreme log) and may be requested cyclically.  The image is immediately
reloaded with the new transfer function.
C-----------------------------------------------------------------------
LIST FLAGS
This option allows you to list the flagging commands you have already
prepared.  You are prompted for a range of flag numbers to list.  The
selected flags are listed on your terminal. Each is labeled by a "flag"
number which may be used to specify any flags that you may wish to undo.
C-----------------------------------------------------------------------
UNDO FLAGS
This option allows you to undo any one or more of the current flagging
commands.  You will be asked repetitively to enter the number of the
flagging command to be excised (use LIST FLAGS to determine this).
Enter 0 to terminate the list.  The flag commands will be deleted from
the FC table and the master grid and then the data are reloaded on the
display.
C-----------------------------------------------------------------------
REDO FLAGS
This option allows you to make certain that the current flag commands
are correctly applied to the master grid.  Each cell of the master grid
keeps track only of the first flag command which deletes it.  When UNDO
FLAGS is used on flag commands other than the last, cells which were
undone, but should have been deleted by later commands, will not be
correctly marked.  This option lets you bring things back into accord by
reapplying all flags (after the first undone one) to the master grid.
C-----------------------------------------------------------------------
LIST BASLS
This option will prompt you for a range of baseline numbers and then
display the antennas which, for this execution of SPFLG, go with those
numbers.  SPFLG keeps only those antenna pairs selected by the inputs
(when the master grid is built) which are found to have data.  Each of
these is a "plane" in the data "cube" in which channel and time are the
X and Y axes, respectively.  The baseline used in the display and
editing is chosen via the ENTER BASELINE option.
C-----------------------------------------------------------------------
SET REASON
This option allows you to customize the reasons written to the FG table
for the flagging commands that you prepare with SPFLG.  The default
is to insert a string stating the date and time at which SPFLG actually
modifies the FG table.  This option allows the user to build up a list
of up to 9 customized reasons.  All flagging commands prepared after
a particular reason is selected will have that reason attached to them
when they are written to the FG table.  Each reason can have a maximum
of 24 characters in length.  Reason 1 starts as the default reason
string and cannot be changed.
C-----------------------------------------------------------------------
ENTER BLC
This option lets you type on the terminal the bottom left corner pixels
numbers of the portion of the master grid which you wish displayed.  In
general, the master grid has more channels in X or times in Y than will
fit on a single TV picture.  The actual displayed picture is then
shortened by time averaging and by selecting bottom left and top right
corners.  The prompt on the terminal will indicate the legal range of
values.  When SPFLG starts it chooses a display averaging time to fit
all the rows on the TV and does every n'th pixel, if needed, to fit all
columns on the TV.  Later it will display whatever portion of BLC to TRC
fits in the Y direction, but will subsection X if needed.  It is wise to
avoid that sub-sectioning with suitable corners.  The SET WINDOW+LOAD
option allows you to set the image corners with the TV cursor.  The
status display at the bottom of the screen show the corners of the
currently loaded image with an asterisk after any value which will
change on the next LOAD.
C-----------------------------------------------------------------------
ENTER TRC
This option lets you type on the terminal the top right corner pixels
numbers of the portion of the master grid which you wish displayed.  In
general, the master grid has more channels in X or times in Y than will
fit on a single TV picture.  The actual displayed picture is then
shortened by time averaging and by selecting bottom left and top right
corners.  The prompt on the terminal will indicate the legal range of
values.  When SPFLG starts it chooses a display averaging time to fit
all the rows on the TV and does every n'th pixel, if needed, to fit all
columns on the TV.  Later it will display whatever portion of BLC to TRC
fits in the Y direction, but will subsection X if needed.  It is wise to
avoid that sub-sectioning with suitable corners.  The SET WINDOW+LOAD
option allows you to set the image corners with the TV cursor.  The
status display at the bottom of the screen show the corners of the
currently loaded image with an asterisk after any value which will
change on the next LOAD.
C-----------------------------------------------------------------------
ENTER AMP PIXRANGE
This option allows you to enter on your terminal the lower and upper
ranges of the amplitude to be displayed.  The default is to display the
full range of values.  Having entered an amp range, you may return to
the default by entering an amp range of 0 0.  The data range and the
displayed range are shown on the terminal on each LOAD.  All values of
amplitude (and amplitudes of the vector and scalar differences) will be
clipped at the specified pixrange before display.  The option takes
effect on the next LOAD.
C-----------------------------------------------------------------------
ENTER PHS PIXRANGE
This option allows you to enter on your terminal the lower and upper
ranges of the phases to be displayed.  The default is to display the
full range of values.  Having entered a phase range, you may return to
the default by entering a phase range of 0 0.  The data range and the
displayed range are shown on the terminal on each LOAD.  All values of
phase (and phase difference) will be clipped at the specified pixrange
before display.  The option takes effect on the next LOAD.
C-----------------------------------------------------------------------
ENTER RMS PIXRANGE
This option allows you to enter on your terminal the lower and upper
ranges of the RMSes to be displayed.  The default is to display the full
range of values.  Having entered an RMS range, you may return to the
default by entering an RMS range of 0 0.  The data range and the
displayed range are shown on the terminal on each LOAD.  All values of
RMS will be clipped at the specified pixrange before display.  The
option takes effect on the next LOAD.
C-----------------------------------------------------------------------
ENTER R/M PIXRANGE
This option allows you to enter on your terminal the lower and upper
ranges of the RMS/mean to be displayed.  The default is to display the
full range of values.  Having entered an RMS/mean range, you may return
to the default by entering an RMS/mean range of 0 0.  The data range and
the displayed range are shown on the terminal on each LOAD.  All values
of RMS/mean will be clipped at the specified pixrange before display.
The option takes effect on the next LOAD.
C-----------------------------------------------------------------------
ENTER SMOOTH TIME
This option allows you to enter on your terminal the number of the basic
time intervals in the master grid to be averaged in the displayed data.
SPFLG begins with this value set to allow all of the data to appear on
the TV.  You may set any integer value you like, however, and then
choose the part of the data to display using other windowing options.
The smooth time must be set to at least 2 of the basic time for the RMS
and RMS/mean displays to work.  NOTE: if you flag a displayed point that
has been smoothed, then all the samples in that average are flagged.
The status display at the bottom of the TV shows the average time of the
current display with an asterisk appended if it will change on the next
LOAD.  The number of pieces into which the time range is divided is
recomputed when this parameter is changed and the next LOAD will load
the first piece in this new arrangement.
C-----------------------------------------------------------------------
ENTER SCAN TIME
This option allows you to enter on your terminal the number of the basic
time intervals in the master grid to be averaged in the "rolling buffer"
for the difference displays.  These are displays of the difference
between the data at time T and the average of the data at times near T.
The scan time sets the meaning of "near" in a rolling-buffer fashion.
Thus for a scan time of 30 seconds and data at 10-second intervals, the
average for a set of 7 points is as follows:
            time        average of times
             00           00   10   20
             10           00   10   20
             20           10   20   30
             30           20   30   40
             40           30   40   50
             50           40   50   60
             60           40   50   60
SPFLG begins with this value set to 3 times the smooth time, but you may
set any integer value you like greater than the smooth time.  The status
display at the bottom of the TV shows the scan time of the current
display with an asterisk appended if it will change on the next LOAD.
C-----------------------------------------------------------------------
ENTER BASELINE
If you have more than one baseline in your master grid, this option lets
you select which one will be displayed and used in editing.  If flags
are to be applied to a single baseline, they are applied to the baseline
selected with this option.  Note that this option prompts you for two
antenna numbers or a baseline number and a zero.  If the 2nd number is
not 0, the baseline number is then found by comparison with the list of
baseline numbers.  The association of that baseline number and
antenna-pair numbers is displayed by the LIST BASLS option.  As with
most SPFLG options, the data are NOT loaded immediately, allowing you to
make other selections before using the LOAD options.  The status display
at the bottom of the TV shows the baseline of the current display with
an asterisk appended if it will change on the next LOAD.
C-----------------------------------------------------------------------
ENTER STOKES FLAG
This option lets you specify which polarizations are to be flagged by
the following flag commands.  You will be prompted for a Stokes string
or flag mask, i.e., 1111 will flag all four Stokes parameters, 1001 will
flag RR and LR.  The status line on the bottom of the TV reflects the
current value of this option.  NOTE: this string/mask applies to the
displayed Stokes type which may or may not be the same as the input data
set.  There are three types recognized: RR/LL/RL/LR, I/Q/U/V, and (sort
of) VV/HH/VH/HV where the mask refers to these polarizations in this
order.  Thus, 0100 would flag LL even if the master grid consisted
solely of RL data.
C-----------------------------------------------------------------------
ENTER CH SMOOTH
This option lets you specify the width (FWHM) of a Gaussian spectral
smoothing function which is applied to the data to be displayed as
those data are computed (i.e. in the display type such as amplitude of
the vector difference).  The value applied to the current TV image is
shown in the status line(s).  If the value will change with the next
LOAD command, the current value is followed by an asterisk.  Flagging
functions such as CLIP, FLAG ABOVE, etc. are applied using the
smoothed data values.
C-----------------------------------------------------------------------
SWITCH SOURCE FLAG
This option lets you toggle between having the following flag commands
apply to all sources and having them apply only to to the source of the
displayed data.  The status line on the bottom of the TV reflects the
current value of this option.  This affects flagging of time ranges
primarily, and determines whether all sources in the range or only those
actually displayed by SPFLG are to be flagged.
C-----------------------------------------------------------------------
SWITCH BASLIN FLAG
This option lets you toggle between having the following flag commands
apply to the current baseline (antenna n with antenna m), all
baselines to antenna n, all baselines to antenna m, and all baselines.
The status line on the bottom of the TV reflects the current value of
this option (e.g. 01-02, 01-**, **-02, **-**, where ** => all)
C-----------------------------------------------------------------------
SWITCH ALL-IF FLAG
This option lets you rotate between having the following flag commands
apply to all IFs, having them apply to a range of IFs, and having them
apply only to the current IF.  When you rotate from ONE-IF to a range,
SPFLG prompts you on the terminal to enter the desired range of IFs.
The range option appears only when there are more than 2 IFs displayed.
The status line on the bottom of the TV screen reflects the current
value of this option.
C-----------------------------------------------------------------------
DISPLAY AMPLITUDE
This option specifies that fringe amplitudes are to be smoothed from the
master grid, displayed on the TV, and used in the editing.  The screen
is not updated immediately, allowing you to select other options before
using the LOAD options.  The status line at the bottom of the TV shows
the type of data currently displayed with an asterisk appended if it
will change on the next LOAD.
C-----------------------------------------------------------------------
DISPLAY PHASE
This option specifies that fringe phases are to be smoothed from the
master grid, displayed on the TV, and used in the editing.  The screen
is not updated immediately, allowing you to select other options before
using the LOAD options.  The The status line at the bottom of the TV
shows the type of data currently displayed with an asterisk appended if
it will change on the next LOAD.
C-----------------------------------------------------------------------
DISPLAY RMS
This option specifies that RMSes of the fringe amplitudes over the
smoothing interval are to be computed from the master grid, displayed on
the TV, and used in the editing.  Note that this uses scalar
amplitudes which do not have a Gaussian distribution, but which are not
sensitive to phase variations which might be fixed by self-cal.  The
screen is not updated immediately, allowing you to select other
options before using the LOAD options.  The status line at the bottom
of the TV shows the type of data currently displayed with an asterisk
appended if it will change on the next LOAD.
C-----------------------------------------------------------------------
DISPLAY RMS/MEAN
This option specifies that ratios of the RMS of the fringe amplitudes
over the smoothing interval to their mean are to be computed from the
master grid, displayed on the TV, and used in the editing.  This uses
scalar amplitudes which are not sensitive to phase variations (which
might be correctable with self-cal), but which have a non-Gaussian,
biased distribution.  The screen is not updated immediately, allowing
you to select other options before using the LOAD options.  The status
line at the bottom of the TV shows the type of data currently
displayed with an asterisk appended if it will change on the next LOAD.
C-----------------------------------------------------------------------
DISPLAY VECT RMS
This option specifies that vector RMS of the fringe amplitudes over the
smoothing interval are to be computed from the master grid, displayed on
the TV, and used in the editing.  The vector RMS is found by summing
the RMS of the real and imaginary parts of the visibility in quadrature.
It is quite sensitive to phase variations, but has Gaussian statistics.
The screen is not updated immediately, allowing you to select other
options before using the LOAD options.  The status line at the bottom
of the TV shows the type of data currently displayed with an asterisk
appended if it will change on the next LOAD.
C-----------------------------------------------------------------------
DISPLAY VRMS/VAVG
This option specifies that ratios of the vector RMS of the fringe
amplitudes over the smoothing interval to their vector average are to
be computed from the master grid, displayed on the TV, and used in the
editing.  The screen is not updated immediately, allowing you to
select other options before using the LOAD options.  The status line
at the bottom of the TV shows the type of data currently displayed
with an asterisk appended if it will change on the next LOAD.
C-----------------------------------------------------------------------
DISPLAY AMP V DIFF
This option specifies that the amplitude of the vector difference
between the (possibly-smoothed) fringe visibility at time T and the
vector average of the visibilities in the "scan" interval surrounding T
is to be computed as a function of T from the master grid, displayed on
the TV, and used in the editing.  This option is a very powerful
detector of jumps in either phase or amplitude.  The screen is not
updated immediately, allowing you to select other options before using
the LOAD options.  The status line at the bottom of the TV shows the
type of data currently displayed with an asterisk appended if it will
change on the next LOAD.
C-----------------------------------------------------------------------
DISPLAY AMPL DIFF
This option specifies that the absolute value of the difference between
the (possibly-smoothed) fringe amplitude at time T and the scalar
average of the amplitudes in the "scan" interval surrounding T is to be
computed as a function of T from the master grid, displayed on the TV,
and used in the editing.  The screen is not updated immediately,
allowing you to select other options before using the LOAD options.  The
status line at the bottom of the TV shows the type of data currently
displayed with an asterisk appended if it will change on the next LOAD.
C-----------------------------------------------------------------------
DISPLAY PHASE DIFF
This option specifies that the absolute value of the difference between
the (possibly-smoothed) fringe phase at time T and phase of the vector
average of the visibilities in the "scan" interval surrounding T is to
be computed as a function of T from the master grid, displayed on the
TV, and used in the editing.  The screen is not updated immediately,
allowing you to select other options before using the LOAD options.  The
status line at the bottom of the TV shows the type of data currently
displayed with an asterisk appended if it will change on the next LOAD.
C-----------------------------------------------------------------------
DISPLAY STOKES xx
If you have more than one Stokes or polarization in your master grid
(i.e. I/V, Q/U, I/Q/U, I/Q/U/V, RR/LL, RL/LR, VV/HH, VH/HV, RR/LL/RL/LR,
or VV/HH/VH/HV), this option lets you select Stokes "xx" to be displayed
and used in editing.  The data are NOT immediately reloaded, allowing
you to make other selections before using the LOAD options.  The value
of "xx" is the polarization immediately following the one which will be
loaded.  The status line at the bottom of the TV shows the Stokes of
the data currently displayed with an asterisk appended if it will
change on the next LOAD.  The menu shows the xx which would change the
current choice for the next LOAD.  Thus, if RR is displayed and you
have selected LL but not yet LOADed it, the menu will show RR again and
the status line will show RR*.
C-----------------------------------------------------------------------
OFF WINDOW + LOAD
This option will reset the image corners to display the full image - or
at least to try - and then reload the TV screen.  This is one of the 7
LOAD options which force an update of the TV display to reflect the
numerous possible choices of parameters (Stokes, scaling, baseline
order, smooth and scan times, display type) which may have been changed
since the last LOAD.
C-----------------------------------------------------------------------
SET WINDOW + LOAD
This option lets you reset the image corners with the TV cursor and then
reloads the TV screen.  Move the cursor to the desired bottom left
corner; the lines will follow the cursor.  Hit any button to set the BLC
and switch to setting the TRC.  The lines will now show your selected
window.  Hit buttons A or B to reset the other corner or buttons C or D
to complete the window selection and load the data to the TV.  This is
one of the 7 LOAD options which force an update of the TV display to
reflect the numerous possible choices of parameters (Stokes, scaling,
baseline order, smooth and scan times, display type) which may have been
changed since the last LOAD.
C-----------------------------------------------------------------------
LOAD LAST BASELINE
This option will decrement the baseline number by one (modulo the
maximum baseline) and then reload the TV screen.  This is one of the 7
LOAD options which force an update of the TV display to reflect the
numerous possible choices of parameters (Stokes, scaling, smooth and
scan times, display type) which may have been changed since the last
LOAD.
C-----------------------------------------------------------------------
LOAD NEXT BASELINE
This option will increment the baseline number by one (modulo the
maximum baseline) and then reload the TV screen.  This is one of the 7
LOAD options which force an update of the TV display to reflect the
numerous possible choices of parameters (Stokes, scaling, smooth and
scan times, display type) which may have been changed since the last
LOAD.
C-----------------------------------------------------------------------
LOAD LAST PIECE
When there are too many times, after application of any time averaging,
to fit on the TV screen, SPFLG will divide the time range up into
overlapping "pieces".  This option will reload the TV screen for the
previous piece in sequence.  This is one of the LOAD options which force
an update of the TV display to reflect the numerous possible choices
of parameters (Stokes, IF, scaling, BASELINE, smooth and scan times,
display type) which may have been changed since the last LOAD.
C-----------------------------------------------------------------------
LOAD NEXT PIECE
When there are too many times, after application of any time averaging,
to fit on the TV screen, SPFLG will divide the time range up into
overlapping "pieces".  This option will reload the TV screen for the
next piece in sequence.  This is one of the LOAD options which force
an update of the TV display to reflect the numerous possible choices
of parameters (Stokes, IF, scaling, BASELINE, smooth and scan times,
isplay type) which may have been changed since the last LOAD.
C-----------------------------------------------------------------------
LOAD
This option will reload the TV screen.  This is one of the 7 LOAD
options which force an update of the TV display to reflect the numerous
possible choices of parameters (Stokes, scaling, baseline, smooth and
scan times, display type) which may have been changed since the last
LOAD.
C-----------------------------------------------------------------------
FLAG PIXEL
This option allows you to flag (delete) data points one at a time.  Move
the cursor to the desired datum; the source name, time, channel/IF, and
flux under the cursor are displayed on the upper left of the TV screen.
Press button A or B to flag a point and loop for more, press button C to
flag a point and return to the menu, and press button D to return to the
menu with no further flagging.
C-----------------------------------------------------------------------
FLAG/CONFIRM
This option allows you to flag (delete) data points one at a time.  Move
the cursor to the desired datum; the source name, time, channel/IF, and
flux under the cursor are displayed on the upper left of the TV screen.
Press button A or B to flag a point and loop for more, press button C to
flag a point and return to the menu, and press button D to return to the
menu with no further flagging.  You are prompted on the terminal to
confirm each flagged point; answer Y or N.  This option is the same as
FLAG PIXEL except for the very conservative need to confirm each point.
C-----------------------------------------------------------------------
FLAG AREA
This option allows you to flag (delete) data in a range of time and a
range of channel number.  Move the cursor to the lower-left corner of
the area you wish to flag.  The box will follow the cursor while the
source, time, channel/IF, and flux of the point under the cursor will
be displayed in the top left corner of the TV.  Once at the desired
point, hit button A to mark it.  Then move the cursor to the
upper-right corner of the desired area.  Hit button A to reset the other
corner, hit button B to flag the data inside the box and loop to set
another box, or hit button C to flag the data and return to the menu,
or hit button D to return to the menu with no further flagging.
C-----------------------------------------------------------------------
FLAG TIME RANGE
This option allows you to flag (delete) a range of times for all
channels.  Move the cursor to the start time of the range you wish to
flag.  The horizontal line will follow while the the source, time,
channel/IF, and flux of the point under the cursor will be displayed in
the top left corner of the TV.  Hit button A to set the start time and
a second horizontal line will appear 10 pixels above.  Move the cursor
to the end point of the desired time range; the second line will follow.
Hit button A to switch between the begin and end times; hit button B to
flag the data in the specified range and loop to set another time range;
hit button C to flag the data and return to the menu; or hit button D to
return to the menu with no further flagging.  The horizontal lines
displayed will cross the full screen if all IFs are to be flagged or
cross only that IF to which the cursor is pointed.
C-----------------------------------------------------------------------
FLAG CHANNEL-DT
This option allows you to flag (delete) a range of times for a single
channel.  Move the cursor to the channel and start time of the range you
wish to flag.  The bottom-right-corner line will follow while the
source, time, channel/IF, and flux of the point under the cursor will be
displayed in the top left corner of the TV.    Hit button A to set the
start time and channel.  The vertical line will be replaced with a
top-left-corner.  Move the cursor to the end point of the desired time
range; the second horizontal line will follow.  Hit button A to switch
between setting the channel and begin time and setting the end time;
hit button B to flag the data in the specified range and loop to set
another channel and time range; hit button C to flag the data and
return to the menu; or hit button D to return to the menu with no
further flagging.  The horizontal lines displayed will cross the full
screen if all IFs are to be flagged or cross only that IF to which the
cursor is pointed.
C-----------------------------------------------------------------------
FLAG A TIME
This option allows you to flag (delete) the data for all channels at a
specific time.  Move the cursor to the time you wish to flag.  The
horizontal line will follow it while the source, time, channel/IF, and
flux of the point under the cursor will be displayed in the top left
corner of the TV.  Once on the desired time, hit button A or B to flag
that time and loop for more, hit button C to flag the time and return
to the menu, and hit button D to return to the menu with no further
flagging.  The horizontal line displayed will cross the full screen if
all IFs are to be flagged or cross only that IF to which the cursor is
pointed.
C-----------------------------------------------------------------------
FLAG A CHANNEL
This option allows you to flag (delete) the data for all times at a
specific channel.  Move the cursor to the channel you wish to flag.  The
vertical line will follow it while the source, time, channel/IF, and
flux of the point under the cursor will be displayed in the top left
corner of the TV.  Once on the desired channel, hit button A or B to
flag that channel and loop for more, hit button C to flag the time and
return to menu, and hit button D to return to the menu with no further
flagging.
C-----------------------------------------------------------------------
FLAG CHANNEL RANGE
This option allows you to flag (delete) data in a range of channel
number.  Move the cursor to the lower channel of the range you wish to
flag.  The box will follow the cursor while the source, time,
channel/IF, and flux of the point under the cursor will be displayed in
the top left corner of the TV.  Once at the desired point, hit button A
to mark it.  Then move the cursor to the highest channel of the desired
range.  Hit button A to reset the other channel, hit button B to flag
the data inside the channel range and loop to set another range, or hit
button C to flag the data and return to the menu, or hit button D to
return to the menu with no further flagging.
C-----------------------------------------------------------------------
CLIP BY SET #S
This option allows you to flag (delete) all data outside a range of
values (in the displayed parameter) which you specify on the terminal.
N.B.: this option uses the values in the displayed type, e.g. the
RMS/mean, to set the flags.
C-----------------------------------------------------------------------
CLIP INTERACTIV
This option allows you to flag (delete) all data outside a range of
values (in the displayed parameter) which you specify interactively.
N.B.: this option uses the values in the displayed type, e.g. the
RMS/mean, to set the flags.  Move the TV cursor horizontally to set the
upper clip limit.  The current clip limits will be displayed in the
upper left corner of the TV and the clipped data will seem to disappear.
Hit button A or B to switch between upper and lower clip limits (except
for RMS's), hit button C to flag the data and return to the menu, or hit
button D to return to the menu with no flagging.
C-----------------------------------------------------------------------
CLIP BY FORM
This option allows you to flag (delete) data over a range of baselines
and Stokes using the "method" and clipping range of some previous clip
operation.  In the other CLIP options, one can use the data of one
baseline, IF, and Stokes to flag other baselines, IFs, and/or Stokes
using the ALL-BL, ALL-IF, and STOKES FLAG options.  This option allows
you to use the data of each baseline, and Stokes in turn over a
specified range of baselines and Stokes, to delete bad data.  You are
prompted to enter on the terminal the number of a previous clip
operation (use LIST FLAGS) to use as a pattern. i.e., to specify the
display parameter type, the averaging and scan intervals, the clip
levels, the window on the data, and even the ALL-BL, ALL-IF, and Stokes
flags.  You will be prompted to enter on the terminal the desired range
of baselines and/or Stokes unless the pattern operation applied its
flags to all baselines, IFs, and/or Stokes.  The full range is used in
those cases.  This operation will probably work best if you are viewing
RR data when you select an RR only clip command and tell it to do
Stokes pattern 1011 for RR and 0000 for LL.  Then view an LL image,
select an LL only clip command, and use patterns 0000 for RR and 0111
for LL.
C-----------------------------------------------------------------------
EXIT
This option is used to exit the program.  If you have done any flagging,
you will be asked if you want to apply the flags to the input data set.
If you answer N and the master grid is cataloged (DOCAT > 0), then the
program exits and and you may resume SPFLG at a later time using the
master grid (IN2SEQ) with no loss of information.  If you answer N and
the master grid is not cataloged, then you will be reminded of this and
if you still answer N, then the master grid is deleted and your flagging
is discarded.  If you answer Y - which you should do only when you are
done with the current selection of data - then SPFLG writes your
flagging commands into an FG table for a multi-source file, or applies
them directly to the data for a single-source file.  The master grid is
then changed to make all current flagging permanent, or deleted if it is
not cataloged.
C-----------------------------------------------------------------------

AIPS