{"_id":"5a39946033fb0d00344df256","project":"55faeacad0e22017005b8265","version":{"_id":"55faeacad0e22017005b8268","project":"55faeacad0e22017005b8265","__v":37,"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","5a96f89c89442e002041144b","5b3f9b7267cbc90003d283a5"],"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":9,"slug":"algorithm-guide","title":"Algorithms"},"user":"55fae9d4825d5f19001fa379","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-12-19T22:36:16.928Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":20,"body":"### Inputs\nThe following table lists all ENVI_BuildMosaicRaster 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`[*]`\nbackground|False|N/A|string|Same parameter as DATA_IGNORE_VALUE, left here for backward compatibility purposes. -- Value Type: DOUBLE\nresampling|False| \"nearest neighbor\"|string|Specify the resampling method.  Nearest Neighbor: Uses the nearest pixel without any interpolation.  Bilinear: Performs a linear interpolation using four pixels to resample, Cubic Convolution: Uses 16 pixels to approximate the sinc function using cubic polynomials to resample the image. -- Value Type: STRING -- Default Value: \"Nearest Neighbor\"\nfeathering_distance|False|N/A|string|Set this property to an array of integers indicating the number of pixels used for edge or seamline feathering for each INPUT_RASTER. The number of elements in this array must match the number of input scenes in the INPUT_RASTERS array. Values must be set to 1 or greater. -- Value Type: INTARRAY\nseamline_method|False| \"none\"|string|Set this property to a string that indicates the method used to automatically generate seamlines. Geometry: Seamline generation that is based on the use of seamline networks by area Voroni diagrams with overlap. None: No Seamline generation. If SEAMLINE_METHOD is set to Geometry, then FEATHERING_METHOD must be set to Seamline. -- Value Type: STRING -- Default Value: \"None\"\ncolor_matching_method|False| \"none\"|string|Set this property to a string that indicates the color matching method to perform. Histogram Matching: Map discrete greyscale levels from the histogram of an adjusted scene to the corresponding greyscale levels in the reference scenes. This helps to minimize the tonal differences across multiple scenes. None: Do not perform color matching. -- Value Type: STRING -- Default Value: \"None\"\ncolor_matching_actions|False|N/A|string|Set this property to an an array of strings that indicates how each element of the INPUT_RASTERS array should be treated with regard to color matching: as a reference image, an adjusted image, or no color matching. The number of elements in this array must match the number of input scenes in the INPUT_RASTERS array. Valid strings are as follows: Adjust: Scenes that will be color-matched to the scene marked as Reference. None: Scenes that will not be color matched. Reference: The scene whose statistics form the basis of color matching for all scenes marked as Adjust. You must set one, and only one, scene to Reference. By default, the first scene in the INPUT_RASTERS array is set to the reference image. -- Value Type: STRINGARRAY\ncolor_matching_statistics|False| \"overlapping area\"|string|Set this property to a string that indicates what parts of the reference and adjusted images are used to compute statistics for color matching, if COLOR_MATCHING_METHOD is set to a value other than None. -- Value Type: STRING -- Default Value: \"Overlapping Area\"\ninput_rasters|True|N/A|[See ENVIRASTERARRAY input type](https://gbdxdocs.digitalglobe.com/docs/envi-task-engine#section-enviraster)|Specify an array of ENVIRasters that comprise the mosaic raster. Each file must have the same number of bands and the same data type. -- Value Type: ENVIRASTERARRAY\ninput_rasters_format|False|N/A|string|Provide the format of the image, for example: landsat-8. -- Value Type: STRING\ninput_rasters_band_grouping|False|N/A|string|Provide the name of the band grouping to be used in the task, ie - panchromatic. -- Value Type: STRING\ninput_rasters_filename|False|N/A|string|Provide the explicit relative raster filename that ENVI will open. This overrides any file lookup in the task runner. -- Value Type: STRING\nfeathering_method|False| \"none\"|string|Set this property to a string that indicates the feathering method to use. None: No feathering. Edge: Edge feathering blends the pixels inside of each footprint boundary with the underlying scenes that are within the feathering distance. Seamline: Seaming feathering blends the pixels on both sides of an auto-generated seamline with the underlying scenes. If this property is set to a value other than None, FEATHERING_DISTANCE must also be specified. -- Value Type: STRING -- Default Value: \"None\"\ndata_ignore_value|False|N/A|string|Specify a unique data value for pixels in the output raster that have a non-zero pixel state value (transparent pixels). -- Value Type: DOUBLE\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_BuildMosaicRaster 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® Build Mosaic Raster](http://www.harrisgeospatial.com/docs/envibuildmosaicrastertask.html). \n\n### Contact\nIf you have any questions or issues with this task, please contact [gbdx-support:::at:::digitalglobe.com](mailto:gbdx-support@digitalglobe.com).","excerpt":"This task builds a mosaic raster based on a set of input rasters.\n    \n**GBDX Registered Name:** ENVI_BuildMosaicRaster\n**Provider:** Harris Geospatial Solutions","slug":"envi-build-mosaic-raster","type":"basic","title":"ENVI® Build Mosaic Raster"}

