AIPS NRAO AIPS HELP file for FITTP in 31DEC24



As of Wed Nov 6 7:46:15 2024


FITTP: Task to write maps or uv data on a FITS-tape.

INPUTS

DOALL          -1.0         1.0    1 (T) do all, -1 (F) do 1st.
INNAME                             Image name(name).  Standard.
INCLASS                            Image name(class). Standard.
INSEQ           0.0      9999.0    Image name(seq. #).
INDISK          0.0         9.0    Disk drive #.      0 => any
INTYPE                             File type.     Blank => any
OUTTAPE         0.0         9.0    Tape drive #.  0 => 1
DATAOUT
                                   Disk file name
DOEOT          -1.0         1.0    1 (T) go to end tape first.
FORMAT          0.0         4.0    tape format:   0 => 3.
                                       1 for 16-bit integer
                                       2 for 32-bit integer
                                       3 for 32-bit IEEE
                                         floating point
                                       4 for 8-bit integer maps
BLOCKING        0.0        10.0    tape blocking factor (<= 10)
CATNO                              Limit range of catalog number
DOPLOT         -1.0                > 0 -> include plot files

HELP SECTION

FITTP
Type: Task
Use:  FITTP converts the standard header and map or uv data and writes
      it on a output tape in the FITS format.  The 1st image or all
      images that match the input parameters can be written.  The tape
      is left following the End-of-file mark which terminates the last
      file written.  All Clean Components extension files for maps or
      ANtenna files for uv data will be written with the image in a
      special TABLES format (following the image itself in the file).
      Other tables-format extension files will also be written.

      When using this task (or FITAB) to transfer data to another
      software system such as CASA, users should be aware of
      limitations in this process.  The images and UV data files
      should be transferred flawlessly.  However, the other software
      systems may not understand the tables accompanying the files.
      For images, there are Clean Component (CC) and Clean Gaussian
      (CG) tables.  CC files are understood on occasion, but CG files
      are rarely understood.  For UV data files there are a wide
      variety of tables.  Antenna (AN) and Source (SU) files are
      usually understood, but Flag (FG), Calibration (CL and SN),
      SysPower (SY), Bandpass (BP), Polarization D-terms (PD), etc.
      are unlikely to be understood.  Use SPLIT or SPLAT to apply
      these tables to the data and then FITTP the result.  Note that
      few packages understand uv data written in tabular form by
      FITAB.  OBIT and other Parseltongue-based packages often use
      AIPS for some or much of their processing and so are more likely
      to understand the multiple tables and they do accept FITAB
      output.
Adverbs:
  DOALL......True (> 0) means do all files matching the input
             parameters, false (<= 0) means do the 1st match
             only.
  INNAME.....The input image name (name).  Standard defaults.
  INCLASS....The input image name (class). Standard defaults.
  INSEQ......The input image name (seq. #). 0 => any if DOALL
             is true, 0 => highest if DOALL is false.
  INDISK.....The input disk unit #. 0=> search all disks in
             order for file meeting the other criteria.
  INTYPE.....The input data type (MA or UV or ' ' for either)
  OUTTAPE....The output tape unit #.  0=> 1.
  DATAOUT....The name of a disk file into which to write.
             If blank then write to tape.  If output is to a
             disk file, only 1 file can be written (DOALL=-1).
             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 named
               is to be stored.   is usually
              omitted when the file is local to the current
              computer.
  DOEOT......True (> 0) means to advance the tape to the end
             of information (double EOF) before writing, false
             means write wherever the tape is now positioned.
             Note: set DOEOT true ONLY if you think that there
             are already FITS data files on the tape AND if
             you wish to preserve them.
  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
                   4 for 8-bit integers - only images
             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.
  CATNO......Range of catalog numbers over which the operation is to
             take place.  CATNO(1) <= 0 -> 1; CATNO(2) < CATNO(1) ->
             very large.  BE CAREFUL with this - it limits the range
             allowed independent of the value of DOALL.  CATNO=0 is
             recommended unless you intend limitations.
  DOPLOT.....> 0 -> include plot files as a pseudo-binary table
             extension.  Note that this will be useful only if the
             file is read by AIPS 31DEC24 and later.

EXPLAIN SECTION


AIPS