com.vividsolutions.jcs.conflate.polygonmatch
Class ChainMatcher

java.lang.Object
  com.vividsolutions.jcs.conflate.polygonmatch.ChainMatcher

All Implemented Interfaces:

FeatureMatcher

public class ChainMatcher

extends java.lang.Object

implements FeatureMatcher

Composes several FeatureMatchers into one. Candidate features are whittled down by applying each FeatureMatcher.

Note: Only the last FeatureMatcher's scores are preserved; the other scores are lost. However, this behaviour should be acceptable for most situations Typically you use the Chained Matcher to do some initial filtering before the "real" matching. The scores from this initial filtering are usually ignored (they're usually just 1 or 0, as in the case of WindowFilter).

Constructor Summary

ChainMatcher(FeatureMatcher[] matchers)
Creates a ChainMatcher composed of the given matchers.

Method Summary

Matches

match(com.vividsolutions.jump.feature.Feature target, com.vividsolutions.jump.feature.FeatureCollection candidates) Applies the FeatureMatchers, in sequence, to the list of candidates.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ChainMatcher

public ChainMatcher(FeatureMatcher[] matchers)

Creates a ChainMatcher composed of the given matchers.

Parameters:

matchers - the matchers to link together

Method Detail

match

public Matches match(com.vividsolutions.jump.feature.Feature target,
                     com.vividsolutions.jump.feature.FeatureCollection candidates)

Applies the FeatureMatchers, in sequence, to the list of candidates.

Specified by:

match in interface FeatureMatcher

Parameters:

target - the feature to match

candidates - the features to search for matches

Returns:

the candidates surviving all the FeatureMatchers. The scores are those returned by the last FeatureMatcher.