From 75c474ff6ed8cc4d8e4b88a46a0afb1c31014618 Mon Sep 17 00:00:00 2001
From: Jonas Fuchs <78491186+jonas-fuchs@users.noreply.github.com>
Date: Fri, 1 Dec 2023 16:32:30 +0100
Subject: [PATCH] Publication ready version (#23)
* renamed scores to penalties, renamed --n_threads to --threads and some changes to the graph
* renamed overshadowing names
* renaming
* some further minor code reformatting
* updated docs
* updated output.md
* updated workflow.png
* updated readme
* changed how dinuc repeats and polyx are counted to make it more intuitive
* tsv output now contains a more intuitive primer name and primers are given in fasta per pool
* fasta output for sanger/qpcr mode
---
README.md | 1 -
docs/FAQ.md | 2 +-
docs/how_varvamp_works.md | 26 ++---
docs/output.md | 31 +++---
docs/usage.md | 2 +-
docs/wet_lab_protocol.md | 2 +-
docs/workflow.png | Bin 805213 -> 104349 bytes
varvamp/__init__.py | 2 +-
varvamp/command.py | 18 ++--
varvamp/scripts/alignment.py | 17 ++--
varvamp/scripts/blast.py | 6 +-
varvamp/scripts/config.py | 6 +-
varvamp/scripts/consensus.py | 6 +-
varvamp/scripts/logging.py | 74 ++++++++++----
varvamp/scripts/param_estimation.py | 6 +-
varvamp/scripts/primers.py | 59 ++++++-----
varvamp/scripts/qpcr.py | 91 +++++++++--------
varvamp/scripts/regions.py | 6 +-
varvamp/scripts/reporting.py | 151 +++++++++++++++-------------
varvamp/scripts/scheme.py | 86 ++++++++--------
20 files changed, 320 insertions(+), 272 deletions(-)
diff --git a/README.md b/README.md
index d65a500..6b0f17a 100644
--- a/README.md
+++ b/README.md
@@ -41,7 +41,6 @@ This program is currently being developed and in an alpha state. You are welcome
* [How it works](https://github.com/jonas-fuchs/varVAMP/blob/master/docs/how_varvamp_works.md)
* [FAQ](https://github.com/jonas-fuchs/varVAMP/blob/master/docs/FAQ.md)
-
---
**Important disclaimer:**
diff --git a/docs/FAQ.md b/docs/FAQ.md
index a4a9d2b..8ed1048 100644
--- a/docs/FAQ.md
+++ b/docs/FAQ.md
@@ -18,7 +18,7 @@ In your case varVAMP could not find suitable replacement primers in the TILED mo
4. **I have multiple hits after SANGER/QPCR mode. Which should I use?**
-varVAMP sorts all amplicons and qpcr designs by score and always assigns the lowest number to the best one of non-overlapping amplicons/qpcr schemes. If you are not interested in a specific gene region, amplicon_0 or qpcr_scheme_0 are your best candidates!
+varVAMP sorts all amplicons and qpcr designs by their penalty and always assigns the lowest number to the one with the lowest penalty of the non-overlapping amplicons/qpcr schemes. If you are not interested in a specific gene region, amplicon_0 or qpcr_scheme_0 are your best candidates!
5. **What is deltaG reported for the QPCR mode?**
diff --git a/docs/how_varvamp_works.md b/docs/how_varvamp_works.md
index 610ea36..8db0b79 100644
--- a/docs/how_varvamp_works.md
+++ b/docs/how_varvamp_works.md
@@ -23,28 +23,28 @@ varVAMP searches for potential primer regions as defined by a user-defined numbe
varVAMP uses [`primer3-py`](https://pypi.org/project/primer3-py/) to search for potential primers. Some of the evaluation process, determining if primers match certain criteria, was adapted from [`primalscheme`](www.github.com/aresti/primalscheme). The primer search contains multiple steps:
1. Digest the primer regions into kmers with the min and max length of primers. This is performed on a consensus sequence that does not contain ambiguous characters but is just the majority consensus of the alignment. Therefore, primer parameters will be later calculated for the best fitting primer.
2. Evaluate if these kmers are potential primers independent of their orientation (temperature, GC, size, poly-x repeats and poly dinucleotide repeats) and dependent on their orientation (secondary structure, GC clamp, number of GCs in the last 5 bases of the 3' end and min 3' nucleotides without an ambiguous base). Filter for kmers that satisfy all constraints and calculate their penalties (explained in the last section).
-3. Sanger and tiled mode: Find lowest scoring primer. varVAMP sorts the primers by their score and always takes the best scoring if middle third of the primer has not been covered by a better primer. This greatly reduces the complexity of the later amplicon search while only retaining the best scoring primer of a set of overlapping primers.
+3. Sanger and tiled mode: Find primer with the lowest penalty. varVAMP sorts the primers by their penalty and always takes one with the lowest penalty if middle third of the primer has not been covered by a primer with a lower penalty. This greatly reduces the complexity of the later amplicon search while only retaining the best primer of a set of overlapping primers.
### Amplicon search
#### Amplicon-tiling
-To search for the best scoring amplicon, varVAMP uses a graph based approach.
+To search for the best amplicon, varVAMP uses a graph based approach.
1. Create all possible amplicons with the given length constraints and ensure that primer pairs are not forming dimers.
-2. Create a graph containing all amplicons and their potential neighboring amplicons. To design a good scheme, the next primer has to lie within the second half of the current primer and satisfy the overlap constraint. The cost to go to a neighboring amplicon is determined by the amplicon score.
+2. Create a graph containing all amplicons and their potential neighboring amplicons. To design a good scheme, the next primer has to lie within the second half of the current primer and satisfy the overlap constraint. The cost to go to a neighboring amplicon is determined by the amplicon penalty.
3. Use the [Dijkstra algorithm](https://en.wikipedia.org/wiki/Dijkstra%27s_algorithm) to find the path with the lowest costs from a given start node.
4. Determine potential stop nodes as amplicons with the furthest stop in the alignment.
-5. Determine shortest paths between the start and all potential stop nodes. Get the lowest scoring.
-6. Repeat steps 3-5 for each start node until the best coverage is reached. Voila! We have the best scoring amplicon scheme!
-7. Lastly, the best scoring scheme is evaluated for primer dimers in their respective pools. If a primer dimer pair is found, varVAMP evaluates for each primer their overlapping and previously not considered primers (primer search step 2) and again minimizes the score. The scheme and all primers are updated. If no alternative primers can be found, varVAMP issues a warning and reports the unsolvable primer dimers.
+5. Determine shortest paths between the start and all potential stop nodes. Get the lowest cost.
+6. Repeat steps 3-5 for each start node until the best coverage is reached. Voila! We have the best amplicon scheme with the lowest cumulative primer penalties in respect to the amplicon length!
+7. Lastly, the best scheme is evaluated for primer dimers in their respective pools. If a primer dimer pair is found, varVAMP evaluates for each primer their overlapping and previously not considered primers (primer search step 2) and again minimizes the penalty. The scheme and all primers are updated. If no alternative primers can be found, varVAMP issues a warning and reports the unsolvable primer dimers.
#### Sanger sequencing
-1. varVAMP sorts all amplicons by their score and takes the non-overlapping amplicon with the lowest score!
-2. As varVAMP gives a size penalty to amplicons, varVAMP automatically finds amplicons with low primer scores close to your optimal length (if possible).
+1. varVAMP sorts all amplicons by their penalties and takes the non-overlapping amplicon with the lowest penalty!
+2. As varVAMP gives a size penalty to amplicons, varVAMP automatically finds amplicons with low primer penalties close to your optimal length (if possible).
#### primer BLAST module
1. varVAMP generates a fasta query and searches for possible hits with the same settings as [primer blast](https://bmcbioinformatics.biomedcentral.com/articles/10.1186/1471-2105-13-134).
2. For each amplicon varVAMP searches for off-targets, defined as hits in the db that are the maximum amplicons length multiplied by `BLAST_SIZE_MULTI` apart from each other.
-3. varVAMP appends a high penalty score to the amplicons score if these producing off-targets. This ensures that all other available amplicons are preferentially used.
+3. varVAMP appends a high penalty to the amplicons if these produce off-targets. This ensures that all other available amplicons are preferentially used.
4. Reports if amplicons with off-targets are in the final scheme.
#### qPCR
@@ -62,24 +62,24 @@ To search for the best scoring amplicon, varVAMP uses a graph based approach.
```python
PRIMER_MAX_BASE_PENALTY
```
-Each primer is scored for its deviation from the optimal size, GC content and temperature. Base penalty is the sum of these deviations. Primer base penalties higher than the max base penalty are excluded.
+Each primer is penalized for its deviation from the optimal size, GC content and temperature. Base penalty is the sum of these deviations. Primer base penalties higher than the max base penalty are excluded.
```python
PRIMER_3_PENALTY
```
-Each position in the primer is scored for mismatches in all sequences. If a 3' penalty is given the first in the tuple is multiplied with the frequency mismatch at the very 3' end. The next is multiplied with the -1 freq and so on. Increase penalty if you want to shift amplicons towards best 3' matching. Set the `PRIMER_3_PENALTY` to 0 if you do not care about 3' mismatches.
+Each position in the primer is penalized for mismatches in all sequences. If a 3' penalty is given the first in the tuple is multiplied with the frequency mismatch at the very 3' end. The next is multiplied with the -1 freq and so on. Increase penalty if you want to shift amplicons towards best 3' matching. Set the `PRIMER_3_PENALTY` to 0 if you do not care about 3' mismatches.
```python3
PRIMER_PERMUTATION_PENALTY
```
The number of permutations of a primer is multiplied by the penalty. For example 24 permutations and a penalty of 0.1 will yield a penalty of 2.4. Set `PRIMER_PERMUTATION_PENALTY` to 0 if you do not care about the number of permutations.
-All scores of a primer are summed up and yield a final score. The score for each amplicon is then the score of its LEFT + RIGHT primers multiplied by the fold increase of the amplicon length compared to the optional length. This insures that in the final scheme not only large amplicons are used.
+All penalties of a primer are summed up and yield a final penalty. The penalty for each amplicon is then the penalty of its LEFT + RIGHT primers multiplied by the fold increase of the amplicon length compared to the optional length. This insures that in the final scheme not only large amplicons are used.
```python3
BLAST_PENALTY
```
-If the `-db` argument is used, varVAMP will perform a BLAST search and evaluate off-targets against this database for each amplicon. If an off-target effect is predicted varVAMP will add this penalty to the amplicon score. This insures that this amplicon is only considered if no other amplicons are in this alignment region.
+If the `-db` argument is used, varVAMP will perform a BLAST search and evaluate off-targets against this database for each amplicon. If an off-target effect is predicted varVAMP will add this penalty to the amplicon penalty. This insures that this amplicon is only considered if no other amplicons are in this alignment region.
#### [Previous: Wet lab protocol](./wet_lab_protocol.md) [Next: FAQ](./FAQ.md)
diff --git a/docs/output.md b/docs/output.md
index 505354d..c779d38 100644
--- a/docs/output.md
+++ b/docs/output.md
@@ -3,22 +3,25 @@
varVAMP produces multiple main output files:
-| Mode | Output | Description |
-| --- | --- | --- |
-| ALL | ambiguous_consensus.fasta | The consensus sequence containing ambiguous nucleotides. |
-| ALL | amplicon_plot.pdf | A nice overview for your final amplicon design. |
-| ALL| amplicons.bed | A bed file showing the amplicon location compared to the consensus sequence. |
-| ALL| per_base_mismatches.pdf | Barplot of the percent mismatches at each nucleotide position of the primer. |
-| ALL | primers.bed | A bed file with the primer locations. Includes the primer score. The lower, the better. |
-| ALL | varvamp_log.txt | Log file. |
-| TILED | unsolvable_primer_dimers.tsv | Only produced if there are primer dimers without replacements. Tells which primers form dimers and at which temperature.
-| TILED/SANGER | primer_to_amplicon_assignments.tabular | Simple tab separated file, which primers belong together. Useful for bioinformatic workflows that include primer trimming |
-| TILED/SANGER | primer.tsv | A tab separated file with important parameters for the primers including the sequence with ambiguous nucleotides (already in the right strand) and the gc and temperature of the best fitting primer as well as for the mean for all permutations of the primer. |
-| QPCR | qpcr_design.tsv | A tab separated file with important parameters for the qPCR amplicon including the deltaG. |
-| QPCR | qpcr_primers.tsv | A tab separated file with important parameters for the primers and probes including the sequence with ambiguous nucleotides (already in the right strand) and the gc and temperature of the best fitting primer and probe as well as for the mean for all permutations. |
+| Mode | Output | Description |
+|--------------|----------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| ALL | ambiguous_consensus.fasta | The consensus sequence containing ambiguous nucleotides. |
+| ALL | amplicon_plot.pdf | A nice overview for your final amplicon design. |
+| ALL | amplicons.bed | A bed file showing the amplicon location compared to the consensus sequence. |
+| ALL | per_base_mismatches.pdf | Barplot of the percent mismatches at each nucleotide position of the primer. |
+| ALL | primers.bed | A bed file with the primer locations. Includes the primer penalty. The lower, the better. |
+| ALL | varvamp_log.txt | Log file. |
+| TILED | unsolvable_primer_dimers.tsv | Only produced if there are primer dimers without replacements. Tells which primers form dimers and at which temperature. |
+| TILED | primers_pool_0/1.fasta | Primer sequences per pool in fasta format. |
+| SANGER | primers.fasta | Primer sequences in fasta format. |
+| TILED/SANGER | primer_to_amplicon_assignments.tabular | Simple tab separated file, which primers belong together. Useful for bioinformatic workflows that include primer trimming |
+| TILED/SANGER | primer.tsv | A tab separated file with important parameters for the primers including the sequence with ambiguous nucleotides (already in the right strand) and the gc and temperature of the best fitting primer as well as for the mean for all permutations of the primer. |
+| QPCR | qpcr_design.tsv | A tab separated file with important parameters for the qPCR amplicon including the deltaG. |
+| QPCR | qpcr_primers.tsv | A tab separated file with important parameters for the primers and probes including the sequence with ambiguous nucleotides (already in the right strand) and the gc and temperature of the best fitting primer and probe as well as for the mean for all permutations. |
+| QPCR | oligos.fasta | Oligo sequences in fasta format. |
-It also produces some secondary output files [*data/*]:
+It also produces some secondary output files in `data` :
| Mode | Output | Description |
| --- | --- | --- |
diff --git a/docs/usage.md b/docs/usage.md
index 0c56fc9..0f1d29f 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -149,7 +149,7 @@ BLAST_SETTINGS = { # blast settings for query search
}
BLAST_MAX_DIFF = 0.8 # allowed % differences between primer and BLAST hit
BLAST_SIZE_MULTI = 2 # multiplier for the max_amp size of off targets (in relation to max amp size)
-BLAST_PENALTY = 50 # amplicon score increase -> considered only if no other possibilities
+BLAST_PENALTY = 50 # amplicon penalty increase -> considered only if no other possibilities
```
To apply these new settings just repeat the installation procedure in the varVAMP dir:
```shell
diff --git a/docs/wet_lab_protocol.md b/docs/wet_lab_protocol.md
index 9669eac..f6800f5 100644
--- a/docs/wet_lab_protocol.md
+++ b/docs/wet_lab_protocol.md
@@ -10,7 +10,7 @@ The QIAmp Viral RNA Kit was used to isolate RNA out of viral supernatant followi
• Elute in 60 µl Buffer AVE
-Thanks to Mathias Schmmerer for providing HepE infected cell cultures.
+Thanks to Mathias Schemmerer for providing HepE infected cell cultures.
## Amplicon Generation by SuperScript-IV One-Step-PCR
The RNA amplification was performed with the following approach and PCR protocol for every single amplicon.
diff --git a/docs/workflow.png b/docs/workflow.png
index db35b72e1804bdb2cf8382b41383ad4fee3a97c5..ab554e14d7d35882271ac047e78d072c9d179f5a 100644
GIT binary patch
literal 104349
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