This class represents a one continuous match between two coordinate systems
represented by Bio::Location::Simple objects. The relationship is directed and
reversible. It implements methods to ensure internal consistency, and map
continuous and split locations from one coordinate system to another.

This class is an elaboration of Bio::Coordinate::Pair. The map
function returns only matches which is the mode needed most of tehtime. By
default the matching regions between coordinate systems are boundless, so
that you can say e.g. that gene starts from here in the chromosomal
coordinate system and extends indefinetely in both directions. If you want
to define the matching regions exactly, you can do that and set
strict() to true.

Title : map
Usage : $newpos = $obj->map($loc);
Function: Map the location from the input coordinate system
to a new value in the output coordinate system.
In extrapolating coordinate system there is no location zero.
Locations are...
Example :
Returns : new location in the output coordinate system or undef
Args : Bio::Location::Simple

Title : _map
Usage : $newpos = $obj->_map($simpleloc);
Function: Internal method that does the actual mapping. Called
multiple times by map() if the location to be mapped is a
split location
Example :
Returns : new location in the output coordinate system or undef
Args : Bio::Location::Simple

Please direct usage questions or support issues to the mailing list:
bioperl-l@bioperl.org

rather than to the module maintainer directly. Many experienced
and reponsive experts will be able look at the problem and quickly address
it. Please include a thorough description of the problem with code and data
examples if at all possible.