ENVI® Build Mosaic Raster

This task builds a mosaic raster based on a set of input rasters. **GBDX Registered Name:** ENVI_BuildMosaicRaster **Provider:** Harris Geospatial Solutions

### Inputs The following table lists all ENVI_BuildMosaicRaster 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`[*]` background|False|N/A|string|Same parameter as DATA_IGNORE_VALUE, left here for backward compatibility purposes. -- Value Type: DOUBLE resampling|False| "nearest neighbor"|string|Specify the resampling method. Nearest Neighbor: Uses the nearest pixel without any interpolation. Bilinear: Performs a linear interpolation using four pixels to resample, Cubic Convolution: Uses 16 pixels to approximate the sinc function using cubic polynomials to resample the image. -- Value Type: STRING -- Default Value: "Nearest Neighbor" feathering_distance|False|N/A|string|Set this property to an array of integers indicating the number of pixels used for edge or seamline feathering for each INPUT_RASTER. The number of elements in this array must match the number of input scenes in the INPUT_RASTERS array. Values must be set to 1 or greater. -- Value Type: INTARRAY seamline_method|False| "none"|string|Set this property to a string that indicates the method used to automatically generate seamlines. Geometry: Seamline generation that is based on the use of seamline networks by area Voroni diagrams with overlap. None: No Seamline generation. If SEAMLINE_METHOD is set to Geometry, then FEATHERING_METHOD must be set to Seamline. -- Value Type: STRING -- Default Value: "None" color_matching_method|False| "none"|string|Set this property to a string that indicates the color matching method to perform. Histogram Matching: Map discrete greyscale levels from the histogram of an adjusted scene to the corresponding greyscale levels in the reference scenes. This helps to minimize the tonal differences across multiple scenes. None: Do not perform color matching. -- Value Type: STRING -- Default Value: "None" color_matching_actions|False|N/A|string|Set this property to an an array of strings that indicates how each element of the INPUT_RASTERS array should be treated with regard to color matching: as a reference image, an adjusted image, or no color matching. The number of elements in this array must match the number of input scenes in the INPUT_RASTERS array. Valid strings are as follows: Adjust: Scenes that will be color-matched to the scene marked as Reference. None: Scenes that will not be color matched. Reference: The scene whose statistics form the basis of color matching for all scenes marked as Adjust. You must set one, and only one, scene to Reference. By default, the first scene in the INPUT_RASTERS array is set to the reference image. -- Value Type: STRINGARRAY color_matching_statistics|False| "overlapping area"|string|Set this property to a string that indicates what parts of the reference and adjusted images are used to compute statistics for color matching, if COLOR_MATCHING_METHOD is set to a value other than None. -- Value Type: STRING -- Default Value: "Overlapping Area" input_rasters|True|N/A|[See ENVIRASTERARRAY input type](https://gbdxdocs.digitalglobe.com/docs/envi-task-engine#section-enviraster)|Specify an array of ENVIRasters that comprise the mosaic raster. Each file must have the same number of bands and the same data type. -- Value Type: ENVIRASTERARRAY input_rasters_format|False|N/A|string|Provide the format of the image, for example: landsat-8. -- Value Type: STRING input_rasters_band_grouping|False|N/A|string|Provide the name of the band grouping to be used in the task, ie - panchromatic. -- Value Type: STRING input_rasters_filename|False|N/A|string|Provide the explicit relative raster filename that ENVI will open. This overrides any file lookup in the task runner. -- Value Type: STRING feathering_method|False| "none"|string|Set this property to a string that indicates the feathering method to use. None: No feathering. Edge: Edge feathering blends the pixels inside of each footprint boundary with the underlying scenes that are within the feathering distance. Seamline: Seaming feathering blends the pixels on both sides of an auto-generated seamline with the underlying scenes. If this property is set to a value other than None, FEATHERING_DISTANCE must also be specified. -- Value Type: STRING -- Default Value: "None" data_ignore_value|False|N/A|string|Specify a unique data value for pixels in the output raster that have a non-zero pixel state value (transparent pixels). -- Value Type: DOUBLE 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_BuildMosaicRaster 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® Build Mosaic Raster](http://www.harrisgeospatial.com/docs/envibuildmosaicrastertask.html). ### Contact If you have any questions or issues with this task, please contact [gbdx-support@digitalglobe.com](mailto:gbdx-support@digitalglobe.com).