This routine has been deprecated and renamed to ENVIStandardRasterSpatialRef.

This is a reference to the ENVIRasterSpatialRefStandard object. See ENVI::CreateRasterSpatialRef for details on creating this object. You can also retrieve the reference to an ENVIRasterSpatialRefStandard object associated with a raster with ENVIRaster's SPATIALREF property. If you print this object, all properties will display regardless of the spatial reference type.

If a data set has more than one type of map information (for example, a standard map projection and rational polynomial coefficients (RPCs)), the standard map projection will take precedence and determine the base projection.

Note: To achieve the highest level of accuracy when creating this object, specify values as double-precision floating point numbers.

Example

; Launch the application
e = ENVI()
 
; Create a custom spatial reference object
spatialRef1 = e.CreateRasterSpatialRef('standard', $
  COORD_SYS_CODE=2231, /PROJCS, $
  PIXEL_SIZE=[9.186D,9.186D], TIE_POINT_PIXEL=[0.0D,0.0D], $
  TIE_POINT_MAP=[3075299.7946D,1246937.9905D])
 
; Open a file but override its spatial reference information
file = FILEPATH('qb_boulder_msi', ROOT_DIR=e.ROOT_DIR, $
  SUBDIRECTORY = ['data'])
raster = e.OpenRaster(file, SPATIALREF_OVERRIDE=spatialRef1)
 
; Retrieve and print the spatial reference 
spatialRef = raster.SPATIALREF
PRINT, spatialRef

Methods

None

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:

  • EnviPEProjcsStrings.txt: PROJCS codes and strings
  • EnviPEGeogcsStrings.txt: GEOGCS codes and strings

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:

  • EnviPEProjcsStrings.txt: PROJCS codes and strings
  • EnviPEGeogcsStrings.txt: GEOGCS codes and strings

PIXEL_SIZE (Get)

This is a two-element array [X Pixel Size, Y Pixel Size] specifying the pixel size of the data.

ROTATION (Get)

This property specifies the rotation of the image in the defined projection (degrees clockwise from North).

TIE_POINT_MAP (Get)

This property is a two-element array [X Tie Point, Y Tie Point] representing the map location that corresponds to the pixel location (TIE_POINT_PIXEL).

TIE_POINT_PIXEL (Get)

This property is a two-element array [X Pixel, Y Pixel] representing the pixel location that corresponds to the map location (TIE_POINT_MAP). The default location of the upper-left pixel for images displayed in ENVI is (0,0). The reference (tie point) pixel values in the map info field of an ENVI header file are one-based. If the TIE_POINT_PIXEL values come directly from an ENVI header file, you must subtract 1 from x and y.

Note: From the ENVI 5.0 release to the ENVI 5.0.2 release, the upper-left pixel for images was (1,1).

Version History

ENVI 5

Introduced

ENVI 5.1

Deprecated