Sync with main trunk
[bioperl-live.git] / Bio / Align / StatisticsI.pm
blobacae66a2677e318c16bb9dea5e3efc07165d3f16
1 # $Id$
3 # BioPerl module for Bio::Align::StatisticsI
5 # Cared for by Jason Stajich <jason@bioperl.org>
7 # Copyright Jason Stajich
9 # You may distribute this module under the same terms as perl itself
11 # POD documentation - main docs before the code
13 =head1 NAME
15 Bio::Align::StatisticsI - Calculate some statistics for an alignment
17 =head1 SYNOPSIS
19 Give standard usage here
21 =head1 DESCRIPTION
23 Describe the interface here
25 =head1 FEEDBACK
27 =head2 Mailing Lists
29 User feedback is an integral part of the evolution of this and other
30 Bioperl modules. Send your comments and suggestions preferably to
31 the Bioperl mailing list. Your participation is much appreciated.
33 bioperl-l@bioperl.org - General discussion
34 http://bioperl.org/wiki/Mailing_lists - About the mailing lists
36 =head2 Reporting Bugs
38 Report bugs to the Bioperl bug tracking system to help us keep track
39 of the bugs and their resolution. Bug reports can be submitted via the
40 web:
42 http://bugzilla.open-bio.org/
44 =head1 AUTHOR - Jason Stajich
46 Email jason@bioperl.org
48 =head1 APPENDIX
50 The rest of the documentation details each of the object methods.
51 Internal methods are usually preceded with a _
53 =cut
56 # Let the code begin...
59 package Bio::Align::StatisticsI;
60 use strict;
63 use base qw(Bio::Root::RootI);
65 =head2 distance
67 Title : distance
68 Usage : my $distance_mat = $stats->distance(-align => $aln,
69 -method => $method);
70 Function: Calculates a distance matrix for all pairwise distances of
71 sequences in an alignment.
72 Returns : Array ref
73 Args : -align => Bio::Align::AlignI object
74 -method => String specifying specific distance method
75 (implementing class may assume a default)
77 =cut
79 sub distance{
80 my ($self,@args) = @_;
81 $self->throw_not_implemented();
84 =head2 available_distance_methods
86 Title : available_distance_methods
87 Usage : my @methods = $stats->available_distance_methods();
88 Function: Enumerates the possible distance methods
89 Returns : Array of strings
90 Args : none
93 =cut
95 sub available_distance_methods{
96 my ($self,@args) = @_;
97 $self->throw_not_implemented();