ENVINITF::OpenCameraSeries
The OpenCameraSeries function method creates a new ENVIRasterSeries from selected camera series from a MIE4NITF file.
Example
; Start the application
e = ENVI(/HEADLESS)
; Open a MIE4NITF file
File = FILEPATH('MIE4NITFExample.ntf', $
ROOT_DIR=e.ROOT_DIR, SUBDIRECTORY = ['data', 'NITFExamples'])
NITF = ENVINITF(File)
; Open and subset the first camera series
Series = NITF.OpenCameraSeries(0, START_FRAME=0, END_FRAME=4)
Print, Series
Result:
Description: Raster Series 2020-10-15T21-21-25Z
Data Type: UInt
Version: 5.6
Total Number of files: 5
Regular Grid: true
Regular Bands: true
0: : INSTALL_DIR\ENVIxx\data\NITFExamples\MIE4NITFExample.ntf
1: : INSTALL_DIR\ENVIxx\data\NITFExamples\MIE4NITFExample.ntf
2: : INSTALL_DIR\ENVIxx\data\NITFExamples\MIE4NITFExample.ntf
3: : INSTALL_DIR\ENVIxx\data\NITFExamples\MIE4NITFExample.ntf
4: : INSTALL_DIR\ENVIxx\data\NITFExamples\MIE4NITFExample.ntf
Syntax
Result = ENVINITF.OpenCameraSeries(Index [, Keywords=value])
Return Value
This method returns a scalar or array of ENVIRasterSeries objects.
Arguments
Index
Specify a scalar or array of camera series, which can range from 0 to the number of series, minus one.
Keywords
These keywords are optional.
ALL
Set this keyword to return an ENVIRasterSeries array of all available camera series. Any Index values you specify will be ignored.
END_FRAME
Specify the ending frame number, if you want to subset the camera series. The default value is the number of frames, minus one.
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.
INCREMENT
Specify the increment to use between frames, if you want to subset the camera series. The default value is 1.
SENSOR_MODEL
Specify a string with the sensor model to use. An example is 'RSM'
(replacement sensor model). To get a list of available SENSOR_MODEL values for the raster, use ENVINITFQuerySensorModels.
This keyword 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.
If the MSP Sensor Model Selection preference has been set to "Enable User Selection" and the SENSOR_MODEL keyword has not been set, then SENSOR_MODEL will default to using "Use MSP Default."
START_FRAME
Specify the starting frame number, if you want to subset the camera series. The default value is 0.
TERRAIN_SOURCE
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
This keyword is only available with the ENVI Department of Defense (DoD) plug-in.
Version History
ENVI 5.6.1 |
Introduced |
ENVI 5.6.2 |
Added TERRAIN_SOURCE keyword |
API Version
4.2
See Also
ENVINITF, ENVINITF::OpenCameraSeriesFrames, ENVIRasterSeries, ENVIRasterSeriesLayer