image splitting

Instructions for Use

The image splitting function supports clipping one or multiple images (multiple images will be mosaicked first) according to the specified clip mode, outputting multiple independent image files. This function is suitable for tasks such as data update and mapping involving multi-region collaboration and is often used together with Datasource Splitting. For example, the latest satellite image of a province can be split into multiple files according to municipal administrative divisions and distributed to municipal units to serve as basemaps for field surveys updating land use data.

When using this function, note the following limitations:

  • Supported image data formats: *.tif, *.tiff, *.img, *.pix.
  • Supported coordinate systems: Geographic coordinate system or projected coordinate system.

Available starting from the SuperMap iDesktopX 2026 version.

Parameter Description

Parameter Name Parameter Interpretation Parameter Type
Source Data

Specifies the image data to be split. Manage image files using the Add Image, Select All, Select Reverse, and Delete functions.

  • Add Image: Supports adding images in four ways: Add File, Add Folder, Add List, Add Dataset. Supported formats are *.tiff, *.tif, *.img, *.pix.
    • Add File: Select specific image files from a local directory.
    • Add Folder: Select a folder from a local directory. All images within that folder and its subfolders will be automatically retrieved.
    • Add List: Select a manifest file (*.csv) from a local directory. Images to be split will be retrieved based on the image names and path information in the file.
    • Add Dataset: Select a mosaic dataset from a datasource that is currently open in the workspace as the image to be split.
  • Select All: Select all records in the list.
  • Select Reverse: Inversely select all records in the list.
  • Delete: Delete the selected records from the list.
 DatasetImage
Output Format

Sets the method for image splitting. Provides the following options:

  • Vector Clipping (Default): Clips the image according to the extent of each object within a region dataset.
  • Standard Map Sheet: Outputs the image as standard map sheets based on the specified Standard Type, Reference Scale, and Expand Range.
 ImagesExportType
Datasource

Available when Output Format is set to Vector Clipping.

Sets the datasource containing the clip dataset.

 DatasetSource
Dataset

Available when Output Format is set to Vector Clipping.

Sets the region dataset used to define the clip bounds. Each polygon object in this dataset will serve as an independent clipping bound to generate one result datasource.

 DatasetVector
Clip Field

Available when Output Format is set to Vector Clipping.

Specifies the field used to name the result image. After splitting, each resulting image file will be named according to the value in this field.

 String
Standard Type

Available when Output Format is set to Standard Map Sheet.

Sets the type of standard map sheet. Provides National Standard and Military Standard. Default is National Standard.

 FrameStandardType
Reference Scale

Available when Output Format is set to Standard Map Sheet.

Specifies the scale of the standard map sheet. Default is 1:2000 (1:2 thousand). Also provides eight basic scales as options.

 FrameScaleType
Expand Range Specifies the outward extension range from the clip data. Default value is 100, unit is m. The system first calculates the extended area based on this value, then uses this area to clip the image. Integer
Feather Width Sets the blur range at the image mosaic seams. Default value is 0, unit is px. Integer
NoData Value

Specifies the pixel value for areas without valid data in the output image. After adding the image(s) to be clipped, the default value automatically retrieves the NoData value from the image(s):

  • Single image: Uses the NoData value of that image.
  • Multiple images: Uses the NoData value of the first image.
  • Multiband: Uses the NoData value of the first band.
 Double
Output Format Specifies the file format for the output image. Provides options: Tiff/GeoTIFF, Erdas Image. Default is Tiff/GeoTIFF. FileType
Export Directory

Specifies the local folder for storing results. The naming rules for result image files are as follows:

  • Vector clipping: Each result image is named after the value in the Clip Field of the corresponding polygon object, e.g., Beijing City.tiff.
  • Standard map sheet: Each result image is named after the sheet number of the standard map sheet, e.g., H48G001002.tiff.
  • Duplicate name handling: If multiple output objects have the same name, the system automatically appends a "_n" suffix to subsequent files for distinction, e.g., Region A.tiff, Region A_1.tiff, Region A_2.tiff.
 String

Output Result

Multiple independent image files generated after splitting.