CVG_NEW

Creates a new FITS file and return a unit number for it

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.