|
<< Click to Display Table of Contents >> IDL Scripting Examples - Interferometry |
  
|
|
<< Click to Display Table of Contents >> IDL Scripting Examples - Interferometry |
|
Purpose
It allows to execute one or more processing steps by preparing an IDL script, which actually calls specific SARscape routines.
The SARscapeBatch object has to be used to call any SARscape functionality by means of an IDL script.
Note: The geocoding example contains all the steps in order to know all the possible indications that can be performed to work with IDL scripts. We strongly suggest to try the geocoding example with all the functionality before starting with this example.
Technical Note
The use of this functionality foresees the knowledge of the IDL programming language. The SARscape IDL scripting technology is also exploited in the batch processing.
The IDL script must be structured as shown in the sarscape_script_from_scratch_example.pro example file
(found in the following zip folder: "C:\Program Files\SARMAP SA\SARscape\examples\example_sarscape_script_from_scratch_example_52.zip", which is relevant to the execution of interferometry and filtering process.
To start this example, please perform the following steps:
•Run IDL or IDL + ENVI
•Open the IDLscript_example_geocoding.pro in IDL and click the compile button
•To Run the script you need to write the following command in the IDL console: SARscape_script_from_scratch_example
The content of the IDL example script is synthetically described here below:
| 1) | SARscape batch initialization and temporary directory setting (preparatory step) |
The SARscape extension file is restored from the original repository folder. The folder path, where the default processing values are copied, is defined. It has to be noted that all the alternative default settings (General, VHR, HR, MR, etc.) are stored within this folder, but the one which is used is always the "SARscape_default_values_dataset_General.txt".
It is convenient to set a different directory than the one selected in the ENVI "File>Preferences>Directories>Temporary Directory", in order to avoid overwriting the standard SARscape default settings.
| 2) | Interferogram Generation input data and parameters (Input data and parameter definition) |
The input/output data and parameters are entered. In our example they consist of: two input SAR images (*_slc); an input Digital Elevation Model (*_dem); one output root name (*interf*); the parameters relevant to both the azimuth looks (5) and range looks (1).
| 3) | Create the INSARINTERFEROGRAMGENERATION object (Processing functionality creation and validation) |
4) Fill the parameters (Input and output files and processing parameters are set)
5) Verify the parameters (All previous settings are checked, optional but important)
All details relevant to the specific process, which is going to be executed, are reported; in case the instruction is modified using "silent=0" (instead of "silent=1") the details are not shown. In any case, if all previous steps have been properly done, this function provides the code 1 (i.e. ok message); if any mandatory field was missing, this function provides the code 0 (i.e. failure message).
6) Process execution (The process is executed)
If the previous setting was properly done this function provides the code 1 (i.e. ok message) and the processing is successfully executed; otherwise the function provides the code 0 (i.e. failure message).
| 7) | Adaptive Filter and Coherence Generation input data and parameters (Input data and parameter definition) |
The input/output data and parameters are entered. In our example they consist of: three input images (*_interf_Reference_pwr, *_interf_Secondary_pwr, *_interf_dint); one output root name (*newtestInterf*); the parameters relevant to filtering method (GOLDSTEIN) and the Goldstein Win Size (32).
| 8) | Create the INSARFILTERANDCOHERENCE object (Processing functionality creation and validation) |
9) Fill the parameters (Input and output files and processing parameters are set)
10) Verify the parameters (All previous settings are checked, optional but important)
All details relevant to the specific process, which is going to be executed, are reported; in case the instruction is modified using "silent=0" (instead of "silent=1") the details are not shown. In any case, if all previous steps have been properly done, this function provides the code 1 (i.e. ok message); if any mandatory field was missing, this function provides the code 0 (i.e. failure message).
11) Process execution (The process is executed)
If the previous setting was properly done this function provides the code 1 (i.e. ok message) and the processing is successfully executed; otherwise the function provides the code 0 (i.e. failure message).
Section Content
Input Parameter(s)
Refer to the Technical Note.
General Functions
Refer to the IDL help documentation.
Specific Function(s)
Refer to the IDL help documentation.
References
None.