Feature Description
Image color balancing is an image preprocessing technique designed to eliminate tonal inconsistencies caused by differences in shooting seasons, sensor variations, or weather conditions by adjusting the color, brightness, and contrast of multiple images participating in a mosaic, thereby achieving a color-uniform and visually coordinated DOM tessellation result.
Image color balancing maps and matches the statistical features (such as mean and variance) of the images to be processed to a reference standard through mathematical transformation, achieving consistent adjustment of color features between images. Its main methods include:
- Template color balancing: Adjusts the color distribution of the images to be processed to be similar to the template based on a specified reference image with good color performance.
- Adaptive Color Uniformity: No template is required. The algorithm automatically analyzes the global and local color statistics of all mosaic images, obtains an optimized color balance target through adaptive calculation, and processes each image to achieve overall tonal balance.
Image color balancing is generally applied in the following scenarios:
- DOM production and mosaicking: Color balancing is an essential step before seamless mosaicking of multiple orthophotos, effectively improving the professionalism and visual effect of the result map.
- Multi-temporal image comparison analysis: When comparing images of the same area taken at different times, color balancing can reduce color interference caused by illumination and seasonal changes, making ground object changes easier to identify.
When using image color balancing, the following issues should be noted:
- Supported data formats: *.tiff, *.tif, *.img, *.pix.
- Input image recommendation: 8-bit depth, 3-band (red, green, blue) true color image for optimal processing results.
- Please create an image production workflow first before using this function.
![]() |
![]() |
![]() |
| Figure: Original image | Figure: Color balancing template | Figure: Color balance result |
Parameter description
| Parameter Name | Parameter Interpretation | Parameter Type |
| Data Type |
This parameter is available only when the function is launched from the Satellite Image processing tab -> DOM Data Production group -> Image Color Balancing. Select the source of input image data. Provides the following options:
|
|
| Image Files |
This parameter is available only when the function is launched from the Satellite Image processing tab -> DOM Data Production group -> Image Color Balancing and Data Type is set to Image Files. Set the local path storing image files. After selection, all images in the specified path and its sub-paths that meet the format requirements will be color balanced. |
File |
| Image Data Source |
This parameter is available only when the function is launched from the Satellite Image processing tab -> DOM Data Production group -> Image Color Balancing and Data Type is set to Mosaic Dataset. Specify the data source where the image dataset resides. |
Datasource |
| Image Data |
This parameter is available only when Data Type is set to Mosaic Dataset. In production workflow, only the dataset is displayed and cannot be edited. Specify the mosaic dataset used for color balancing. |
DatasetMosaic |
| Color Balancing Mode |
Select the color balancing processing mode. Provides the following options:
|
DesktopColorBalanceType |
| Color Balancing Template |
This parameter is available only when Color Balancing Mode is set to Template color balancing. Specify a local image file as the color reference template. The system will adjust the images to be processed based on this template, making their colors consistent or highly similar to the template. When the image to be processed is single-band, only 8-bit unsigned template data is supported for input. |
File |
| Color Balancing Method |
This parameter is available only when Color Balancing Mode is set to Template color balancing. Select the specific algorithm for template color balancing. Provides the following options:
|
ColorBalanceMethod |
| Block Size |
Set the block size for color balancing processing. The smaller the block, the finer the color balancing, but the longer the processing time. Provides the following options:
|
BlockSizeOption |
| Red Band Index | Specify the index number representing the red channel in the image. Default value is 0. | Integer |
| Green Band Index | Specify the index number representing the green channel in the image. Default value is 1. | Integer |
| Blue Band Index | Specify the index number representing the blue channel in the image. Default value is 2. | Integer |
| Brightness |
Adjust the brightness of the result image. The value range is [-100, 100], with a default of 0.0. The larger the value, the higher the brightness of the result image. |
Double |
| Contrast |
Adjust the contrast of the result image. The value range is [-100, 100], with a default of 0.0. The larger the value, the stronger the contrast of the result image. |
Double |
| Saturation |
Adjust the saturation of the result image. The value range is [-100, 100], with a default of 0.0. The larger the value, the stronger the saturation of the result image. |
Double |
| Mask Data | Not checked by default. If checked, a polygon vector dataset can be set as a mask. The system will exclude pixels within this area during color balancing calculation and output. | Boolean |
| Data Source |
This parameter is available only when Mask Data is checked. Not provided when executing a production workflow. Specify the data source where the mask dataset resides. |
DataSource |
| Dataset |
This parameter is available only when Mask Data is checked. When executing a production workflow, it uses the mask data from True Color Output by default. Specify the vector surface dataset used as the mask. The dataset must contain an ImageName field, and the name must correspond to the name of the image currently being processed. |
DatasetVector |
| Color Balancing Preview | Not checked by default. When checked, before executing the workflow or running the tool independently, it will pause and generate a color balancing preview image based on the set preview resolution for preview in a dedicated window. | Boolean |
| Color Balancing Resolution |
Set the resolution used for the color balancing preview. Lower resolution (larger downsampling factor) preview is smoother but blurrier; higher resolution (smaller downsampling factor) preview refreshes slower but is clearer. This setting only affects the preview and does not affect the quality of the final output result. The available options are as follows:
|
OrthoRatioDecreaseMethod |
| Export Directory |
Set the storage path for the result image after color balancing. If executing a production workflow, use the Processing path parameter in Set Image Path or Add orthophoto, and it cannot be edited. |
File |
| Resampling Method |
Specify the resampling method used during the image processing. Three options are provided: Nearest, Bilinear, Cubic, with a default of Bilinear. For more method descriptions, refer to Resampling Method. |
ResampleMethod |
| Result Minimum Value | Set the minimum pixel value in the result image. Default value is 1. | Integer |
| Result Maximum Value | Set the maximum pixel value in the result image. Default value is 255. | Integer |
| NoData Value | Set the pixel value for NoData areas in the result image. Default value is 0.0. | Double |
| Resolution Type |
Specify the method for setting the output image resolution. Provides the following options:
|
OrthoRatioType |
| Output Format |
Set the storage format of the result image. Provides the following options:
If executing a production workflow, use the Output format parameter in Set Image Path or Add orthophoto, and it cannot be edited. |
FileType |
| Compression Method |
When Output Format is Tiff/GeoTIFF, set the compression method for the output image. Four options are provided: NONE, DEFLATE, LZW, JPEG, with a default of NONE. For more method descriptions, refer to Compression method. If executing a production workflow, use the Compression method parameter in Set Image Path or Add orthophoto, and it cannot be edited. |
CompressMethod |
| Output as Original Image Coordinate |
If checked, the result data will use the same image coordinate system as the input data. If not checked, use the Output coordinate system parameter in Set Image Path or Add orthophoto, and it cannot be edited. |
Boolean |
| Add Results to Map Window |
This parameter is available only when the function is launched from the Imagery tab -> DOM Data Production group -> Image Color Balancing. Checked by default. After successful execution, the result data is automatically added to the current map window for display. |
Boolean |
| Create Image Pyramid |
Checked by default. Image pyramids will be built for the output image data, thereby improving the zoom browsing speed and display performance of large volume images. If executing a production workflow, use the Create Image Pyramid parameter in Set Image Path or Add orthophoto, and this parameter will not be displayed. |
Boolean |
| Resampling Method |
This parameter is available only when Create Image Pyramid is checked. Specify the resampling method used when creating image pyramids. Provides NONE, Average, Nearest Neighbor, Gaussian Kernel, with a default of Average. For more method descriptions, refer to Resampling Method. If executing a production workflow, use the Resampling Method parameter in Set Image Path or Add orthophoto, and this parameter will not be displayed. |
ResamplingMethod |
| Asynchronously Create Statistics |
Image statistics are used to optimize the stretch effect during display. If the image has no statistics, the image will be displayed using the default stretch method, and 8-bit data will not be stretched.
If executing a production workflow, use the Asynchronously create statistics parameter in Set Image Path or Add orthophoto, and this parameter will not be displayed. |
Boolean |
Output Result
- Output the color balanced image data to a local folder.
- Automatically create an image color balancing mosaic dataset in the OrthoData data source based on the output image data.
Related Topics


