locarna_p - manual page for locarna_p (LocARNA 2.0.0)
locarna_p - pairwise partition function of RNA alignments.
Computes base and base pair match probabilities from alignment
partitition functions.
USAGE: locarna_p [options] <Input 1> <Input 2>
locarna_p computes sequence and structure match probabilities from
partition functions of locarna pairwise alignments, i.e. from fast
simultaneous folding and alignment based on two RNA sequences (or
alignments).
Please see the documentation of locarna for inputs and the
possible constraints specifications.
Probabilities of base and base pair matches can be written to
files. (The total partition function is reported to standard out.)
- -h, --help
- Print this help.
- -V, --version
- Print only version string.
- -v, --verbose
- Be verbose. Prints input parameters, sequences and size information.
- -q, --quiet
- Be quiet.
- -i,
--indel=<score>(-150)
- Indel score. Score contribution of each single base insertion or deletion.
Indel opening score and indel score define the affine scoring of
gaps.
- --indel-opening=<score>(-750)
- Indel opening score. Score contribution of opening an insertion or
deletion, i.e. score for a consecutive run of deletions or insertions.
Indel opening score and indel score define the affine scoring of
gaps.
- --ribosum-file=<f>(RIBOSUM85_60)
- File specifying the Ribosum base and base-pair similarities. [default: use
RIBOSUM85_60 without requiring a Ribosum file.]
- --use-ribosum=<bool>(true)
- Use ribosum scores for scoring base matches and base pair matches; note
that tau=0 suppresses any effect on the latter.
- -m,
--match=<score>(50)
- Set score contribution of a base match (unless ribosum scoring).
- -M,
--mismatch=<score>(0)
- Set score contribution of a base mismatch (unless ribosum scoring).
- -s,
--struct-weight=<score>(200)
- Maximal weight of 1/2 arc match. Balances structure vs. sequence score
contributions.
- -e,
--exp-prob=<prob>
- Expected base pair probability. Used as background probability for base
pair scoring [default: calculated from sequence length].
- -t,
--tau=<factor>(50)
- Tau factor. Factor for contribution of sequence similarity in an arc match
(in percent). tau=0 does not penalize any sequence information including
compensatory mutations at arc matches, while tau=100 scores sequence
similarity at ends of base matches (if a scoring matrix like ribosum is
used, this adds the contributions for base pair match from the matrix).
[default tau=0!]
- --temperature-alipf=<int>(300)
- Temperature for the /sequence alignment/ partition functions used
by the probcons-like sequence-based match/trace probability computation
(this temperature is different from the 'physical' temperature of RNA
folding!).
- --pf-scale=<scale>(1.0)
- Factor for scaling the partition functions. Use in order to avoid
overflow.
- --extended-pf
- Use extended precision for partition function values. This increases
run-time and space (less than 2x), however enables handling significantly
larger instances.
- --quad-pf
- Use quad precision for partition function values. Even more precision than
extended pf, but usually much slower (overrides extended-pf).
- The tool is called with two input files <Input 1> and <Input
2>, which specify the two input sequences or input alignments.
Different input formats (Fasta, Clustal, Stockholm, LocARNA PP, ViennaRNA
postscript dotplots) are accepted and automatically recognized (by file
content); the two input files can be in different formats. Extended
variants of the Clustal and Stockholm formats enable specifying anchor and
structure constraints.
locarna_p is a low level tool; most often this tool is used
indirectly, by calling mlocarna with --probabilistic. Note that the
performance of locarna_p (as well as basically all tools in the LocARNA
package) is often significantly improved by the use of suitable
application-specific options, deviating from the default settings.
The latest LocARNA package release is available online at at
Github https://github.com/s-will/LocARNA and
http://www.bioinf.uni-freiburg.de/Software/LocARNA/
Copyright 2005- Sebastian Will. The LocARNA package is released
under GNU Public License v3.0
Sebastian Will, Tejal Joshi, Ivo L. Hofacker, Peter F. Stadler,
and Rolf Backofen. LocARNA-P: Accurate boundary prediction and improved
detection of structural RNAs. RNA, 18 no. 5 pp. 900-914, 2012. doi:
10.1261/rna.029041.111
Please see the documentation of locarna for call and input
constraint examples.
This man page is written and maintained by Sebastian Will it is
part of the LocARNA package.
First versions of locarna_p and its aligner class were written by
Tejal Joshi.
Report bugs to <will (at) informatik.uni-freiburg.de>.