Iteration Object

Instructions for use

Iterate through each record in the dataset to process records individually. Supports iteration by grouping fields and filtering target records through attribute conditions. The iteration results are output to memory and can be connected to tools such as [Buffer Analysis] or [Export to SHP] for subsequent analysis or directly written to local storage or databases.

Application Scenarios

  • Land Use Dynamic Monitoring: Input land change survey datasets, add "Land Category Code" and "Change Year" as grouping fields, set attribute filter condition to "Change Area > 5000" to extract major annual change patches for different land categories, and connect to the buffer analysis tool to generate ecological redline warning zones.

  • Forest Resource Zonal Statistics: For forest resource inventory data, use "Compartment ID" and "Dominant Tree Species" as grouping fields, filter mature stands with "Canopy Density ≥ 0.6", and connect to the data export tool to output distribution data for dominant tree species in each zone.

Parameter Description

Parameter Name Description Parameter Type
Source Dataset Input vector dataset to be processed (supports point/line/polygon types). DatasetVector
Group Fields (Optional) Specify field names for grouping. Objects with the same field values are grouped into one result dataset. Supports single or multiple fields. Defaults to "SmID" for grouping if no fields are specified. String
Attribute Filter (Optional) Set attribute conditions to filter target records. Supported operators:
1. Comparison: =, !=, >, <, >=, <= with numeric values or field names;
2. Wildcard: LIKE/NOT LIKE with % or _;
3. Null Check: "Is Null/Not Null" (no value required).
AttributeFilter

Output Result

Parameter Name Description Parameter Type
Object Collection Collection of records meeting grouping and filtering conditions. Named as "DatasetName_GroupValue1_GroupValue2...". DatasetVector

Notes

  1. Starting from SuperMap 2025, the tool has added the ability to group fields and filter attribute conditions. The iteration results have been changed from outputting to a specified data source to outputting to memory.