This repository contains an implementation of the psRNATarget software (2018) (https://doi.org/10.1093/nar/gky316) for which there is a web service available here (http://plantgrn.noble.org/psRNATarget/). Using this web service is relevant for small datasets, but not for large datasets in the context of repeated usage by a bioinformatic production pipeline that can take full advantage of high performance computing capabilities. Unfortunately, no code is publicly available for that software and as such, no local implementation with custom databases is possible. psRNATarget in its current state (i.e. 2018 release) actually loosely describes an implementation of a 2011 previous psRNATarget release (https://doi.org/10.1093/nar/gkr319) which in turn refers to the Fahlgren & Carrington (2009) book chapter.
Figure 1. psRNATarget scoring scheme.
Alignments are scored starting from the 5' end of the miRNA sequence (right side of the alignment). By default, a mismatch is given a penalty score of 1. If the mismatch if located inside the seed region defined by default to be between bp 2 and 13 inclusively, a penalty of 1.5 is apply to the mismatch (i.e. 1 x 1.5 = 1.5). G:U pairs are given a penalty score of 0.5 and are NOT subject to the penalty multiplier if it is located inside the seed region. If there is a gap opening, a penalty score of 2 is added and each adjacent subsequent gap is given a penalty score of 0.5 (i.e. penalty for extending gap).
Here, we present code that implements the psRNATarget methodology. It parses the output of miRNA sequences aligned with SSEARCH against reference bacterial genomes. This script can be deployed and used on a HPC system. SSEARCH can be found in the fasta package (https://github.com/wrpearson/fasta36). Compared to the psRNATarget web server, this current implementation has the benefit of being fully customizable at the command line (see below for supported arguments) and does not give duplicate alignments in output.
The SSEARCH command used to align miRNA sequences is the following command inspired from TargetFinder (https://github.com/carringtonlab/TargetFinder) - look for line 243 of targetfinder.pl
in particular. By trial and error, we've found the following ssearch commands to exactly reproduce the output of psRNATarget.
Just clone the repository and you're good to go.
First, alignments with ssearch have to be generated. For forward strand alignment:
ssearch36 \
-f -8 -g -3 -E 10000 -T 8 -b 200 -r +4/-3 -n -U -W 10 -N 20000 \
<rev_comped_mirna_sequences> \
<reference_db> \
> <ssearch_output>
For reverse strand alignment:
ssearch36 \
-f -8 -g -3 -E 10000 -T 8 -b 200 -r +4/-3 -n -U -W 10 -N 20000 \
<mirna_sequences> \
<reference_db> \
> <ssearch_output>
Note that you can play with the -i
switch instead of 'manually' revcomping your query miRNA sequence file like I did. Also note that in our tests, the -r
argument had to be absolutely set to -r +4/-3
. The -f
and -g
parameters that were found to work are the following:
-f -8 -g -3
or -f -9 -g -2
.
Then convert the ssearch alignments to tsv format with parse_ssearch.py
parse_ssearch.py -i ssearch_output.txt > ssearch_output.tsv
Then, parse the alignments using the procedure implemented in psRNATarget:
parse_mirna_targets.py -i ssearch_output.tsv > ssearch_output_parsed.tsv
You can also pipe the output of parse_ssearch.py into parse_mirna_targets.py like this:
parse_ssearch.py -i ssearch_output.txt | parse_mirna_targets.py > ssearch_output_parsed.tsv
You can also use pipes all the way by piping the output of ssearch to parse_ssearch.py and piped again to parse_mirna_targets.py like shown below. This will reproduce the psRNATarget workflow in one single command and avoid generating intermediate files.
ssearch36 -f -8 -g -3 -E 10000 -T 8 -b 200 -r +4/-3 -n -U -W 10 -N 20000 ./data/test_rc.fna ./data/2545824690.fna | ./parse_ssearch.py | ./parse_mirna_targets.py > filtered_mirna.tsv
We compared the results of this script with the ones given by psRNATarget and it gives identical results.
Available options of parse_mirna_targets.py -h
:
INPUT:
--infile <string> : Alignments in .tsv file format (output of companion script parseSsearch.pl). If no --infile <string> arg is
specified, will read from standard input.
--E_cutoff <float> : default = 5.0 - Expectation value is the penalty for the mismatches
between mature small RNA and the target sequence. A higher value indicates
less similarity (and possibility) between small RNA and the target candidate.
The default penalty rule is set up by the scoring schema. Maximum expectation is the cutoff;
any small RNA-target pair with an expectation less than the cutoff will be discarded in the final result.
The recommended values are 3.0-5.0 depending on the scoring schema.
--penalty_multiplier <string> : default = 1.5. In the seed region (by default, 2-13 nt from the 5' of the miRNA strand), multiply mismatches by
penalty_multiplier. Only mismatches are multiplied, not G:U pairs and/or the '.' alignment
caracters given by SSEARCH.
--seed_start <int> : default = 2 - Beginning of seed region. --seed_start and --seed_end positions affect where in the alignment
the --penalty_multiplier will be applied.
--seed_end <int> : default = 13 - End of seed region.
--num_mismatch_seed <int> : default = 2 - Maximum of allowed mismatches in the seed region, excluding G:U pairs.
--hsp_cutoff <int> : default = 14 - HSPs shorter than this value will be discarded.
--gap_cutoff <int> : default = 1 - alignments having more than <int> gaps willbe discarded.
--total_mismatches_cutoff <int> : default = 8 - alignments showing more than <int> mismatches will be discarded.
--GUs_cutoff <int> : default = 7 - alignments having more than <int> mismatches will be discarded.
--keep_target_suffix : set flag if you wish to keep the temporary _<int> suffix appended at the end
of subjects IDs.
--rev : Set flag if alignments of miRNAs were done on revcomp subject sequences.
--verbose : Set flag for debugging.
--maximum_alignment_length <int> : default = 22 - alignments longer than this value will be discarded.
--extra_penalty_query_gap <int> : default = 1. If gap is located on query (miRNA) sequence, add an extra penalty of <int>.
--keep_tmp_file : Set flag if you wish to keep the tmp file resulting from the parsing of the ssearch file used as input.
OUTPUT:
STDOUT <string> : standard output. Alignments that passed filters.
--outfile_failed <string> : stanbard error. Alignments that failed to pass filters.
It might seem confusing that in Fig. 1, what is actually shown as A-G or C-U pairs are considered to be G:U mismatches. This is because the reverse complementary sequence is the one being used for computing the alignment, but the reverse sequence is the one that actually binds to its DNA target. For instance, in Fig. 1 at position 4, the 'A' nucleotide on the rev-comp sequence is a 'U' on the reverse sequence, hence resulting in a G:U pair.
Input mirna sequence: UACUAAGUAGAGUCUAAGAGA
Reverse sequence: AGAGAAUCUGAGAUGAAUCAU <- Actual sequence that will bind to its target
Reverse complementary sequence: UCUCUUAGACUCUACUUAGUA <- miRNA sequence shown on Fig. 1
If you use MiRNATarget in your work, please cite:
Tremblay, Julien
MiRNATarget 1.0 : miRNA target finder