Join Features

Join Features can append attributes from one dataset to another based on spatial, temporal, attribute relationships, or their combinations. The datasets can be spatial data or attribute tables. This tool first identifies all input features that meet the specified join conditions, then appends matching features from the join dataset to the source dataset.

The Join Features tool transfers and appends information from one layer to another. Features can be joined based on spatial, attribute, temporal relationships, or combinations of these criteria.

Spatial Relationships

Determines spatial relationships between features. Available relationships depend on the geometry types (point, line, or polygon) of the layers being joined. Supported spatial relationships include: Adjacent, Contain, Within, Cross, Intersect, Overlap, Touch, Disjoint, Identity. For details, refer to Spatial Query Operators.

Spatial Relationship Diagram Description
Adjacent Features meet the condition when the join feature is within the specified distance radius from the source feature.
Contain The source feature completely contains the join feature.
Within The source feature is completely contained by the join feature.
Cross The source feature crosses the join feature.
Overlap Features of the same geometry type (point, line, or polygon) overlap.
Intersect The source feature intersects with the join feature.
Touch Features share common points or edges.
Disjoint Features have no spatial intersection.
Identity Features of the same geometry type coincide completely.

Temporal Relationships

Temporal Relationship Diagram Description
Near Source time is considered near join time when within a specified temporal range.
After Source time occurs after join time within a specified interval.
Before Source time occurs before join time within a specified interval.
Contain Source time interval contains the join time.
During Source time occurs within the join time interval.
Finish Source time ends simultaneously with join time but starts later.
Finishedby Source time ends simultaneously with join time but starts earlier.
Meet Source time starts with join time and ends before join time interval.
Metby Source time starts with join time and extends beyond join time interval.
Overlap Source time starts before and ends during join time interval.
Overlapedby Source time starts during and ends after join time interval.
Start Source time starts with join time and ends earlier.
Startedby Source time starts with join time and ends later.
Equal Two time intervals have identical start and end points.

Application Scenarios

  • Analyze fund transaction flows and calculate total amounts transferred to the same account within specified periods.
  • Append district information (school zones, police precincts, communities) to crime incidents for impact analysis across different administrative areas using Join Features.

Feature Entry

  • Online Tab -> Analysis Group -> Join Features.

Steps

  1. iServer Address: Select iServer address and login credentials from dropdown. For details, see Data Input.
  2. Source Dataset: The target dataset to receive joined attributes. Select from dropdown. See Data Input for configuration details.
  3. Join Dataset: Required. The dataset providing attributes to append. Supports point, line, and polygon datasets. See Data Input for configuration.
  4. Analysis Settings:
    • Join Type: Required. Defines how source features match with join features:
      • One-to-One: Updates source features with attributes from the first matching join feature. If multiple matches exist, only counts are recorded.
      • One-to-Many: Preserves all matching join features in result dataset. E.g., a source feature matching five join features will generate five output records.   
    • Join Field: Field from join dataset used for feature matching.
  5. Feature Association Methods: Join features using spatial, temporal, attribute relationships, or combinations:
    • Spatial Feature Join: Define spatial relationships based on geometry types (Adjacent, Contain, Within, etc.).
    • Time Feature Join: Define temporal relationships (moment or interval). See temporal relationships above.
      • Time Step Unit: Required. Units include seconds, milliseconds, minutes, hours, days, weeks, months, years (default: seconds).
    • Property Feature Join: Match features where specified field values are equal (or not equal) between datasets.
  6. Attribute Statistics Field: Calculate statistics (max, min, average, sum, variance, standard deviation) for selected fields. Multiple fields require corresponding statistical modes.
  7. Statistical Mode: Select statistical method(s) from dropdown.
  8. Tolerance: Applies to "Adjacent" spatial relationships. E.g., with 100m distance and tolerance=1m, features within 99-101m are matched.
  9. After parameter setup, execute Join Features. Results will auto-display on map. The output window shows workspace path for result dataset. Note: Directly opening results from iServer may fail due to locked files. Copy data to another location for editing.

Related Topics

Environment Configuration

Data Preparation