Feature Description
Iterates through each record in the dataset for processing records one by one. Supports iteration by grouping fields and filtering target records through attribute conditions. The iteration result will be output to memory and can be connected to tools like 【Buffer Analysis】 and 【Export to SHP】 for subsequent analysis or directly written to local storage or a database.
Application Scenarios
Land Use Dynamic Monitoring: Input the land change survey dataset, add "Land Type Code" and "Change Year" as group fields, set the attribute filter criteria to "Change Area > 5000", extract major change patches for different land types in each year, and connect to the buffer analysis tool to generate ecological redline warning areas.
Forest Resource Zonal Statistics: For forest resource class II survey data, use "Compartment Number" and "Dominant Tree Species" as group fields, filter mature forest stands by "Canopy Density ≥ 0.6", and connect to the data export tool to output dominant tree species distribution data for each zone.
Parameter Description
| Parameter Name | Parameter Interpretation | Parameter Type |
|---|---|---|
| Source Dataset | Input the vector dataset to be processed, supporting point/line/region types. | DatasetVector |
| Group Field (Optional) | Specify the grouping field. Objects with the same field value will be grouped and output to one result dataset. You can specify one or more fields for iteration based on unique combinations of field values. If no field is specified, the "SmID" field is used by default for single-field grouping. | String |
| Attribute Filter Criteria (Optional) | Set the target field, fill in the attribute value according to the selected operator type to match the attribute value of the target field, and retain objects that meet the condition. Supports the following types of operators: 1. Comparison Operators: Supports =, !=, >, <, >=, <=. The attribute value should be a specific numeric value or a field name (when a field name is entered, it compares the specified field's value with the target field's attribute value). 2. Wildcard Matching: Supports LIKE / NOT LIKE operators. The attribute value supports using the wildcard % (matches any number of characters) or _ (matches a single character). 3. Null Value Check: Select the "Field is NULL / NOT NULL" operator; no attribute value needs to be filled. |
AttributeFilter |
Output Result
| Parameter Name | Parameter Interpretation | Parameter Type |
|---|---|---|
| Object Collection | The collection of records that satisfy the field grouping and attribute filter criteria. The naming format is "dataset name_value of group field1_value of group field2". | DatasetVector |
Notes
- Feature Changes: Starting from SuperMap 2025, this tool has added the capability for grouping by fields and filtering by attribute conditions. The iteration result is now output to memory instead of a specified datasource.