ENVIGridDefinition

This is a reference to a grid definition, which provides the information needed to georeference rasters and vectors to a common coordinate system. ENVIGridDefinition is only a definition, not a spatial reference or raster. It can be used as an input to ENVISpatialGridRaster or to define the grid parameters for an empty raster. It does not refer to any raster or rely on any specific raster to set its extents.

A grid definition provides the following information:

Coordinate system
Spatial (geographic) extent
Pixel (cell) size
Rows and columns
Tie point pixel and map coordinates

Example

This example defines a new spatial grid that is based on an Australian Map Grid Zone 54 coordinate system. Two images with different coordinate systems will reproject to this grid. The images are available from our ENVI Tutorials web page. Click the API Gridding Examples link to download the .zip file to your machine, then unzip the files.

MODIS Land Surface Temperature (MOD11_L2) swath image from 07 March 2009, georeferenced to a UTM Zone 54 coordinate system using ENVI's Georeference MODIS tool, corrected for bowtie artifacts, spatially subsetted, and scaled by 0.02 so that the pixel values are in Kelvins.
Suomi NPP VIIRS Land Surface Temperature EDR image from 07 March 2014, georeferenced to a Geographic Lat/Lon (WGS-84) coordinate system, and spatially subsetted.

; Start the application

e = ENVI()

; Open the MODIS LST raster

File1 = 'MODIS_LST_2009-03-07.dat'

MODISRaster = e.OpenRaster(File1)

; Open the Suomi NPP VIIRS LST raster

File2 = 'VIIRSLST2014-03-07.dat'

VIIRSRaster = e.OpenRaster(File2)

; Create a coordinate system object for

; Australian Map Grid (ADG84) Zone 54

CoordSys = ENVICoordSys(COORD_SYS_CODE=20354)

; Create a grid definition

; [xmin, ymax, xmax, ymin]

; x is easting and y is northing

Grid = ENVIGridDefinition(CoordSys, $

EXTENT=[257017.6D, 7831362.4D, 1153892.7D, 7270425.0D], $

PIXEL_SIZE=[1000.0D, 1000.0D])

; Reproject the MODIS image to the spatial grid

ReprojMODISRaster = ENVISpatialGridRaster(MODISRaster, $

GRID_DEFINITION=Grid)

; Reproject the VIIRS image to the spatial grid

ReprojVIIRSRaster = ENVISpatialGridRaster(VIIRSRaster, $

GRID_DEFINITION=Grid)

; Display the reprojected rasters

View = e.GetView()

Layer1 = View.CreateLayer(ReprojMODISRaster)

Layer2 = View.CreateLayer(ReprojVIIRSRaster)

Syntax

Result = ENVIGridDefinition(ENVICoordSys [, Properties=value])

Return Value

This routine returns a reference to a grid definition object.

Arguments

CoordSys

Specify an ENVICoordSys object that defines the coordinate system to use for the grid definition. You can use the coordinate system of an open ENVIRaster or ENVIVector using its COORD_SYS property.

You can also reference a coordinate system by its code or string, which are located in the IDL installation folder under \IDLxx\resource\pedata\predefined:

EnviPEProjcsStrings.txt: projected coordinate system (PROJCS) codes and strings
EnviPeGeogcs.txt: geographic coordinate system (GEOGCS) codes and strings
On Windows sytems, these files are best viewed in the WordPad application. Use the Ctrl+F key combination to help find projection names.

Methods

ConvertGridToMap

ConvertMapToGrid

CreateGridFromCoordSys

Properties

Properties marked as (Init) can be set during the initial creation of the object. Properties marked as (Get) can be retrieved. Properties marked as (Set) can be set after initial creation.

COORD_SYS (Init)

The ENVICoordSys object that defines the coordinate system used for the grid definition.

EXTENTS (Init, Get)

Specify the geographic extent of the grid as follows:

[xmin, ymax, xmax, ymin]

where x and y are map coordinates (x=eastings, y=northings) or geographic coordinates (x=longitude, y=latitude), depending on the ENVICoordSys object. The coordinates must be in the same units (degrees, meters, feet, etc.) as the associated ENVICoordSys object.

If you set this property, you must also specify (1) PIXEL_SIZE or (2) NROWS and NCOLUMNS.

NCOLUMNS (Init, Get)

Specify the number of columns in the grid.

NROWS (Init, Get)

Specify the number of rows in the grid.

PIXEL_SIZE (Init)

Specify a two-element array with the [x,y] pixel size in the same units as the associated ENVICoordSys object.

SPATIALREF (Get)

An ENVIStandardRasterSpatialRef object.

TIE_POINT_MAP (Init)

Specify a two-element array with the map coordinates of the TIE_POINT_PIXEL location, as follows:

[xmin, ymax]

The coordinates must be in the same units (degrees, meters, feet, etc.) as the associated ENVICoordSys object. If you set this property, you must also specify NROWS, NCOLUMNS, and PIXEL_SIZE.

TIE_POINT_PIXEL (Init)

Specify a two-element array with the pixel coordinates of the tie point. If you set this property, you must also specify TIE_POINT_MAP, NROWS, NCOLUMNS, and PIXEL_SIZE. If you do not set this property, the default pixel coordinates are [0,0].

Version History

ENVI 5.2	Introduced
ENVI 5.3.1	Added Dehydrate method
ENVI 5.4	Added Hydrate method

API Version

4.2