AIPS HELP file for FITDISK in 31DEC24
As of Wed Sep 11 3:24:27 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.