This task creates point regions of interest (ROIs) from a saved feature count file (.efc).

Example


Sample data files are available on our ENVI Tutorials web page. Click the Deep Learning link to download the .zip file to your machine, then unzip the files. containing the feature counting data. The files you will use in this example are located in the shipping_containers folder of the download. Update the file references in the example with the correct locations.

; Start the application
e = ENVI()
 
; Open a feature count file
; Update the following line with the correct path
; to the tutorial data files
File = 'C:\MyTutorialFiles\FeatureCountContainers.efc'
   
; Open an orthophoto of seaport
OrthoFile = 'C:\MyTutorialFiles\OaklandPortOrthophoto1.dat'
Raster = e.OpenRaster(OrthoFile)
 
; Get the task from the catalog of ENVITasks
Task = ENVITask('FeatureCountToROI')
 
; Define inputs
Task.INPUT_FEATURE_COUNT_URI = File
 
; Run the task
Task.Execute
 
; Display the resulting ROI over the orthophoto
View = e.GetView()
Layer = View.CreateLayer(Raster)
roiLayer = Layer.AddROI(Task.OUTPUT_ROI)
View.Zoom, 3.0

Syntax


Result = ENVITask('FeatureCountToROI')

Input parameters (Set, Get): INPUT_FEATURE_COUNT_URI, OUTPUT_ROI_URI

Output parameters (Get only): OUTPUT_ROI

Parameters marked as "Set" are those that you can set to specific values. You can also retrieve their current values any time. Parameters marked as "Get" are those whose values you can retrieve but not set.

Input Parameters


INPUT_FEATURE_COUNT_URI (required)

Specify the fully qualified path and filename for an ENVI feature count file (.efc).

OUTPUT_ROI_URI (optional)

Specify a string with the fully qualified path and filename for OUTPUT_ROI.

Output Parameters


OUTPUT_ROI

This is a reference to the output ROI.

Methods


Execute

Parameter

ParameterNames

Properties


DESCRIPTION

DISPLAY_NAME

NAME

REVISION

TAGS

Version History


ENVI 5.6

Introduced

See Also


ENVITask, ENVIFeatureCount