Added new task + tests

README.md

@@ -62,12 +62,16 @@ Several ENVI Tasks that wrap the ENVI doits for converting between color spaces.
 
 See [./other/examples.md](./other/examples.md) for examples running each task from IDL.
 
+- XTExecuteStatement: This task will execute any valid IDL statement and is intended for use in the ENVI Modeler where you can't execute any IDL command that you want. You will not get results back from running any functions or procedures. The intended use was, but is not limited to, being able to run different IDL procedures that might initialize your environment prior to task processing. Note that this tool **requires** that you have ENVI + IDL started for use.
+
 - XTExtractNameFromRaster: Simple procedure that returns the name of a raster with special characters removed so that you could write a new file to disk. The special characters that get removed are ones that are not allowed in filepaths on computers and can appear in some use cases.
 
 - XTCreateRasterPyramid: This will create a Pyramid file for a raster.
 
 - XTFileSearch: This task searches a folder for files for easy processing in ENVI for the ENVI Modeler. It will throw an error if no files are found.
 
+- XTQUACWithBadBandsList: This task lets you process a file with QUAC (atmospheric correction) that first subsets the data with information on bad bands. For the examples below, you must have the same number of bad band elements as there are bands in the raster that will be processed.
+
 - XTSaveROITrainingStatistics: This task saves statistics that were extracted from a raster over regions of interest so that the information persists between ENVI+IDL sessions.
 
 - XTRestoreROITrainingStatistics: This task saves statistics that were extracted from a raster over regions of interest so that the information persists between ENVI+IDL sessions.

other/examples.md

@@ -28,6 +28,24 @@ Task.INPUT_RASTER = Raster
 Task.Execute
 ```
 
+## XTExecuteStatement
+
+This task will execute any valid IDL statement and is intended for use in the ENVI Modeler where you can't execute any IDL command that you want. You will not get results back from running any functions or procedures. The intended use was, but is not limited to, being able to run different IDL procedures that might initialize your environment prior to task processing. Note that this tool **requires** that you have ENVI + IDL started for use.
+
+```idl
+; Start the application
+e = ENVI()
+
+; Load our extra tasks
+xtTasksInit
+
+; Get the  task from the catalog of ENVITasks
+Task = ENVITask('XTExecuteStatement')
+Task.STATEMENT = 'print, 5'
+Task.Execute
+```
+
+
 ## XTExtractNameFromRaster
 
 As the task name implies, this tasks extracts the name property from a raster and removes all special characters (those not allowed in filepaths). Here is a short example:
@@ -255,4 +273,4 @@ DataColl.Add, ClassTask.OUTPUT_RASTER
 View = e.GetView()
 Layer = View.CreateLayer(Raster)
 Layer2 = View.CreateLayer(ClassTask.OUTPUT_RASTER)
-```
+```

other/executeStatement/xtexecutestatement.pro

@@ -0,0 +1,41 @@
+;h+
+; Copyright (c) 2018, Harris Geospatial Solutions, Inc.
+; 
+; Licensed under MIT, see LICENSE.txt for more details
+;h-
+
+;+
+; :Description:
+;    Routine that allows users to execute any IDL
+;    statement in an ENVI task and the ENVI modeler.
+;    
+;    This task does not return anything while running.
+;
+;
+;
+; :Keywords:
+;    STATEMENT: in, required, type=string
+;      Specify an IDL statement that you want to execute
+;      as a task.
+;
+; :Author: Zachary Norman - GitHub: znorman-harris
+;-
+pro xtExecuteStatement,$
+  STATEMENT = statement
+  compile_opt idl2, hidden
+
+  ;validate the input
+  if (statement eq !NULL) then begin
+    message, 'STATEMENT not specified, required!', LEVEL = -1
+  endif
+  if ~isa(statement, /STRING) then begin
+    message, 'STATEMENT specified, but is not a string!', LEVEL = -1
+  endif
+
+  ;execute the line
+  if ~execute(statement) then begin
+    help, /LAST_MESSAGE
+    print
+    message, 'Error while executing statement!', LEVEL = -1
+  endif
+end

other/executeStatement/xtexecutestatement.spec.pro

@@ -0,0 +1,63 @@
+;h+
+; Copyright (c) 2018, Harris Geospatial Solutions, Inc.
+;
+; Licensed under MIT, see LICENSE.txt for more details
+;h-
+
+;+
+; :Description:
+;    Tests for the xtexecutestatement procedure and task.
+;    
+;    Running these tests requires additional code that
+;    is not a part of this repository.
+;
+; :Author: Zachary Norman - GitHub: znorman-harris
+;-
+
+;get the current directory
+thisdir = file_dirname(routine_filepath())
+
+;specify the task and PRO file
+taskFile = thisdir + path_sep() + 'xtexecutestatement.task'
+proFile = thisdir + path_sep() + 'xtexecutestatement.pro'
+
+;start ENVI
+e = envi(/HEADLESS)
+
+;create a luna tester
+l = luna(CONFIG_FILE = './../../idl.test.json')
+
+  ;create a suite
+  s = l.suite('Test that our task file')
+
+    ; amke sure the task exist
+    it = s.test('exists')
+
+      (it.expects(1)).toEqual, file_test(taskFile)
+
+    ; make sure we have a valid task file
+    it = s.test('is a valid task file')
+
+      (it.expects(taskFile)).toBeAValidENVITask
+
+  ;create a suite
+  s = l.suite('Test that we can')
+
+    ;validate procedure
+    it = s.test('run as a procedure')
+
+      ; run procedure
+      (it.expects('xtExecuteStatement')).toRunProcedure, $
+        STATEMENT = 'print, 5'
+
+    ; validate our task
+    it = s.test('run as a task')
+
+      task = ENVITask(taskFile)
+      task.STATEMENT = 'print, 5'
+
+      (it.expects(task)).toExecuteENVITask
+
+;generate a test summary
+l.GenerateTestSummary
+end

other/executeStatement/xtexecutestatement.task

@@ -0,0 +1,18 @@
+{
+    "name": "XTExecuteStatement",
+    "version": "5.3",
+    "baseClass": "ENVITaskFromProcedure",
+    "routine": "xtexecutestatement",
+    "displayName": "XT Execute Statement",
+    "description": "This task will execute any valid IDL statement. You will not get results back from running the code. The intended use was, but is not limited to, being able to run different IDL procedures that might initialize your environment prior to task processing. Note that this tool **requires** that you have ENVI + IDL started for use.",
+    "parameters": [
+        {
+            "name": "STATEMENT",
+            "displayName": "Statement",
+            "description": "Specify the IDL statement that you want to execute.",
+            "direction": "input",
+            "parameterType": "required",
+            "dataType": "string"
+        }
+    ]
+}

other/quacWithBadBandsList/xtquacwithbadbandslist.pro

@@ -124,4 +124,4 @@ pro xtQuacWithBadBandsList,$
 
   ;clean up
   subset.close
-end
+end