AIPS HELP file for HLPTVSPX in 31DEC26
As of Mon Jun 15 12:09:48 2026
HLPTVSPX Run-time help for task TVSPX
HELP SECTION
EXPLAIN SECTION
C-----------------------------------------------------------------------
EXIT
This option causes the interactive portion of TVSPX to finish. The
task then resumes AIPS, releases the TV device, and writes the output
cataloged images.
C-----------------------------------------------------------------------
ABORT
This option causes the interactive portion of TVSPX to finish. The
task then resumes AIPS, releases the TV device, and deletes the output
cataloged images.
C-----------------------------------------------------------------------
SET BRIGHT RANGE
This option allows you to specify the minimum and maximum brightness
value in acceptable solutions. You will be prompted in the terminal
window to enter two values in the units of the input image. If the
first number entered is less than the second, values less than the first
OR greater than the second are considered suspect. If the first number
entered is greater than the second, values less than the first AND
greater than the second are considered suspect. Thus, you can examine
values outside or inside the specified range. The current range
settings are displayed at the top of the TV above the menu. These
values are used by the REDO ALL and FLAG ALL menu options to see if a
solution should be redone or flagged, respectively. They are then reset
to 0. Set the first and second numbers to the same value to prevent the
brightness range from affecting the REDO ALL and FLAG ALL functions.
C-----------------------------------------------------------------------
SET SPIX RANGE
This option allows you to specify the minimum and maximum spectral index
value in acceptable solutions. You will be prompted in the terminal
window to enter two values in spectral index units. If the first number
entered is less than the second, values less than the first or greater
than the second are considered suspect. If the first number entered is
greater than the second, values less than the first and greater than the
second are considered suspect. Thus, you can examine values outside or
inside the specified range. The current range settings are displayed at
the top of the TV above the menu. These values are used by the REDO ALL
and FLAG ALL menu options to see if a solution should be redone or
flagged, respectively. They are then reset to 0. Set the first and
second numbers to the same value to prevent the spectral index range
from affecting the REDO ALL and FLAG ALL functions.
C-----------------------------------------------------------------------
SET CURV RANGE
This option allows you to specify the minimum and maximum spectral
curvature value in acceptable solutions. You will be prompted in the
terminal window to enter two values in spectral curvature units. If the
first number entered is less than the second, values less than the first
or greater than the second are considered suspect. If the first number
entered is greater than the second, values less than the first and
greater than the second are considered suspect. Thus, you can examine
values outside or inside the specified range. The current range
settings are displayed at the top of the TV above the menu. These
values are used by the REDO ALL and FLAG ALL menu options to see if a
solution should be redone or flagged, respectively. They are then reset
to 0. Set the first and second numbers to the same value to prevent the
spectral curvature range from affecting the REDO ALL and FLAG ALL
functions.
C-----------------------------------------------------------------------
SET MAX ERR BR
This option allows you to specify the maximum uncertainty in brightness
for acceptable solutions. You will be prompted in the terminal window
to enter one value in the units of the input image. The REDO ALL and
FLAG ALL operations use this value to test whether a solution should be
redone or flagged, resp. A value of 0 or less will cause the test for
brightness error to be ignored. The current value of this parameter is
displayed above the menu.
C-----------------------------------------------------------------------
SET MAX ERR SPIX
This option allows you to specify the maximum uncertainty in spectral
index for acceptable solutions. You will be prompted in the terminal
window to enter one value in the units of spectral index. The REDO ALL
and FLAG ALL operations use this value to test whether a solution should
be redone or flagged, resp. A value of 0 or less will cause the test
for spectral index error to be ignored. The current value of this
parameter is displayed above the menu.
C-----------------------------------------------------------------------
SET MAX ERR CURV
This option allows you to specify the maximum uncertainty in spectral
curvature for acceptable solutions. You will be prompted in the
terminal window to enter one value in the units of spectral curvature.
The REDO ALL and FLAG ALL operations use this value to test whether a
solution should be redone or flagged, resp. A value of 0 or less will
cause the test for spectral index error to be ignored. The current
value of this parameter is displayed above the menu.
C-----------------------------------------------------------------------
REDO ALL
This option allows you to try to improve selected solutions. The
operation examines all pixels for which there is a solution in the
selected window. If the brightness is outside the range of brightness,
the spectral index is outside the range of spectral index, the
uncertainty in the brightness is greater than the maximum, or the
uncertainty in the spectral index is greater than the maximum, the
solution for that row of the input image is done over with an
interactive function. If OPTYPE='CURV', the allowed range in spectral
curvature and the maximum error in curvature are also tested. The
allowed ranges and maximum errors are reset after this operation unless
the QUIT option caused it to terminate prematurely.
C-----------------------------------------------------------------------
FLAG ALL
This option allows you to flag selected solutions. The operation
examines all pixels for which there is a solution in the selected
window. If the brightness is outside the range of brightness, the
spectral index is outside the range of spectral index, the uncertainty
in the brightness is greater than the maximum, or the uncertainty in
the spectral index is greater than the maximum, the solution for that
row of the input image is marked as failed. If OPTYPE='CURV', the
allowed range in spectral curvature and the maximum error in curvature
are also tested. The allowed ranges and maximum errors are reset after
this operation.
C-----------------------------------------------------------------------
OFF ZOOM
This option in the main menu allows you to turn off the zoom function
selected with TVZOOM in the image display menu.
C-----------------------------------------------------------------------
OFF TRANSFER
This option in the main menu turns of any black-and-white enhancements
done by TVTRANSF and any coloring done by TVPSEUDO, TVPHLAME, or
OFMCOLOR in the image display menu.
C-----------------------------------------------------------------------
RESET WINDOW
This option returns the image display to the full image. This option is
available in the edit screen and the image display screen.
C-----------------------------------------------------------------------
LABEL WEDGE?
Turns on or off the labeling of the step wedge plotted at the bottom
of each image.
C-----------------------------------------------------------------------
CHAR MULT
This option prompts you to enter a number between 1 and 5 to set the
TV character size multiplier. It is only offered when the initial
character multiplier is greater than 1 or when the TV size indicates
that it would be bigger than 1 by default. The menus and other labels
will adapt to any change.
C-----------------------------------------------------------------------
ADD TO LIST
This option prompts you in the terminal window to enter 2 integers which
specify the X, Y pixel coordinates in the output image of a pixel for
which you would like to revisit the fit. You can prepare a list of
pixels for revisiting using this option or CURVALUE in the image display
menu. You can list these pixels (SHOW LIST) and you can the repeat the
fitting of them with REDO LIST or simply flag them out with FLAG LIST.
If you want to remove a pixel from the list, enter its pixel coordinates
with negative signs. Note that the list may only include pixels for
which there is currently a solution.
C-----------------------------------------------------------------------
CLEAR LIST
This option deletes all entries in the list of image pixels which will
be revisited with the REDO LIST and FLAG LIST options. ADD TO LIST may
be used to add a pixel to or remove a pixel from this list while this
option removes all pixels from the list.
C-----------------------------------------------------------------------
SHOW LIST
This option displays in the message window the current list of output
image pixels which will be revisited with the REDO LIST and FLAG LIST
options. ADD TO LIST may be used to add a pixel to or remove a pixel
from this list.
C-----------------------------------------------------------------------
REDO LIST
The output image pixels in the current list are revisited to see if it
is possible to improve upon the current solution. Options to FLAG
POINTS, UNDO FLAGS, and NEW FIT are offered with the results marked as
either GOOD or BAD. These cause the solutions at that pixel to be
updated or flagged, respectively. The list is processed in order and
and all entries in the list which are processed are removed from the
list. The QUIT option in the interactive function can cause premature
termination of this option, leaving some entries in the list.
C-----------------------------------------------------------------------
FLAG LIST
The output pixels in the current list are revisited in the solutions
table and those solutions are marked as failed. The list is reset
after this operation.
C-----------------------------------------------------------------------
SHOW IMAGE NP
This option allows you to enter an image display mode while displaying
an image of the number of channels used in the fit. The value range in
the image is displayed on the message terminal and at the top of the TV.
The image display mode offers a menu including OFF TRANSF, OFF COLOR,
TVTRANSF, TVPSEUDO, TVPHLAME, OFMCOL0R, TVZOOM, CURVALUE, and RETURN.
All are the familiar operations except that CURVALUE allows you to add
to a pixel list for later re-examination of the solutions. You can also
choose to re-load the image to the TV with a selection of transfer
functions.
C-----------------------------------------------------------------------
SHOW IMAGE BR
This option allows you to enter an image display mode while displaying
an image of the brightness in Jy/beam. The value range in the image
is displayed on the message terminal and at the top of the TV in input
image units. The image display mode offers a menu including OFF TRANSF,
OFF COLOR, TVTRANSF, TVPSEUDO, TVPHLAME, OFMCOLOR, TVZOOM, CURVALUE, and
RETURN. All are the familiar operations except that CURVALUE allows
you to add to a pixel list for later re-examination of the solutions.
You can also choose to re-load the image to the TV with a selection of
transfer functions and you can set and reset the display window.
C-----------------------------------------------------------------------
SHOW IMAGE EBR
These options allow you to enter an image display mode while displaying
an image of the uncertainty in brightness in Jy/beam. The value range
in the image is displayed on the message terminal and at the top of the
TV. The image display mode offers a menu including OFF TRANSF,
OFF COLOR, TVTRANSF, TVPSEUDO, TVPHLAME, OFMCOLOR, TVZOOM, CURVALUE, and
RETURN. All are the familiar operations except that CURVALUE allows you
to add to a pixel list for later re-examination of the solutions. You
can also choose to re-load the image to the TV with a selection of
transfer functions and you can set and reset the display window.
C-----------------------------------------------------------------------
SHOW IMAGE SP
These options allow you to enter an image display mode while displaying
an image of the spectral index. The value range in the image is
displayed on the message terminal and at the top of the TV. The image
display mode offers a menu including OFF TRANSF, OFF COLOR, TVTRANSF,
TVPSEUDO, TVPHLAME, OFMCOLOR, TVZOOM, CURVALUE, and RETURN. All are the
familiar operations except that CURVALUE allows you to add to a pixel
list for later re-examination of the solutions. You can also choose to
re-load the image to the TV with a selection of transfer functions.
C-----------------------------------------------------------------------
SHOW IMAGE SP
These options allow you to enter an image display mode while displaying
an image of the uncertainty in the field value of the selected component
in pixels . The value range in the image is displayed on the message
terminal and at the top of the TV. The image display mode offers a menu
including OFF TRANSF, OFF COLOR, TVTRANSF, TVPSEUDO, TVPHLAME, OFMCOLOR,
TVZOOM, CURVALUE, and RETURN. All are the familiar operations except
that CURVALUE allows you to add to a pixel list for later re-examination
of the solutions. You can also choose to re-load the image to the TV
with a selection of transfer functions and you can set and reset the
display window.
C-----------------------------------------------------------------------
SHOW IMAGE ESP
These options allow you to enter an image display mode while displaying
an image of the uncertainty in the spectral index. The value range in
the image is displayed on the message terminal and at the top of the TV.
The image display mode offers a menu including OFF TRANSF, OFF COLOR,
TVTRANSF, TVPSEUDO, TVPHLAME, OFMCOLOR, TVZOOM, CURVALUE, and RETURN.
All are the familiar operations except that CURVALUE allows you to add
to a pixel list for later re-examination of the solutions. You can also
choose to re-load the image to the TV with a selection of transfer
functions and you can set and reset the display window.
C-----------------------------------------------------------------------
SHOW IMAGE CU
These options allow you to enter an image display mode while displaying
an image of the spectral curvature . The value range in the image is
displayed on the message terminal and at the top of the TV. The image
display mode offers a menu including OFF TRANSF, OFF COLOR, TVTRANSF,
TVPSEUDO, TVPHLAME, OFMCOLOR, TVZOOM, CURVALUE, and RETURN. All are the
familiar operations except that CURVALUE allows you to add to a pixel
list for later re-examination of the solutions. You can also choose to
re-load the image to the TV with a selection of transfer functions and
you can set and reset the display window.
C-----------------------------------------------------------------------
SHOW IMAGE ECU
These options allow you to enter an image display mode while displaying
an image of the uncertainty in spectral curvature . The value range in
the image is displayed on the message terminal and at the top of the TV.
The image display mode offers a menu including OFF TRANSF, OFF COLOR,
TVTRANSF, TVPSEUDO, TVPHLAME, OFMCOLOR, TVZOOM, CURVALUE, and RETURN.
All are the familiar operations except that CURVALUE allows you to add
to a pixel list for later re-examination of the solutions. You can also
choose to re-load the image to the TV with a selection of transfer
functions and you can set and reset the display window.
C-----------------------------------------------------------------------
RETURN
This option returns from the image display menu to the primary menu to
select a different image to display, to set data selection values, and
to revisit selected solutions in order to modify or flag them.
C-----------------------------------------------------------------------
LOAD AS LN
This option re-loads the current image using a linear transfer function
from the image minimum to its maximum. The image you are now viewing
was loaded with the L2 (extreme log) transfer function.
C-----------------------------------------------------------------------
LOAD AS SQ
This option re-loads the current image using a square root transfer
function from the image minimum to its maximum. The image you are now
viewing was loaded with the LN (linear) transfer function.
C-----------------------------------------------------------------------
LOAD AS LG
This option re-loads the current image using a logarithmic transfer
function from the image minimum to its maximum. The image you are now
viewing was loaded with the SQ (square root) transfer function.
C-----------------------------------------------------------------------
LOAD AS L2
This option re-loads the current image using a more extreme logarithmic
transfer function from the image minimum to its maximum. The image you
are now viewing was loaded with the LG (logarithmic) transfer function.
C-----------------------------------------------------------------------
SET WINDOW
This option turns on a standard TVWINDOW operation to set the lower left
corner and upper right corner of a sub-image that you would like to view
in more detail. Buttons A and B switch between corners and buttons C
and D set the desired window which is immediately displayed. The
selected sub-window will be shown zoomed by pixel replication when
possible. This option sets the window over which the FLAG ALL and REDO
ALL operations will function.
C-----------------------------------------------------------------------
OFF TRANSF
This option turns of any black-and-white enhancements done in TVTRANSF.
C-----------------------------------------------------------------------
OFF COLOR
This options turns of any color enhancements done in TVPSEUDO, TVPHLAME,
OR ofmcolor. Has no effect if the image is in black and white.
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 message screen.
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 message screen.
C-----------------------------------------------------------------------
TVPHLAME
This option allows you to set the color transfer function using the TV
cursor and a flame-like color scheme. Buttons A and B cycle through the
sequence of all possible color combinations, while buttons C and D end
the enhancement and return to the menu. The TV cursor X position
adjusts the image intensity at which the color turns more white, while
the Y position adjusts the way colors add (the gamma). Instructions
appear on the message screen.
C-----------------------------------------------------------------------
OFMCOLOR
This option allows you to set the color transfer function using the TV
cursor and a large number of the standard OFMs ("output function memory"
tables). Hitting buttons A, B, or C causes the selected OFM to change
working through 3 separate lists of 10. After an OFM has been selected
it may be adjusted with the horizontal position of the cursor. Hit
button D to exit, keeping whatever color scheme you have developed.
C-----------------------------------------------------------------------
TVZOOM
This option lets you set the TV zoom magnification factor and to set the
point about which the zoom takes place. The cursor points at the zoom
center which will be shifted to the center of the screen. A hit on
buttons A or B increments the magnification factor and on button C
decrements the magnification factor in a circular fashion. Hit button D
to exit. Instructions appear on the message screen.
C-----------------------------------------------------------------------
CURVALUE
To perform an interactive display of the pixel locations and values of
the image visible on the TV. The X and Y pixel coordinates, the pixel
value, and the units of the pixel value are displayed in TV graphics
channel 2 at the upper left of the display. The cursor position
determines which pixel is shown. Unlike other CURVALUEs in AIPS,
buttons A and B allow you to add the selected pixel to a list of pixels
to be flagged or re-fit at a later time. Buttons C and D end the
display and return to the menu. Instructions appear on the message
screen. The pixel values are read from the image in memory and hence
preserve accuracy.
C-----------------------------------------------------------------------
IMSTAT
This option evaluates the statistics of the current image sub-window.
It determines the mean and rms using all pixels in the sub-window and
the mean and rms excluding any pixels well away from the mean. This is
called the robust mean and rms and is an attempt to determine the true
noise in the image. If the current sub-window is the full image, the
statistics label above the image display will be updated. In either
case, the statistics will be displayed i the message window.
C-----------------------------------------------------------------------
NEXT WINDOW
Very large images may not be able to fit on your TV. When the image
exceeds the size of the TV, the top line will show the parameter
followed by a sub-image number in parentheses and the NEXT WINDOW option
will appear. The first sub-image displayed is called number 0 and shows
the full image every n'th pixel in X and Y. Sub-image 1 begins at the
lower left, moves right, then back to the left and up, and so forth
until the top right is reached. Every pixel is displayed in these
sub-images. Use the NEXT WINDOW option to step through the sub-images
in a circular fashion.
C-----------------------------------------------------------------------
NEW FIT
Selecting this option tells TVSPX to use the current spectrum to try to
fit the model parameters. The new model is plotted after the fit. If
the fit fails, including for reasons specified in adverbs DPARM and
CPARM, all flagged channels are unflagged and the original solution is
reinstated and plotted.
C-----------------------------------------------------------------------
BAD
Selecting this option tells TVSPX to mark the current pixel as "bad"
in the model images and then go on to the next pixel.
C-----------------------------------------------------------------------
GOOD
Selecting this option tells TVSPX that the fit appears to be good. The
task stores the parameters in the model images and goes on to the next
pixel.
C-----------------------------------------------------------------------
CHAN RANGE
This option allows you to select a range of channels in the spectrum to
make it easier to flag points in an otherwise crowded display. The
current limits in the channels are indicated by vertical lines on the
display. Move the cursor to change the limit and hit buttons A or B to
switch between the lower and upper limit. Hit buttons C or D to exit
the function and have the selected range of channels be displayed. Note
that all channels in the spectrum are used in the fit even when only a
subset is displayed.
C-----------------------------------------------------------------------
RESET CHANS
This option undoes any CHAN RANGE that has been set and all channels in
the spectrum will be displayed.
C-----------------------------------------------------------------------
FLAG POINTS
This option turns on an interactive mode in which the current cursor
position selects values in the spectral plot which are displayed at the
top of the TV. To remove an image (spectral) point from the fit, move
the cursor to the point and hit buttons A or B. The data point will
change color. Hit buttons C or D to exit. The NEW FIT option will then
let you see if a more reasonable solution may be found.
C-----------------------------------------------------------------------
UNDO FLAGS
This option restores the original image data and solution to the editing
screen. You may then start the re-do operation over again.
C-----------------------------------------------------------------------
QUIT
This option tells the REDO LIST or REDO ALL functions to terminate
before the list or set of questionable pixels are complete.
Particularly REDO ALL can cause you to be in a seemingly infinite
sequence of pixels. This option lets you escape.
C-----------------------------------------------------------------------