gfitsio.lvlib:gfitsio-open-create-replace-file.vi

Opens an existing FITS file, creates a new FITS file, or replaces an existing FITS file, programmatically or interactively using a file dialog box. You can optionally specify a dialog prompt and default file name.


Connector Pane

gfitsio.lvlib:gfitsio-open-create-replace-file.vi


Controls and Indicators

cstr

prompt

The message that appears in the title bar of the file dialog box.

cpath

file path (dialog if empty)

The path name of the file to access. If file path is empty (default) or is <Not A Path>, the VI displays a dialog box from which you can select a file.

cenum

function (open)

Operation mode for the VI. The options are:

open - open an existing file

open or create - open an existing file or create a new one if it does not exist

create or replace - create a new file, replacing an existing one, if necessary

create - create a new file

open (read only) - open an existing file for reading only

cerrcodeclst

error in (no error)

Describes error conditions that occur before this VI or function runs.

cstr

default name

The name you want to appear as the initial file name in the dialog box if it is displayed.

cbool

advisory dialog? (display:T)

Specifies whether to display notification dialogs to the user when a file is not found or would be overwritten.

idlrn

gfits refnum

A reference to the opened or created file.

ipath

new file path

Path of the opened or created file.

ierrcodeclst

error out

If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces.