Description:
This function creates a new FITS file with a given path, and returns a logical unit
number that can be used to access it using CVG and FITSIO functions.
Invocation
CALL
CVG_NEW( PATH, BLOCKF, OVRWRT, FUNIT, STATUS )
Arguments
PATH = CHARACTER
(
)
(Given)
The path to the file to be created. A file type of "
.fit"
will be added if there is no file type in
the supplied string.
BLOCKF = INTEGER (Given)
The blocking factor for the new file. It must be a
positive integer between 1 and 10.
OVRWRT = LOGICAL (Returned)
If .TRUE., any existing file
with the given name is silently over-written. Otherwise, an error is reported if the file already exists.
FUNIT = INTEGER (Returned)
The logical unit number of the FITS file. Returned equal to
CVG_NOLUN if an error occurs.
STATUS = INTEGER (Given and Returned)
The global status.