Feature Description
Due to factors such as weather conditions, human factors, and sensor characteristics, acquired remote sensing imagery often exhibits inconsistencies in color and brightness. These issues not only lead to errors during image mosaicking but also result in noticeable color differences along the seam lines of the mosaic, severely affecting the visual quality and usability of the final image.
Image color balancing effectively reduces tonal differences between images by adjusting their color, brightness, and contrast. It achieves uniform tonality, moderate contrast, and distinct layering while preserving authentic feature colors, significantly enhancing overall image quality and visual consistency.
SuperMap ImageX Pro Supported since version 11i(2023).
![]() |
![]() |
![]() |
Figure: Original Image | Figure: Color Balancing Template | Figure: Color Balance Result |
Feature Entry
- Imagery Tab->DOM Data Production Group->Image Color Balancing
- DOM Automated Processing Flow/Ortho Data DOM Automated Processing Process Window->Image Color Balancing Node.
Parameter Description
Parameter Name | Description | Type |
Data Type |
Available only when launched from Imagery Tab->DOM Data Production Group->Image Color Balancing. Specifies the source of input image data with two options: Image Files and Mosaic Dataset. Default is Image Files. |
|
Image Files |
Available only when launched from Imagery Tab->DOM Data Production Group->Image Color Balancing. When Data Type is set to Image Files, directly input local path information to automatically acquire all images under the path. |
File |
Image Data Source |
Available only when launched from Imagery Tab->DOM Data Production Group->True Color Output. When Data Type is set to Mosaic Dataset, specifies the datasource containing the image dataset. |
Datasource |
Image Data | When Data Type is set to Mosaic Dataset, specifies the image dataset. Display-only and non-editable in workflow production. | DatasetMosaic |
Color Balancing Method |
Provides two methods: Template-based Color Balancing and Adaptive Color Uniformity.
|
|
Color Balancing Template |
Available when Color Balancing Method is set to Template-based Color Balancing. Specifies local image files as templates to adjust color features of target images, ensuring color consistency with the template. |
File |
Color Balancing Method |
Available when Color Balancing Method is set to Template-based Color Balancing. Default is Uniform Illumination and Color.
|
ColorBalanceMethod |
Block Size | Default is 1024*1024. Smaller blocks yield better results but require longer processing time. | BlockSizeOption |
Red Band Index | Sets red band, default is 0. | Integer |
Green Band Index | Sets green band, default is 1. | Integer |
Blue Band Index | Sets blue band, default is 2. | Integer |
Brightness | Adjusts brightness of result image. Range: [-100,100], default: 0.0. Higher values increase brightness. | Double |
Contrast | Adjusts contrast of result image. Range: [-100,100], default: 0.0. Higher values enhance contrast. | Double |
Saturation | Adjusts saturation of result image. Range: [-100,100], default: 0.0. Higher values increase saturation. | Double |
Mask Data Source | Specifies the datasource containing mask dataset. | DataSource |
Dataset | Default is empty (mask disabled). When set, color balancing will avoid the dataset bounds. | DatasetVector |
Color Balancing Preview | Default unchecked (no preview). When checked, process execution pauses and outputs preview based on Preview Resolution. | Boolean |
Preview Resolution |
Available when Color Balancing Preview is checked. Sets preview resolution, default: 4x Downsampling (1/4 of original resolution). Use Preview button to view results. |
OrthoRatioDecreaseMethod |
Export Directory |
Sets storage path for result images.
For DOM automated processing flow, uses Processing Path parameter from Set Image Path, non-editable. For Ortho data DOM process, uses Processing Path from Add Orthophoto, non-editable.
|
File |
Resampling Method | Sets image resampling method: Nearest, Bilinear, Cubic. Default: Bilinear. See Resampling Method. | ResampleMethod |
Result Minimum Value | Sets minimum pixel value for result image, default: 1. | Integer |
Result Maximum Value | Sets maximum pixel value for result image, default: 255. | Integer |
NoData Value | Sets pixel value for NoData areas, default: 0.0. | Double |
Resolution Type |
Specifies output image resolution method. Default: Original Resolution.
|
OrthoRatioType |
Output Format |
Sets result image format: Unspecified, Tiff/GeoTIFF, Erdas Image, PCIDSK. Default: Tiff/GeoTIFF (original format). For workflows, uses parameters from Set Image Path or Add Orthophoto, non-editable. |
FileType |
Compression Method |
Sets compression method for TIFF/GeoTIFF output. Default: NONE. Uses parameters from workflow settings, non-editable. |
CompressMethod |
Output as Original Image Coordinate | When checked, uses input data's coordinate system. Otherwise follows workflow settings. | Boolean |
Add Results to Map Window |
Available only when launched from Imagery Tab->DOM Data Production Group->Image Color Balancing. Default checked (displays results in map window after successful execution). |
Boolean |
Create Image Pyramid | Default checked. Builds pyramids using specified resampling method to improve rendering performance. | Boolean |
Resampling Method | Available when Create Image Pyramid is checked. Default: Average. See Resampling Method. | ResamplingMethod |
Asynchronously Create Statistics | Default checked (creates statistics in background without delaying workflow). Unchecking creates statistics during tool execution (may take longer). | Boolean |
Output
- Outputs color-balanced images to local folders.
- Automatically creates color-balanced mosaic dataset in OrthoData datasource.
Related Topics