AIPS NRAO AIPS HELP file for HLPPCFLG in 31DEC24



As of Sun Jun 23 8:33:27 2024


HLPPCFLG Run-time help for task PCFLG

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 off any black-and-white enhancements done in TVFIDDLE
or TVTRANSF.
C-----------------------------------------------------------------------
OFFCOLOR
This options turns off 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-----------------------------------------------------------------------
REDO DELAY
This option causes the task to fit delays and central phases to all IFs,
times, and antennas in the master grid.  The correct PC data
("residuals") are written to each sample and may be viewed by selecting
VIEW RESID.  Note that the display is not updated for new values until
the LOAD operation is selected.
C-----------------------------------------------------------------------
VIEW RESID
This option appears when you are viewing the input data values.  It
causes the next LOAD operation to use the residual data rather than the
input data to determine the displayed image.  The form of data currently
being viewed appears at the bottom of the screen as INP or RES with an
asterisk following to indicate that this will change on the next LOAD.
C-----------------------------------------------------------------------
VIEW INPUT
This option appears when you are viewing the residual data values.  It
causes the next LOAD operation to use the input data rather than the
residual data to determine the displayed image.  The form of data
currently being viewed appears at the bottom of the screen as INP or
RES with an asterisk following to indicate that this will change on
the next LOAD.
C-----------------------------------------------------------------------
ENTER BLC
This option lets you type on the terminal the bottom left corner pixel
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 PCFLG 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 pixel
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 PCFLG 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.
PCFLG 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
PCFLG 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 ANTENNA
If you have more than one antenna 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 antenna, they are applied to the antenna
selected with this option.  Note that this option prompts you for a
single antenna number.  As with most PCFLG 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 antenna 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.  NOTE that this option is frequently not suitable
for PC table values if the phase changes significantly from channel to
channel.
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 PCFLG are to be flagged.
C-----------------------------------------------------------------------
SWITCH ALLANT FLAG
This option lets you toggle between having the following flag commands
apply to the current antenna or all antennas.  The status line on the
bottom of the TV reflects the current value of this option (e.g. 03 or
*** meaning all).
C-----------------------------------------------------------------------
SWITCH ALL-IF FLAG
This option lets you rotate between having the following flag commands
apply to all IFs or having them apply only to the current IF.  The
status line on the bottom of the TV screen reflects the current value
of this option.
C-----------------------------------------------------------------------
DISPLAY AMPLITUDE
This option specifies that PC table 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 PC table 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 PC table 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 in calibration.  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 PC table 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 in calibration), 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 PC table 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 PC values 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 PC-table
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) PC-table values at time T and the
vector average of those values 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) PC-table 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) PC-table phase at time T and phase of the vector
average of the values 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, RR/LL, or VV/HH), 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, antenna,
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,
antenna, smooth and scan times, display type) which may have been
changed since the last LOAD.
C-----------------------------------------------------------------------
LOAD LAST ANTENNA
This option will decrement the antenna number by one (modulo the maximum
antenna) 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 ANTENNA
This option will increment the antenna number by one (modulo the maximum
antenna) 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, PCFLG 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, antenna, 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, PCFLG 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, antenna, smooth and scan times,
display 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, antenna, 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 in an IF.  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-----------------------------------------------------------------------
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 antennas
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
antenna and Stokes to flag other baselines and/or Stokes using the
ALL-ANT, 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 antennas 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-ANT, ALL-IF, and Stokes flags.
You will be prompted to enter on the terminal the desired range of
antennas and/or Stokes unless the pattern operation applied its flags
to all antennas 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 PC table.
If you answer N and the master grid is cataloged (DOCAT > 0), then the
program exits and and you may resume PCFLG 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 PCFLG writes your input
PC table sorted into a new table version with flagged values converted
to magic blanks.. The master grid is then changed to make all current
flagging permanent, or deleted if it is not cataloged.
C-----------------------------------------------------------------------

AIPS