The Join Features tool transfers attributes from one layer or table to another based on spatial, temporal, and attribute relationships or some combination of the three. Optionally, statistics can be calculated for the joined features.
Workflow diagram
Examples
An analyst has crime data throughout their city. To analyze and study the impact of these crimes, the analyst needs to understand the relationship that the crime locations have with the various city jurisdictions such as school districts, police beats, neighborhoods, and so on. By using the Join Features tool, additional information about each location can be appended to each crime, and the impact on various jurisdictions can be further studied and analyzed.
Tip:
If your portal is configured to use Living Atlas content, you can use the state and county Living Atlas layers, which include population data that can be joined to your crime data.
Usage notes
The Join Features tool is designed to transfer and append information from one layer to another. The information that is transferred is based on the type of spatial relationship defined, the temporal relationship defined, a common attribute that is shared between the two datasets, or some combination of the three.
When joining features, you can join features based on a spatial relationship, a temporal relationship, an attribute relationship, or a combination of the three.
| Options | Description |
|---|---|
| The spatial relationship that will determine if features are joined to each other. The available relationships depend on the geometry type (point, line, or area) of the layers being joined. Available spatial relationships are as follows:
|
| The temporal relationship that will determine if features are joined to each other. The available relationships depend on the time type (instant or interval) of the layers being joined. Available temporal relationships are as follows:
|
| The attribute relationship that will determine if features are joined to each other. Features are matched when the field values in the join layer are equal to field values in the target layer. |
If multiple features match with the same target feature, you can determine if all the matching features will be joined (Join one to many) or if all the matching features will be summarized together (Join one to one) as follows:
- Join one to one—This option summarizes all of the matching join features to each feature in the target layer. Only the features that have a match will be included in the summary and output. The count of joined features will be added in addition to other statistics such as sum, minimum, maximum, range, mean, variance, and standard deviation.
- Join one to many—This option joins all the matching features in the join layer to the target layer. The result layer will contain multiple records of the target feature.
If Use current map extent is checked, only the features visible within the current map extent will be analyzed. If unchecked, all features in both the target layer and the join layer will be analyzed, even if they are outside the current map extent.
Limitations
Summary statistics will only be calculated if a Join one to one operation is specified.
How Join Features works
Calculations
Statistics are calculated for only those features that meet the specified spatial, temporal, or attribute relationship used in the Join one to one operation. You can calculate numeric and string statistics. By default, all statistics are calculated. Using the image above, numeric statistics were calculated on the Occupants field and string statistics were calculated on the Building_Name field for the values of Apartments for the Type field as shown in the following tables:
| Numeric Statistic | Results of Occupants of Type Apartment |
|---|---|
Count | Count of: |
Sum | |
Minimum | Minimum of: |
Maximum | Maximum of: |
Average | |
Variance | |
Standard Deviation | |
| String Statistic | Results of Occupants of Type Apartment |
|---|---|
Count | ["Silverbirch Estates", "Pine Ridge", "Lake View"] = 3 |
Any | = "Pine Ridge" |
Note:
The count statistic (for strings and numeric fields) counts the number of nonnull values. The count of [0, 1, 10, 5, null, 6] = 5. The count of [Primary, Primary, Secondary, null] = 3.
Similar tools
Use Join Features to transfer attributes from one layer or table to another based on spatial and attribute relationships.
Map viewer analysis tools
Use the Aggregate Points tool to aggregate points into areas.
ArcGIS Desktop analysis tools
Join Features performs the functions of the Spatial Join, Add Join, and Summary Statistics tools.
You can run the GeoAnalytics Tools Join Features in ArcGIS Pro.