NAME¶
Bio::Tools::Run::FootPrinter - wrapper for the FootPrinter program
SYNOPSIS¶
use Bio::Tools::Run::FootPrinter;
my @params = (size => 10,
max_mutations_per_branch => 4,
sequence_type => 'upstream',
subregion_size => 30,
position_change_cost => 5,
triplet_filtering => 1,
pair_filtering => 1,
post_filtering => 1,
inversion_cost => 1,
max_mutations => 4,
tree => "~/software/FootPrinter2.0/tree_of_life" );
my $fp = Bio::Tools::Run::FootPrinter->new(@params, -verbose => 1);
my $sio = Bio::SeqIO->new(-file => "seq.fa", -format => "fasta");
while (my $seq = $sio->next_seq){
push @seq, $seq;
}
my @fp = $fp->run(@seq);
foreach my $result(@fp){
print "***************\n".$result->seq_id."\n";
foreach my $feat($result->sub_SeqFeature){
print $feat->start."\t".$feat->end."\t".$feat->seq->seq."\n";
}
}
DESCRIPTION¶
From the FootPrinter manual:
FootPrinter is a program that performs phylogenetic footprinting. It takes as
input a set of unaligned orthologous sequences from various species, together
with a phylogenetic tree relating these species. It then searches for short
regions of the sequences that are highly conserved, according to a parsimony
criterion.
The regions identified are good candidates for regulatory elements. By default,
the program searches for regions that are well conserved across all of the
input sequences, but this can be relaxed to find regions conserved in only a
subset of the species
Written by Mathieu Blanchette and Martin Tompa. Available here:
http://www.mcb.mcgill.ca/~blanchem/FootPrinter2.1.tar.gz
To run FootPrinter, you will need to set the environment variable
FOOTPRINTER_DIR to where the binary is located (even if the executable is in
your path). For example:
setenv FOOTPRINTER_DIR /usr/local/bin/FootPrinter2.0/
Available Parameters¶
PARAM VALUES DESCRIPTION
------------------------------------------------------------------------
tree <file> REQUIRED, Tree in Newick Format
to evaluate parsimony score
REQUIRED unless tree_of_life
exists in FOOTPRINTER_DIR
sequence_type upstream Default upstream
downstream
other
size 4-16 Specifies the size of the motifs sought
max_mutations 0-20 maximum parsimony score allowed for the motifs
max_mutations_per_branch 0-20 Allows at most a fixed number of mutations per
branch of the tree
losses <file> files give span constraints so that the motifs
reported are statistically significant
Example files
universal([6-9]|1[0-2])(loose|tight)?.config
come with FootPrinter2.0.
Install these in FOOTPRINTER_DIR and use by
setting "losses" to "somewhat significant",
"significant", or "very significant". Do not
set loss_cost.
loss_cost 0-20 a cost associated with losing a motif along some
branch of the tre
subregion_size 1-infinity penalize motifs whose position in the sequences
varies too much
position_change_cost 0-20 Cost for changing subregion
triplet_filtering 1/0 pre-filtering step that removes from consideration
any substring that does not have a sufficiently good
pair of matching substrings in some pair of the other
input sequences
pair_filtering 1/0 Same as triplet filtering, but looks only for one match
per other sequence
post_filtering 1/0 when used in conjunction with the triplet filtering
option, this often significantly speeds up the program,
while still garanteeing optimal results
indel_cost 1-5 insertions and deletions will be allowed in the motifs
sought, at the given cost
inversion_cost 1-5 This option allows for motifs to undergo inversions,
at the given cost. An inversion reverse-complements
the motif.
details 1/0 Shows some of the details about the progress of the
computation
html 1/0 produce html output (never deleted)
ps 1/0 produce postscript output (never deleted)
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 one of the Bioperl
mailing lists. 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 the bugs
and their resolution. Bug reports can be submitted via the web:
http://redmine.open-bio.org/projects/bioperl/
AUTHOR - Shawn Hoon¶
Email shawnh@fugu-sg.org
APPENDIX¶
The rest of the documentation details each of the object methods. Internal
methods are usually preceded with a "_".
program_name¶
Title : program_name
Usage : $factory>program_name()
Function: holds the program name
Returns: string
Args : None
program_dir¶
Title : program_dir
Usage : $factory->program_dir(@params)
Function: returns the program directory, obtained from ENV variable.
Returns: string
Args :
executable¶
Title : executable
Usage : my $exe = $footprinter->executable('FootPrinter');
Function: Finds the full path to the 'FootPrinter' executable
Returns : string representing the full path to the exe
Args : [optional] name of executable to set path to
[optional] boolean flag whether or not warn when exe is not found
new¶
Title : new
Usage : $rm->new($seq)
Function: creates a new wrapper
Returns: Bio::Tools::Run::FootPrinter
Args : self
run¶
Title : run
Usage : $fp->run(@seq)
Function: carry out FootPrinter
Example :
Returns : An array of SeqFeatures
Args : An array of Bio::PrimarySeqI compliant object
At least 2 are needed.
_run¶
Title : _run
Usage : $fp->_run ($filename,$param_string)
Function: internal function that runs FootPrinter
Example :
Returns : an array of features
Args : the filename to the input sequence, filename to phylo tree
and the parameter string
_setparams()¶
Title : _setparams
Usage : Internal function, not to be called directly
Function: Create parameter inputs for FootPrinter program
Example :
Returns : parameter string to be passed to FootPrinter
Args : name of calling object
Title : _setinput
Usage : Internal function, not to be called directly
Function: writes input sequence to file and return the file name
Example :
Returns : string
Args : a Bio::PrimarySeqI compliant object
no_param_checks¶
Title : no_param_checks
Usage : $obj->no_param_checks($newval)
Function: Boolean flag as to whether or not we should
trust the sanity checks for parameter values
Returns : value of no_param_checks
Args : newvalue (optional)
save_tempfiles¶
Title : save_tempfiles
Usage : $obj->save_tempfiles($newval)
Function:
Returns : value of save_tempfiles
Args : newvalue (optional)
outfile_name¶
Title : outfile_name
Usage : my $outfile = $codeml->outfile_name();
Function: Get/Set the name of the output file for this run
(if you wanted to do something special)
Returns : string
Args : [optional] string to set value to
tempdir¶
Title : tempdir
Usage : my $tmpdir = $self->tempdir();
Function: Retrieve a temporary directory name (which is created)
Returns : string which is the name of the temporary directory
Args : none
cleanup¶
Title : cleanup
Usage : $codeml->cleanup();
Function: Will cleanup the tempdir directory
Returns : none
Args : none
Title : io
Usage : $obj->io($newval)
Function: Gets a L<Bio::Root::IO> object
Returns : L<Bio::Root::IO>
Args : none