Provided by: libbio-perl-perl_1.7.2-2_all 
NAME
Bio::Map::Physical - A class for handling a Physical Map (such as FPC)
SYNOPSIS
use Bio::MapIO;
# acquire a Bio::Map::Physical using Bio::MapIO::fpc
my $mapio = Bio::MapIO->new(-format => "fpc",-file => "rice.fpc",
-readcor => 0);
my $physical = $mapio->next_map();
# get all the markers ids
foreach my $marker ( $physical->each_markerid() ) {
print "Marker $marker\n";
# acquire the marker object using Bio::Map::FPCMarker
my $markerobj = $physical->get_markerobj($marker);
# get all the clones hit by this marker
foreach my $clone ($markerobj->each_cloneid() ) {
print " +++$clone\n";
}
}
DESCRIPTION
This class is basically a continer class for a collection of Contig maps and other
physical map information.
Bio::Map::Physical has been tailored to work for FPC physical maps, but could probably be
used for others as well (with the appropriate MapIO module).
This class also has some methods with specific functionalities:
print_gffstyle() : Generates GFF; either Contigwise[Default] or
Groupwise
print_contiglist() : Prints the list of Contigs, markers that hit the
contig, the global position and whether the marker
is a placement (<P>) or a Framework (<F>) marker.
print_markerlist() : Prints the markers list; contig and corresponding
number of clones.
matching_bands() : Given two clones [and tolerence], this method
calculates how many matching bands do they have.
coincidence_score() : Given two clones [,tolerence and gellen], this
method calculates the Sulston Coincidence score.
For faster access and better optimization, the data is stored internally in hashes. The
corresponding objects are created on request.
FEEDBACK
Mailing Lists
User feedback is an integral part of the evolution of this and other Bioperl modules. Send
your comments and suggestions preferably to the Bioperl mailing list. Your participation
is much appreciated.
bioperl-l@bioperl.org - General discussion
http://bioperl.org/wiki/Mailing_lists - About the mailing lists
Support
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.
Reporting Bugs
Report bugs to the Bioperl bug tracking system to help us keep track of the bugs and their
resolution. Bug reports can be submitted via the web:
https://github.com/bioperl/bioperl-live/issues
AUTHOR - Gaurav Gupta
Email gaurav@genome.arizona.edu
CONTRIBUTORS
Sendu Bala bix@sendu.me.uk
PROJECT LEADERS
Jamie Hatfield jamie@genome.arizona.edu Dr. Cari Soderlund cari@genome.arizona.edu
PROJECT DESCRIPTION
The project was done in Arizona Genomics Computational Laboratory (AGCoL) at University of
Arizona.
This work was funded by USDA-IFAFS grant #11180 titled "Web Resources for the Computation
and Display of Physical Mapping Data".
For more information on this project, please refer:
http://www.genome.arizona.edu
APPENDIX
The rest of the documentation details each of the object methods. Internal methods are
usually preceded with a _
Access Methods
These methods let you get and set the member variables
version
Title : version
Usage : my $version = $map->version();
Function: Get/set the version of the program used to
generate this map
Returns : scalar representing the version
Args : none to get, OR string to set
modification_user
Title : modification_user
Usage : my $modification_user = $map->modification_user();
Function: Get/set the name of the user who last modified this map
Returns : scalar representing the username
Args : none to get, OR string to set
group_type
Title : group_type
Usage : $map->group_type($grptype);
my $grptype = $map->group_type();
Function: Get/set the group type of this map
Returns : scalar representing the group type
Args : none to get, OR string to set
group_abbr
Title : group_abbr
Usage : $map->group_abbr($grpabbr);
my $grpabbr = $map->group_abbr();
Function: get/set the group abbrev of this map
Returns : string representing the group abbrev
Args : none to get, OR string to set
core_exists
Title : core_exists
Usage : my $core_exists = $map->core_exists();
Function: Get/set if the FPC file is accompanied by COR file
Returns : boolean
Args : none to get, OR 1|0 to set
each_cloneid
Title : each_cloneid
Usage : my @clones = $map->each_cloneid();
Function: returns an array of clone names
Returns : list of clone names
Args : none
get_cloneobj
Title : get_cloneobj
Usage : my $cloneobj = $map->get_cloneobj('CLONEA');
Function: returns an object of the clone given in the argument
Returns : object of the clone
Args : scalar representing the clone name
each_markerid
Title : each_markerid
Usage : my @markers = $map->each_markerid();
Function: returns list of marker names
Returns : list of marker names
Args : none
get_markerobj
Title : get_markerobj
Usage : my $markerobj = $map->get_markerobj('MARKERA');
Function: returns an object of the marker given in the argument
Returns : object of the marker
Args : scalar representing the marker name
each_contigid
Title : each_contigid
Usage : my @contigs = $map->each_contigid();
Function: returns a list of contigs (numbers)
Returns : list of contigs
Args : none
get_contigobj
Title : get_contigobj
Usage : my $contigobj = $map->get_contigobj('CONTIG1');
Function: returns an object of the contig given in the argument
Returns : object of the contig
Args : scalar representing the contig number
matching_bands
Title : matching_bands
Usage : $self->matching_bands('cloneA','cloneB',[$tol]);
Function: given two clones [and tolerence], this method calculates how many
matching bands do they have.
(this method is ported directly from FPC)
Returns : scalar representing the number of matching bands
Args : names of the clones ('cloneA', 'cloneB') [Default tolerence=7]
coincidence_score
Title : coincidence_score
Usage : $self->coincidence_score('cloneA','cloneB'[,$tol,$gellen]);
Function: given two clones [,tolerence and gellen], this method calculates
the Sulston Coincidence score.
(this method is ported directly from FPC)
Returns : scalar representing the Sulston coincidence score.
Args : names of the clones ('cloneA', 'cloneB')
[Default tol=7 gellen=3300.0]
print_contiglist
Title : print_contiglist
Usage : $map->print_contiglist([showall]); #[Default 0]
Function: prints the list of contigs, markers that hit the contig, the
global position and whether the marker is a placement (P) or
a Framework (F) marker.
Returns : none
Args : [showall] [Default 0], 1 includes all the discrepant markers
print_markerlist
Title : print_markerlist
Usage : $map->print_markerlist();
Function : prints the marker list; contig and corresponding number of
clones for each marker.
Returns : none
Args : none
print_gffstyle
Title : print_gffstyle
Usage : $map->print_gffstyle([style]);
Function : prints GFF; either Contigwise (default) or Groupwise
Returns : none
Args : [style] default = 0 contigwise, else
1 groupwise (chromosome-wise).
_calc_markerposition
Title : _calc_markerposition
Usage : $map->_calc_markerposition();
Function: Calculates the position of the marker in the contig
Returns : none
Args : none
_calc_contigposition
Title : _calc_contigposition
Usage : $map->_calc_contigposition();
Function: calculates the position of the contig in the group
Returns : none
Args : none
_calc_contiggroup
Title : _calc_contiggroup
Usage : $map->_calc_contiggroup();
Function: calculates the group of the contig
Returns : none
Args : none
_set<Type>Ref
Title : _set<Type>Ref
Usage : These are used for initializing the reference of the hash in
Bio::MapIO (fpc.pm) to the corresponding hash in Bio::Map
(physical.pm). Should be used only from Bio::MapIO System.
$map->setCloneRef(\%_clones);
$map->setMarkerRef(\%_markers);
$map->setContigRef(\%_contigs);
Function: sets the hash references to the corresponding hashes
Returns : none
Args : reference of the hash.