The GetTemporaryFilename function method returns a fully qualified path and name of a file located in ENVI's temporary directory. This filename is unique in the file system.


; Launch the application
e = ENVI()
; Create an ENVIRaster
file = FILEPATH('qb_boulder_pan', ROOT_DIR=e.ROOT_DIR, $
  SUBDIRECTORY = ['data'])
raster1 = e.OpenRaster(file)
; Create a temporary output file
newFile = e.GetTemporaryFilename()
; Export a subset of the raster as a TIFF file
subRaster = ENVISubsetRaster(raster1, $
subraster.Export, newFile, 'TIFF'


Result = ENVI.GetTemporaryFilename([Extension] [, Keywords=value])

Return Value

This method returns a string containing the fully qualified path and name of a file in ENVI's temporary directory. This directory is defined by the Temporary Directory setting in the ENVI preferences.



A scalar string denoting the filename extension. If this argument is not supplied, a .dat extension is appended.



Set this keyword to delete the file from the Temporary Workspace when ENVI closes.


Set this keyword to a scalar integer indicating how many unique filenames to generate and return as a string array. If this keyword is not set, then a single filename is generated and returned as a scalar string.


Set this keyword to a named variable that will contain any error message issued during execution of this routine. If no error occurs, the ERROR variable will be set to a null string (''). If an error occurs and the routine is a function, then the function result will be undefined.

When this keyword is not set and an error occurs, ENVI returns to the caller and execution halts. In this case, the error message is contained within !ERROR_STATE and can be caught using IDL's CATCH routine. See IDL Help for more information on !ERROR_STATE and CATCH.

See Manage Errors for more information on error handling in ENVI programming.

Version History



ENVI 5.5

Added CLEANUP_ON_EXIT keyword

API Version


See Also

ENVI, ENVI::CleanupTemporaryWorkspace