AIPS NRAO AIPS HELP file for FITDISK in 31DEC24



As of Thu Mar 28 6:45:53 2024


FITDISK: procedure to write maps or uv data to disk.

INPUTS

                                   type RUN WRTPROCS first!
INNAME                             UV file name (name)
INCLASS                            UV file name (class)
INSEQ              0.0      9999.0 UV file name (seq. #)
INDISK          0.0         9.0    UV file disk drive #
DATAOUT
                                   Logical directory name
FORMAT          0.0         3.0    tape format:   0 => 3.
                                       1 for 16-bit integer
                                       2 for 32-bit integer
                                       3 for 32-bit IEEE
                                         floating point
BLOCKING        0.0        10.0    tape blocking factor (<= 10)

HELP SECTION

FITDISK
Type: Procedure
Use:  FITDISK write a FITS file to disk with the same name as the
      of the file in AIPS.  FITDISK uses FITTP (see HELP
      FITTP for details).  The AIPS name is used with internal
      blanks changed to '_' and trailing blanks removed.
      Remember to load this procedure by typing RUN WRTPROCS
      before trying to run it (by typing FITDISK).
Adverbs:
  INNAME.....The input image name (name). No default.
  INCLASS....The input image name (class). No default.
  INSEQ......The input image name (seq. #). No default.
  INDISK.....The input disk unit #. 0=> search all disks in
             order for file meeting the other criteria.
  DATAOUT....The name of a directory in which to put files.
             The name is limited to 48-characters and must be
             in the form
                  
              or
                  ::
              where  is the remote computer name,
               is the environment variable (logical
              name) for the disk area in which the file.
               is usually omitted when the file is local
              to the current computer.
              The file name will be the AIPS file name with
              the internal ' ' changed to '_' and trailing
              blanks omitted.
  FORMAT.....Code to tell what format to be used in writing the
             main uv or image data portion of the file as
                   1 for 16-bit integers - only images
                   2 for 32-bit integers - only images
                   3 for 32-bit IEEE floating point - images and
                     required for uv data
             Default: 0 => 3.
             If you want to import your FITS data into another
             system, make sure that it is able to read the
             format that  you have selected.
  BLOCKING...Code to tell what blocking factor to be used in
             writing the whole file
             Default: 0 => 10.
             Considerations: (a) blocking factor <= 10.
                (b) AIPS releases prior to 15APR87 can read
                    only FORMATs 1 and 2.  Do not use blocking
                    if you may go to an earlier release of AIPS.
                    This same consideration also applies to
                    most other FITS readers around the world.
                (c) Blocking is ignored when writing to disk
                    rather than tape.
                (d) Larger blocks use fewer I/O operations
                    making tape reads and writes more efficient.

EXPLAIN SECTION

FITDISK:            Procedure to run FITTP to write files to disk
                    with automatically produced file names based
                    on there AIPS names.
Documenter:         Amy Mioduszewski
Related Programs:   FITTP, WRTDISK, WRTPROCS

To load the procedure type RUN WRTPROCS.  This must be done before
running the procedure (by typing FITDISK).

FITDISK will write a file to the directory set in DATAOUT.
This must be a logical variable set before AIPS is started.
The file that is written will have an automatically generated
name which is the AIPS name with internal blanks converted to
'_' and trailing blanks omitted.

Example:

> OUTFI 'FITS'
> INNAME 'BM103 H'
> INCLASS 'UVDATA'
> INSEQ 2

will write a file named BM103_H.UVDATA.2 to the $FITS directory.

WARNING:  There is a CLRTEMP at the end of the procedure to clear
the array holding the variables.  This will NOT effect most people
who use FITDISK on its own or in one line "FOR" loops.  However,
this may prevent FITDISK being used in more complicated constructs.

AIPS