AIPS NRAO AIPS HELP file for WRTDISK in 31DEC24



As of Thu Apr 25 3:05:22 2024


WRTDISK: procedure to write maps or uv data to disk

INPUTS

                                   type RUN WRTPROCS first!
INDISK          0.0         9.0    UV file disk drive #
NFILES                             First catalog number
NCOUNT                             Last catalog number
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

WRTDISK
Type: Procedure
Use:  WRTDISK writes a FITS file to disk, looping through many
      catalog numbers as specified.  The disk file will have a
      standard name (DISK##C####) which can be read back into
      AIPS using READISK.  WRTDISK uses FITLD (see HELP FITLD
      for details).  Remember to load this procedure typing RUN
      WRTPROCS before trying to run it (by typing WRTDISK).
Adverbs:
  INDISK.....The input disk unit #.
  NFILES.....The catalog number of the first file to be written
             out. 0 => 1
  NCOUNT.....The catalog number of the last file to be written
             out. 0 => number in NFILES
  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.
  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

WRTDISK:            Procedure to run FITTP to write files to disk
                    with a standard file name that can be read back
                    into AIPS using READISK.
Documenter:         Amy Mioduszewski
Related Programs:   FITTP, READISK, FITDISK, WRTPROCS

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

WRTDISK 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 a standard format which can be used to be read
back into AIPS with READISK.  This standard format is
DISKddCcccc, where the dd and the cccc are numbers.  The dd
is specified in the INDISK input and the cccc is the AIPS
catalog number of the file.  If NFILES and NCOUNT are different
then the catalog numbers NFILES through NCOUNT are looped
through.

Example:

If you set:
INDISK 1
NFILES 98
NCOUNT 101
DATAOUT 'FITS'

Then WRTDISK will write files in catalog numbers 98-101 on
disk 1 to directory $FITS with names:
DISK01C0098
DISK01C0099
DISK01C0100
DISK01C0101

You can then use READISK to read them back into AIPS.

AIPS