AIPS HELP file for CANDY in 31DEC24

As of Thu Oct 10 17:29:18 2024

INPUTS

DATAIN                             Input file name (Non-AIPS)
OBJECT                             Source name
IMSIZE                             Output image size (cells)
CELLSIZE                           Cellsize sec.
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 #.
OPCODE                             Operation code.
CPARM                              User supplied array
DPARM                              User supplied array

HELP SECTION

CANDY
Task:  User definable task which accepts an image one row at a
       time from a subroutine.  It will handle blanking and
       data cubes.  The program already takes care of output
       and most of the bookkeeping and the history.  For more
       details see the comments in the source version of the
       task which should be in the NOT STANDARD area.  Also see
       HELP NEWTASK.
Adverbs:
  DATAIN.....A file external to the AIPS system from which the
             image can be read.  Use of DATAIN depends on the
             host operating system.
  OBJECT.....Object name.
  IMSIZE.....Desired image size in cells.
  CELLSIZE...Desired cell spacing, currently assumes sec.
  OUTNAME....Output image name (name).     Standard behavior
             with default = 'CANDY MAP'.
  OUTCLASS...Output image name (class).    Standard defaults.
  OUTSEQ.....Output image name (seq. #).   0 => highest unique.
  OUTDISK....Disk drive # of output image. 0 => highest number
             with sufficient space.
  OPCODE.....User specified operation code.
  CPARM......User specified array
  DPARM......User specified array

EXPLAIN SECTION

CANDY:  Task which creates and fills an AIPS catalogue image
        file from a user supplied routine.
DOCUMENTOR: W. D. Cotton, NRAO.
RELATED PORGRAMS: AIPS, All AIPS image tasks.

                          PURPOSE

     CANDY is designed as a skeleton task to allow a user to
put an image or image-like data into the AIPS system.  The
image can be either generated directly by the user supplied
routine or read from an external source from the user supplied
routine. The exact details depend on the application and the
host operating system.

     The necessary control information can be passed to the
program via OPCODE,  CPARM, and DPARM  and data can read from
disk or tape from file specified in DATAIN by user supplied
FORTRAN instructions. Additional information describing the
image may be passed to CANDY thru the AIPS adverbs OBJECT,
IMSIZE and CELLSIZE or read directly from the disk.

     The source code contains an example using DATAIN and a
FORTRAN 77 OPEN statment to open the desired input file.  Many
of these statments are commented out since they do not conform
to AIPS standards for general code.

     For further information about modifying CANDY see the
comments in the source code.  For information about compiling,
link-editing and running CANDY see HELP NEWTASK or the AIPS
programmers manual.