AIPS HELP file for CANDY in 31DEC24
As of Mon Oct 14 8:37:49 2024
CANDY: User definable task to operate on an image
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.