{"_id":"5a3a84b49fb104001ecd612b","project":"55faeacad0e22017005b8265","version":{"_id":"55faeacad0e22017005b8268","project":"55faeacad0e22017005b8265","__v":35,"createdAt":"2015-09-17T16:31:06.800Z","releaseDate":"2015-09-17T16:31:06.800Z","categories":["55faeacbd0e22017005b8269","55faf550764f50210095078e","55faf5b5626c341700fd9e96","55faf8a7825d5f19001fa386","560052f91503430d007cc88f","560054f73aa0520d00da0b1a","56005aaf6932a00d00ba7c62","56005c273aa0520d00da0b3f","5601ae7681a9670d006d164d","5601ae926811d00d00ceb487","5601aeb064866b1900f4768d","5601aee850ee460d0002224c","5601afa02499c119000faf19","5601afd381a9670d006d1652","561d4c78281aec0d00eb27b6","561d588d8ca8b90d00210219","563a5f934cc3621900ac278c","5665c5763889610d0008a29e","566710a36819320d000c2e93","56ddf6df8a5ae10e008e3926","56e1c96b2506700e00de6e83","56e1ccc4e416450e00b9e48c","56e1ccdfe63f910e00e59870","56e1cd10bc46be0e002af26a","56e1cd21e416450e00b9e48e","56e3139a51857d0e008e77be","573b4f62ef164e2900a2b881","57c9d1335fd8ca0e006308ed","57e2bd9d1e7b7220000d7fa5","57f2b992ac30911900c7c2b6","58adb5c275df0f1b001ed59b","58c81b5c6dc7140f003c3c46","595412446ed4d9001b3e7b37","59e76ce41938310028037295","5a009de510890d001c2aabfe"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"v1","version_clean":"1.0.0","version":"1"},"category":{"_id":"573b4f62ef164e2900a2b881","__v":0,"project":"55faeacad0e22017005b8265","version":"55faeacad0e22017005b8268","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-05-17T17:05:38.443Z","from_sync":false,"order":8,"slug":"algorithm-guide","title":"Algorithms"},"user":"55fae9d4825d5f19001fa379","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-12-20T15:41:40.219Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":45,"body":"### Inputs\nThe following table lists all ENVI_ForwardICATransform inputs.\nMandatory (optional) settings are listed as Required = True (Required = False).\n\n  Name  |  Required  |  Default  |  Valid Values  |  Description  \n--------|:----------:|-----------|----------------|---------------\nfile_types|False|N/A|string|GBDX Option. Comma seperated list of permitted file type extensions. Use this to filter input files -- Value Type: STRING`[*]`\ninput_raster|True|N/A|[See ENVIRASTER input type](https://gbdxdocs.digitalglobe.com/docs/envi-task-engine#section-enviraster)|Specify a raster on which to perform an ICA transform. -- Value Type: ENVIRASTER\ninput_raster_format|False|N/A|[See ENVIRASTER input type](https://gbdxdocs.digitalglobe.com/docs/envi-task-engine#section-enviraster)|Provide the format of the image, for example: landsat-8. -- Value Type: STRING\ninput_raster_band_grouping|False|N/A|[See ENVIRASTER input type](https://gbdxdocs.digitalglobe.com/docs/envi-task-engine#section-enviraster)|Provide the name of the band grouping to be used in the task, ie - panchromatic. -- Value Type: STRING\ninput_raster_filename|False|N/A|[See ENVIRASTER input type](https://gbdxdocs.digitalglobe.com/docs/envi-task-engine#section-enviraster)|Provide the explicit relative raster filename that ENVI will open. This overrides any file lookup in the task runner. -- Value Type: STRING\ncoefficient|False| 1.0|string|Specify the coefficient to use.  Specify COEFFICIENT only when using the 'LogCosh' or 'Gaussian' option for CONTRAST_FUNCTION. -- Value Type: FLOAT -- Default Value: 1.0\nmaximum_iterations|False| 100|string|Specify the maximum number of iterations to perform for IC optimization using a fixed-point algorithm. The minimum value is 100, and the maximum value is 32767. More iterations will help find more optimal components; however, each iteration adds to processing time depending on the CUP and system load. -- Value Type: INT -- Default Value: 100\nmaximum_stabilization_iterations|False| 100|string|Specify the maximum number of iterations to perform for IC optimization using a stabilized fixed-point algorithm. When estimating one IC, the fixed-point algorithm runs first. If the algorithm does not converge after the maximum number of iterations, the stabilized fixed-point algorithm runs to improve convergence. The minimum value is 0 and the maximum value is 32767. Enabling stabilization and increasing stabilization iterations will help find more optimal components; however, each iteration adds to processing time depending on the CUP and system load. -- Value Type: UINT -- Default Value: 100\nchange_threshold|False| 9.999999747378752e-05|string|Specify a floating-point value used to optimize independent component (IC) analysis. If the change of the IC is less than this value, then the IC iteration stops. The allowable range is 0.00000001 to 0.1. Increasing the value increases the speed of convergence but may provide a less optimal solution. -- Value Type: FLOAT -- Default Value: 9.999999747378752e-05\nsort_output|False| true|string|Set this property to sort output ICA bands by decreasing spatial coherence. -- Value Type: BOOLEAN -- Default Value: true\ncontrast_function|False| \"logcosh\"|string|Specify the contrast function. -- Value Type: STRING -- Default Value: \"LogCosh\"\nsampling_percent|False| 10.0|string|Specify a floating-point percentage (0 to 100) for sub-sampling the data when calculating the IC transform. Sub-sampling reduces the IC sample size to fit into memory and increases computation speed.  The default setting of 100 does not change the data. For example, a sampling percentage of 50 will use every other pixel in the statistics calculations and the IC sample. Setting this value too low could lose features of interest, as those pixels may be discarded. -- Value Type: DOUBLE -- Default Value: 10.0\noutput_raster_uri_filename|False|N/A|string|Specify a string with the fully-qualified path and filename for OUTPUT_RASTER. -- Value Type: STRING\n\n\n### Outputs\n\nThe following table lists all ENVI_ForwardICATransform outputs.\nMandatory (optional) settings are listed as Required = True (Required = False).\n\n  Name  |  Required  |  Default  |  Valid Values  |  Description\n--------|:----------:|-----------|----------------|---------------\ntask_meta_data|False|N/A|directory|GBDX Option. Output location for task meta data such as execution log and output JSON\noutput_raster_uri|True|N/A|directory|Output for OUTPUT_RASTER. -- Value Type: ENVIURI\n\n\n**Output structure**\n\nThe output_raster_uri file will be written to the specified S3 Customer Account Location.\n\n### Background\nFor additional background information on this task please refer to the [Harris Geospatial ENVI documentation](http://www.harrisgeospatial.com/docs/home.html) and \n[ENVI® Forward ICATransform](http://www.harrisgeospatial.com/docs/enviforwardicatransformtask.html). \n\n### Contact\nIf you have any questions or issues with this task, please contact [gbdx-support:::at:::digitalglobe.com](gbdx-support@digitalglobe.com).","excerpt":"This task performs an independent component analysis (ICA) procedure to transform a set of mixed, random signals into components that are mutually independent.\n    \n**GBDX Registered Name:** ENVI_ForwardICATransform\n**Provider:** Harris Geospatial Solutions","slug":"envi-forward-icatransform","type":"basic","title":"ENVI® Forward ICATransform"}

ENVI® Forward ICATransform

This task performs an independent component analysis (ICA) procedure to transform a set of mixed, random signals into components that are mutually independent. **GBDX Registered Name:** ENVI_ForwardICATransform **Provider:** Harris Geospatial Solutions

### Inputs The following table lists all ENVI_ForwardICATransform inputs. Mandatory (optional) settings are listed as Required = True (Required = False). Name | Required | Default | Valid Values | Description --------|:----------:|-----------|----------------|--------------- file_types|False|N/A|string|GBDX Option. Comma seperated list of permitted file type extensions. Use this to filter input files -- Value Type: STRING`[*]` input_raster|True|N/A|[See ENVIRASTER input type](https://gbdxdocs.digitalglobe.com/docs/envi-task-engine#section-enviraster)|Specify a raster on which to perform an ICA transform. -- Value Type: ENVIRASTER input_raster_format|False|N/A|[See ENVIRASTER input type](https://gbdxdocs.digitalglobe.com/docs/envi-task-engine#section-enviraster)|Provide the format of the image, for example: landsat-8. -- Value Type: STRING input_raster_band_grouping|False|N/A|[See ENVIRASTER input type](https://gbdxdocs.digitalglobe.com/docs/envi-task-engine#section-enviraster)|Provide the name of the band grouping to be used in the task, ie - panchromatic. -- Value Type: STRING input_raster_filename|False|N/A|[See ENVIRASTER input type](https://gbdxdocs.digitalglobe.com/docs/envi-task-engine#section-enviraster)|Provide the explicit relative raster filename that ENVI will open. This overrides any file lookup in the task runner. -- Value Type: STRING coefficient|False| 1.0|string|Specify the coefficient to use. Specify COEFFICIENT only when using the 'LogCosh' or 'Gaussian' option for CONTRAST_FUNCTION. -- Value Type: FLOAT -- Default Value: 1.0 maximum_iterations|False| 100|string|Specify the maximum number of iterations to perform for IC optimization using a fixed-point algorithm. The minimum value is 100, and the maximum value is 32767. More iterations will help find more optimal components; however, each iteration adds to processing time depending on the CUP and system load. -- Value Type: INT -- Default Value: 100 maximum_stabilization_iterations|False| 100|string|Specify the maximum number of iterations to perform for IC optimization using a stabilized fixed-point algorithm. When estimating one IC, the fixed-point algorithm runs first. If the algorithm does not converge after the maximum number of iterations, the stabilized fixed-point algorithm runs to improve convergence. The minimum value is 0 and the maximum value is 32767. Enabling stabilization and increasing stabilization iterations will help find more optimal components; however, each iteration adds to processing time depending on the CUP and system load. -- Value Type: UINT -- Default Value: 100 change_threshold|False| 9.999999747378752e-05|string|Specify a floating-point value used to optimize independent component (IC) analysis. If the change of the IC is less than this value, then the IC iteration stops. The allowable range is 0.00000001 to 0.1. Increasing the value increases the speed of convergence but may provide a less optimal solution. -- Value Type: FLOAT -- Default Value: 9.999999747378752e-05 sort_output|False| true|string|Set this property to sort output ICA bands by decreasing spatial coherence. -- Value Type: BOOLEAN -- Default Value: true contrast_function|False| "logcosh"|string|Specify the contrast function. -- Value Type: STRING -- Default Value: "LogCosh" sampling_percent|False| 10.0|string|Specify a floating-point percentage (0 to 100) for sub-sampling the data when calculating the IC transform. Sub-sampling reduces the IC sample size to fit into memory and increases computation speed. The default setting of 100 does not change the data. For example, a sampling percentage of 50 will use every other pixel in the statistics calculations and the IC sample. Setting this value too low could lose features of interest, as those pixels may be discarded. -- Value Type: DOUBLE -- Default Value: 10.0 output_raster_uri_filename|False|N/A|string|Specify a string with the fully-qualified path and filename for OUTPUT_RASTER. -- Value Type: STRING ### Outputs The following table lists all ENVI_ForwardICATransform outputs. Mandatory (optional) settings are listed as Required = True (Required = False). Name | Required | Default | Valid Values | Description --------|:----------:|-----------|----------------|--------------- task_meta_data|False|N/A|directory|GBDX Option. Output location for task meta data such as execution log and output JSON output_raster_uri|True|N/A|directory|Output for OUTPUT_RASTER. -- Value Type: ENVIURI **Output structure** The output_raster_uri file will be written to the specified S3 Customer Account Location. ### Background For additional background information on this task please refer to the [Harris Geospatial ENVI documentation](http://www.harrisgeospatial.com/docs/home.html) and [ENVI® Forward ICATransform](http://www.harrisgeospatial.com/docs/enviforwardicatransformtask.html). ### Contact If you have any questions or issues with this task, please contact [gbdx-support@digitalglobe.com](gbdx-support@digitalglobe.com).