Spatial Match Tool

The Spatial Match tool establishes the spatial relationship (contains, intersects, touches, etc) between two sets of spatial objects. The tool accepts a set of spatial objects from the Target Input and a set of spatial objects from the Universe Input. At least one input stream should contain Polygon type spatial objects.

A Universe input connection into this tool is optional (this file can be specified via an input path ), as indicated by the white input connection arrow .

For each record from the Target’s data stream, the Spatial Match tool analyzes the spatial object’s extents and attempts to find a record in the Universe’s data stream whose spatial object’s extents intersect with that of the Target's. If a matching record is found in the Universe Input, it is sent through the Matched output, and joined to the Target record. If no matching Universe Input record is found, the Target record is sent through the Unmatched output.

The Spatial Match tool produces a single or double data stream with one record for each instance of a Target Input record matching a Universe Input record. The schema of the output table is formed by appending the fields from both records into one wide record.

While using spatial tools, you may have more than one spatial object field in the data stream. When you are configuring the final output tool, you must remember that output to files such as.dbf,.xls or.csv will not accept the spatial object fields, and that spatial files will accept only one spatial object field.

Configuration Properties

The Spatial Match tool accepts two spatial inputs.

  1. Select the Target Spatial object from the drop down list

    When working with polygons on both sides, the physically larger polygons should be on the Targets side. When working with polygons and points, the polygon should be on the Targets side.

  2. Specify the Universe object:
  3. Specify the type of Spatial Match to calculate:

  4. Notice the check box to output the intersection polygon, when checked the intersection polygon will be included in downstream tools.


    This option is only available when Intersects is selected, and is only relevant when matching  polygon to polygon.

    The intersection polygon refers ONLY to the area occupied by BOTH polygon Objects.

From the configuration properties, you can rename fields, reorder fields, sort ascending/descending, and select the fields needed from the inputs.

Output Streams of the Spatial Match Tool

There are two Output Streams on the Spatial Match tool:

For more information on the Spatial Match tool, see the Spatial Match Behavior page.