Element Connection

Element connections can connect attributes from one dataset to another based on spatial, temporal, and attribute relationships, or some combination of these three. The dataset can be either spatial or attribute data. The feature connection will first determine all input objects that meet the connection conditions based on the specified conditions, and then connect the input objects that meet the requirements to the objects in the source data. The returned result type is Feature Dataset (FeatureRDD). Connect feature tools can transfer information from one layer and append it to another layer. When connecting elements, they can be connected based on spatial relationships, attribute relationships, temporal relationships, or a combination of the three. The specific instructions are as follows:

Spatial relationships

Determine the spatial relationship between features, and the available relationships will depend on the geometric type (point, line, or face) of the layer being connected. The spatial relationships provided are as follows: proximity, inclusion, inclusion, intersection, overlap, adjacency, distance, consistency. Please refer to: |Spatial relationship | diagram | explanation| | :-------- |:--------| :------| |Near |

! [] (../../img/Adjacent. png) | If the connection object and the source object are within the specified distance radius range, the condition is met| |Contain |! [] (../../img/Container. png) | The source object contains the connection object| |Within |! [] (../../img/Within. png) | The source object is contained by the connected object| |Cross |! [] (../../img/Cross. png) | There is a traversal relationship between the source object and the connection object| |Overlap |! [] (../../img/Overlap. png) | The source object partially overlaps with the connection object| |Intersected |! [] (../../img/Intersect. png) | The source object intersects with the connection object| |Touch |! [] (../../img/Touch. png) | Objects in two datasets have common points or edges| |Disjointed |! [] (../../img/Disjoin. png) | The objects in two datasets do not intersect| |Identical |! [] (../../img/Identity. png) | Objects of the same type overlap, such as point to point, line to line, and face to face|

Time relationship

Determine the temporal relationship between objects, and the available relationships depend on the time type (time or interval) of the layer being connected. For detailed instructions, please refer to: |Time relationship | diagram | explanation| | :-------- |:--------:| :------| |Near |

! [] (../../img/TimeNear. png) | If the time interval between the source and connected time periods is less than the time distance, then the proximity relationship is satisfied| |After |! [] (../../img/TimeAfter. png) | When the source time is after the connection time| |Before |! [] (../../img/TimeBefore. png) | When the source time is before the connection time| |Contains |! [] (../../img/TimeContains. png) | When the connection time occurs between the start and end points of the source time interval, the source time includes the connection time| |During |! [] (../../img/TimeDuration. png) | When the source time occurs between the starting and ending points of the connection time interval, the source time is during the connection time period| |Finishes |! [] (../../img/TimeFinish. png) | The source time and connection time end at the same time, and the source time starts after the connection time| |Meets |! [] (../../img/TimeMeets. png) | The end time of the source data is equal to the start time of the connected data| |MetBy |! [] (../../img/TimeMetby. png) | The start time of the source data is equal to the end time of the connected data| |Overlaps |! [] (../../img/TimeOverlaps. png) | The source data start time is before the connection data start time, and the source data time ends before the connection data time| |OverlappedBy |! [] (../../img/TimeOverlapped. png) | The source data start time is after the connection data start time, and the source data time ends after the connection data time| |Starts |! [] (../../img/TimeStart. png) | The source time starts at the same time as the connection time, and the source time ends before the end of the connection time interval| |StartedBy |! [] (../../img/TimeStartedby. png) | The source time starts at the same time as the connection time, and the source time ends after the end of the connection time| |Equals |! [] (../../img/TimeEquals. png) | If the source data time interval and the connection data time interval are exactly the same, then these two times are exactly the same| ###* * Attribute Relationship** If the attribute relationships between objects are determined, and if the field values in the connected data are equal or unequal to the field values in the source data, the objects that meet the conditions will be matched.

Connection type

Refers to the matching relationship between source object attributes and connection objects, providing two connection methods: one-to-one and one-to-many. Set using the "Feature Connection Type" parameter. ** * One to One Connection * : If the connection object that meets the conditions is one, the connection field attribute values of the connection object will be updated to the source object; If there are multiple connection objects that meet the conditions, only the number of objects that meet the conditions will be counted. * * One to Many Connection * *: This method preserves each multiple object that meets the condition in the result dataset. For example, if an object in the source dataset matches five objects in the connection dataset, the result dataset will contain these five objects</ span> !

Application Scenario

*Analyze the flow of fund transactions and calculate the total amount of funds transferred to the same account within a specified time frame. *By using element connectivity tools, additional information from various urban jurisdictions (such as school districts, police districts, communities, etc.) can be added to each crime, further studying and analyzing the impact of crime on different jurisdictions.

Parameter Description

Parameter Name Default Value Parameter Definition Parameter Type
Target Dataset   The target data of the feature connection, and the attributes of the connected data will be appended to the associated target data FeatureRDD
Connection data of feature connections   Connection data of feature connections, providing attribute datasets FeatureRDD
Element Connection Type   Element Connection Type, one-to-one Connection: If multiple connection objects and a target object meet the association condition, multiple connection objects will be aggregated into one object through attribute statistics. At this point, attribute statistics can be set through stats. If not set, the default count is the number of connected objects. One to many connections: If multiple connection objects and a target object meet the association condition, the attributes of multiple connection objects will be connected to the target object, forming multiple result objects, and attribute statistics will not be performed JavaJoinOperatorType
Element connection field
(Optional)		   Element connection field, when the connection type is one-to-one connection, the mode of the field value is taken String
Spatial relationship type
(Optional)		   Spatial relationship type refers to the spatial relationship between feature objects in the target dataset and the connected dataset, as described above. At least one of the spatial association conditions, temporal association conditions, and attribute association conditions must be valid JavaSpatialRelationType
Proximity distance
(Optional)		   Proximity distance, used to determine whether the spatial distance between two objects is within the specified proximity distance range when the spatial relationship is' adjacent ' JavaDistance
Time relationship judgment type
(Optional)		   Time relationship judgment type, see the above time relationship description. At least one of the spatial association conditions, temporal association conditions, and attribute association conditions must be valid JavaTimeOperatorType
Time distance
(Optional)		   Time distance, used to determine whether the minimum time interval between two elements is within the specified time distance range when the time relationship judgment type is "adjacent" JavaDuration
Attribute Connection Condition
(Optional)		   Attribute Connection Condition, such as' tagField, Equal, joinField ', supports Equal and NotEqual. At least one of the spatial association conditions, temporal association conditions, and attribute association conditions must be valid JavaAttributeRelation
Specify the field name and statistical method of the connection data to be counted
(Optional)		   Specify the field name and statistical method of the connection data to be counted, such as' Field, sum, Field '_ Sum ', only valid when the connection type is' one-to-one connection' JavaAttributeRelationship
Node tolerance
(Optional)		 0.0 Node tolerance. The default value is 0.0. When the tolerance is less than 1.0e-10, if the coordinate system of the dataset is a geographic coordinate system, the node tolerance of 1.0e-7 will be used; when the coordinate system is empty or the projection coordinate system, the node tolerance of 1.0e-2 will be used Double
Name of the field identifying the start time in the target feature dataset
(Optional)		   Name of the field identifying the start time in the target feature dataset String
Name of the field in the target feature dataset that identifies the end time
(Optional)		   Name of the field in the target feature dataset that identifies the end time String
Name of the field identifying the start time in the connected feature dataset
(Optional)		   Name of the field identifying the start time in the connected feature dataset String
Name of the field identifying the termination time in the connected feature dataset
(Optional)		   Name of the field identifying the termination time in the connected feature dataset String