ENVIPseudoRasterSpatialRef

This is a reference to an ENVIPseudoRasterSpatialRef object, which contain properties that describe a pseudo spatial reference associated with an ENVIRaster.

Example

The most common programmatic use for ENVIPseudoRasterSpatialRef is retrieving the coordinate system property from an ENVIRaster that contains a pseudo spatial reference. This is stored in the raster's SPATIALREF property. The following code shows a general example:

; Open a raster that contains a pseudo spatial reference

File = 'MyRaster.dat'

Raster = e.OpenRaster(File)

 

; Retrieve and print the properties of the spatial reference

Print, Raster.SPATIALREF

Syntax

Result = ENVIPseudoRasterSpatialRef([, Properties=value, ERROR=value])

Methods

ConvertFileToFile

ConvertFileToLonLat

ConvertFileToMap

ConvertLonLatToFile

ConvertLonLatToLonLat

ConvertLonLatToMap

ConvertLonLatToMGRS

ConvertMapToFile

ConvertMapToLonLat

ConvertMapToMap

ConvertMGRSToLonLat

Dehydrate

Hydrate

NorthIsUpAngle

ShadowsDownAngle

Properties

Properties marked as (Get) can be retrieved, but not set.

COORD_SYS_CODE (Get)

Use this property to get a geographic (GEOGCS) or projected (PROJCS) coordinate system code.

For a full list of coordinate system strings and codes, refer to the following text files in the \IDLxx\resource\pedata\predefined directory of the ENVI distribution:

COORD_SYS_STR (Get)

Use this property to get a geographic (GEOGCS) or projected (PROJCS) coordinate system string.

For a full list of coordinate system strings and codes, refer to the following text files in the \IDLxx\resource\pedata\predefined directory of the ENVI distribution:

PIXEL_SIZE (Get)

This is a two-element array [X Pixel Size, Y Pixel Size] specifying the pixel size of the data. The pixel sizes must be in the same units as the coordinate system.

PSEUDO_GEO_POINT_1, PSEUDO_GEO_POINT_2, PSEUDO_GEO_POINT_3, PSEUDO_GEO_POINT_4 (Init, Get)

Each property is a four-element array [X Pixel, Y Pixel, Longitude, Latitude] specifying a geographic corner for a non-georeferenced file. Depending on the data source, not all four properties may contain information. The four points do not have to be in any specific order.

Keywords

ERROR (optional)

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.1

Introduced; Added ability to serve as a constructor function for creating new pseudo spatial reference objects.

ENVI 5.3.1

Added Dehydrate method

ENVI 5.4

Added Hydrate method

ENVI 5.6.1

Added ConvertFileToLonLat and ConvertLonLatToFile methods

ENVI 5.6.3 Added PIXEL_SIZE property and NorthIsUpAngle method

API Version

4.2

See Also

ENVIGLTRasterSpatialRef, ENVIRPCRasterSpatialRef, ENVIStandardRasterSpatialRef