ENVINITFCSMRasterSpatialRef

This is a reference to an ENVINITFCSMRasterSpatialRef object, which contain properties that describe a NITF Community Sensor Model (CSM) spatial reference.

This routine is only available with the ENVI Department of Defense (DoD) plug-in. This is a separate package that provides additional support in ENVI for data formats and sensor models that are commonly used by customers in the U.S. defense and intelligence community. It includes features such as Mensuration Services Program (MSP) integration, Community Sensor Model (CSM) support, TFRD, and additional NITF capabilities. Contact your sales representative for more information.

Syntax

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

Methods

ConvertLonLatToLonLat

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_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. The pixel sizes must be in the same units as the coordinate system.

NITF_URI (Init, required)

Specify a fully qualified URI to a NITF file that contains replacement sensor model (RSM) tagged record extensions (TREs).

SEGMENT_INDEX (Init)

Specify a zero-based integer indicating the image segment to use in a multi-segment NITF image.

SENSOR_MODEL (Init)

Specify a string with the sensor model to apply. Use ENVINITFQuerySensorModels to determine the available sensor models for the image.

TERRAIN_SOURCE (Init)

Specify a string with the terrain source to use:

Best: Used by default if a terrain source is not specified
DTED0
DTED1
DTED2
Reference Point
SRTM0
SRTM1
Terrain Base

ENVINITFCSMRasterSpatialRef also honors the path to the terrain source set in the MSP preferences. Restart ENVI after making any changes to the MSP preferences.

If both TERRAIN_SOURCE and USER_HEIGHT are set, only USER_HEIGHT will be honored.

USER_HEIGHT (Init)

Specify a height value (in meters) to use for all file-to-map and map-to-file coordinate conversions for the spatial reference.

If both TERRAIN_SOURCE and USER_HEIGHT are set, only USER_HEIGHT will be honored.

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.4.1	Introduced
ENVI 5.5.3	Added USER_HEIGHT property
ENVI 5.6.2	Added TERRAIN_SOURCE property. ENVINITFCSMRasterSpatialRef also honors the path to the terrain source set in the MSP preferences.
ENVI 5.6.3	Added NorthIsUpAngle and UpIsUpAngle methods.

API Version

4.2