Class EnvelopeDistance

Hierarchy: Object , EnvelopeDistance

public class EnvelopeDistance

Functions for computing distances between Envelopes.

Authors:: mdavis

public static double maximumDistance(Envelope env1, Envelope env2)

Computes the maximum distance between the points defining two envelopes. It is equal to the length of the diagonal of the envelope containing both input envelopes. This is a coarse upper bound on the distance between geometries bounded by the envelopes.

Parameters:: env1 - env1 an envelope; env2 - env2 an envelope

Returns:: the maximum distance between the points defining the envelopes

public static double minMaxDistance(Envelope a, Envelope b)

Computes the Min-Max Distance between two Envelopes. It is equal to the minimum of the maximum distances between all pairs of edge segments from the two envelopes. This is the tight upper bound on the distance between geometric items bounded by the envelopes.

Theoretically this bound can be used in the R-tree nearest-neighbour branch-and-bound search instead of maximumDistance(Envelope, Envelope). However, little performance improvement is observed in practice.

Parameters:: a - a an envelope; b - b an envelope

Returns:: the min-max-distance between the envelopes