AIPS NRAO AIPS HELP file for TAFFY in 31DEC18



As of Wed Sep 19 16:33:15 2018


TAFFY: User definable task to operate on an image

INPUTS

INNAME                             Input image name (name)
INCLASS                            Input image name (class)
INSEQ             0.0     9999.0   Input image name (seq. #)
INDISK            0.0        9.0   Input image disk unit #
OUTNAME                            Output image name (name)
OUTCLASS                           Output image name (class)
OUTSEQ           -1.0     9999.0   Output image name (seq. #)
OUTDISK           0.0        9.0   Output image disk unit #.
BLC                                Bottom left corner of input
TRC                                Top right corner of input
OPCODE                             Operation code.
CPARM                              User supplied array
DPARM                              User supplied array

HELP SECTION

TAFFY
Task:  User definable task which sends an image one row at a
       time to a subroutine.  Will handle real or integer input,
       blanking and data cubes.  The program already takes care
       of input and output, most of the bookkeeping and most of
       the history.  TAFFY can also provide scrolling buffer
       ability.  For more details see the comments in the
       source version of the task which should be in the
       APLPGM: area.  Also see HELP NEWTASK or EXPLAIN TAFFY.
Adverbs:
  INNAME.....Input image name (name).       Standard defaults.
  INCLASS....Input image name (class).      Standard defaults.
  INSEQ......Input image name (seq. #).     0 => highest.
  INDISK.....Disk drive # of input image.   0 => any.
  OUTNAME....Output image name (name).      Standard defaults.
  OUTCLASS...Output image name (class).     Standard defaults.
  OUTSEQ.....Output image name (seq. #).    0 => highest unique.
  OUTDISK....Disk drive # of output image.  0 => highest disk
             number with sufficient space.
  BLC........Bottom right corner in input image of desired
             subimage.  Default is entire image.
  TRC........Top right corner in input image of desired
             subimage.  Default is entire image.
  OPCODE.....User specified operation code.
  CPARM......User specified array
  DPARM......User specified array
             Not used in the provided code but may be need by
             the users application.

EXPLAIN SECTION

TAFFY:  Task which reads and modifies an image file as specified
        by a user supplied routine.
DOCUMENTOR: W. D. Cotton, NRAO.
RELATED PROGRAMS:  All AIPS image tasks.

                          PURPOSE

     TAFFY is designed as a skeleton task to allow a user
access to a image data file and to generate a new image from
the old image.  The user modifies one or two routines and can
ignore the details of cataloguing files and the I/O.  TAFFY can
handle up to 7 dimensional images in either integer or real
format and supports blanking.  A subimage of the input image
may be selected.

    The user may or may not have to modify the subroutine which
creates the output catalogue header from the input catalogue
header but must supply the routine which operated on the
images.  This latter routine is sent the image one row at a
time in floating point format with blanking fully supported.
The user supplied routine may opt to defer returning a row to
allow the use of a scrolling buffer.  Also supported are
operations which compress a row into a single value.

     The necessary control information can be passed to the
program via OPCODE,  CPARM, and DPARM.  Other adverbs may be
added if necessary. For further information about modifying
TAFFY see the comments in the source code.  For information
about compiling, link-editing and running TAFFY see HELP
NEWTASK or the AIPS programmers manual.

AIPS