NAME
fasta-decoy.pl - decoy input databanks following several moethods
DESCRIPTION
Reads input fasta file and produce a decoyed databank with several methods:
- reverse: simply reverse each sequence
- shuffle: shuffle AA in each sequence
- shuffle & avoid known cleaved peptides: shuffle sequence but avoid producing known tryptic peptides
- Markov model: learn Markov model chain distribution of a given level, then produces entries corresponding to this distribution
SYNOPSIS
#reverse sequences for a local (optionaly compressed) file
fasta-decoy.pl --in=/tmp/uniprot_sprot.fasta.gz --method=reverse
#download databanks from the web | uncompress it and shuffle the sequence
wget -silent -O - ftp://ftp.expasy.org/databases/uniprot/current_release/knowledgebase/complete/uniprot_sprot.fasta.gz | zcat | databatanks-decoy.pl --method=shuffle
#use a .dat file (with splice forms) as an input
uniprotdat2fasta.pl --in=uniprot_sprot_human.dat | fasta-decoy.pl --method=markovmodel
#reversing each sequence
fasta-decoy.pl --ac-prefix=DECOY_ --in=mitoch.fasta --method=reverse --out=mitoch-reverse.fasta
#drawing amino acid following distribution in original fasta (end of sequence is considered as a learned random event)
fasta-decoy.pl --ac-prefix=DECOY_ --in=mitoch.fasta --method=markovmodel --markovmodel-level=0 --out=mitoch-markovmodel_0.fasta
#drawing amino acid with a markov model (here of length 3)
fasta-decoy.pl --ac-prefix=DECOY_ --in=mitoch.fasta --method=markovmodel --markovmodel-level=3 --out=mitoch-markovmodel_3.fasta
#each sequence is randomly shuffled
fasta-decoy.pl --ac-prefix=DECOY_ --in=mitoch.fasta --method=shuffle --out=mitoch-shuffle.fasta
#idem, but no tryptic peptide (of length>=6) from the original bank must be found in the random one;
=> see script fasta-shuffle-notryptic.pl
ARGUMENTS
--in=infile.fasta
An input fasta file (will be uncompressed if ending with gz)
-out=outfile.fasta
A .fasta file [default is stdout]
--method=(reverse|shuffle|markovmodel)
Set the decoying method
OPTIONS
--ac-prefix=string
Set a key to be prepended before the AC in the randomized bank. By default, it will be dependent on the choosen method.
--method=shuffle options
--method=markovmodel options
--markovmodel-level=int [default 3]
Set length of the model (0 means only AA distrbution will be respected, 3 means chains of length 3 distribution etc.). Setting a length >3 can deal to memory burnout.
misc
--norandomseed
Random generator seed is set to 0, so 2 run on same data will produce the same result
--noprogressbar
do not display terminal progress bar (if possible)
--help
--man
--verbose
Setting an environment variable DO_NOT_DELETE_TEMP=1 will keep the temporay file after the script exit
EXAMPLE
COPYRIGHT
Copyright (C) 2004-2006 Geneva Bioinformatics www.genebio.com
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
AUTHORS
Alexandre Masselot, www.genebio.com