ENVI::GetOpenData

This method has been deprecated. See ENVIDataCollection.

The GetOpenData function method returns all ENVIRaster or ENVIVector objects currently open in the data manager.

Example

; Launch the application with four views

e = ENVI(LAYOUT=[2,2])

; Create an ENVIRaster

file1 = FILEPATH('qb_boulder_msi', ROOT_DIR=e.ROOT_DIR, $

  SUBDIRECTORY = ['data'])

raster1 = e.OpenRaster(file1)

; Retrieve data from original raster that contains only a single band

origData = raster1.GetData(BANDS=0)

; Create another ENVIRaster and save it

file2 = e.GetTemporaryFilename()

raster2 = ENVIRaster(origData, URI=file2, NBANDS=1)

raster2.Save

; Open a shapefile and create an ENVIVector

; from the shapefile data

file3 = FILEPATH('states.shp', $

  SUBDIRECTORY = ['examples', 'data'])

vector1 = e.OpenVector(file3)

; Display the rasters and vectors in the first three views

views = e.GetView(/ALL)

layer1 = views[0].CreateLayer(raster1)

layer2 = views[1].CreateLayer(raster2)

layer3 = views[2].CreateLayer(vector1)

; Get the array of all objects currently open

oArray = e.GetOpenData()

PRINT, oArray

Syntax

Result = ENVI.GetOpenData([ERROR=variable] [, /RASTER] [, /VECTOR])

Return Value

This method returns an array of all ENVIRaster and ENVIVector objects currently open in the data manager. This method only returns references to ENVIRaster- and ENVIVector-supported datasets, and will not return data entities not supported by the ENVI API.

If no keywords are set, all existing ENVIRaster or ENVIVector objects are returned.

If no rasters or vectors are currently open, !NULL is returned.

Arguments

None

Keywords

Keywords are applied only during the initial creation of the object.

ERROR

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.

RASTER

Set this keyword to include all existing ENVIRasters in the returned array.

VECTOR

Set this keyword to include all existing ENVIVectors in the returned array.

Version History

ENVI 5	Introduced
ENVI 5.1	Deprecated