https://github.com/edinburgh-genome-foundry/primavera

:cherry_blossom: Python library for primer-based verification of DNA assemblies: primer selection, data analyis, etc.
https://github.com/edinburgh-genome-foundry/primavera

dna-assembly primer-design sequencing synthetic-biology

Last synced: 13 days ago
JSON representation

:cherry_blossom: Python library for primer-based verification of DNA assemblies: primer selection, data analyis, etc.

• Host: GitHub
• URL: https://github.com/edinburgh-genome-foundry/primavera
• Owner: Edinburgh-Genome-Foundry
• License: mit
• Created: 2017-11-02T22:06:34.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2025-04-09T15:03:50.000Z (15 days ago)
• Last Synced: 2025-04-09T15:07:07.613Z (15 days ago)
• Topics: dna-assembly, primer-design, sequencing, synthetic-biology
• Language: Python
• Homepage: https://edinburgh-genome-foundry.github.io/Primavera/
• Size: 2.6 MB
• Stars: 33
• Watchers: 9
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst

Awesome Lists containing this project

README

        
.. raw:: html

    


    

    



    


.. image:: https://github.com/Edinburgh-Genome-Foundry/Primavera/actions/workflows/build.yml/badge.svg

    :target: https://github.com/Edinburgh-Genome-Foundry/Primavera/actions/workflows/build.yml

    :alt: GitHub CI build status

.. image:: https://coveralls.io/repos/github/Edinburgh-Genome-Foundry/Primavera/badge.svg?branch=master

   :target: https://coveralls.io/github/Edinburgh-Genome-Foundry/Primavera?branch=master

Primavera is a Python library to plan and analyze primer-based verification of DNA assemblies, using Sanger sequencing or verification PCR. It implements methods to design and select primers to ensure that the relevant assembly segments will be covered, and can generate simple (but approximative) plots summarizing the results of a batch of Sanger sequencing.

You can see a live-demo for primer selection `on EGF CUBA: Select Primers `_.

Documentation: `API reference `_

Usage

-----

**Primer selection**

The following code assumes that a file ``available_primers.fa`` contains the labels and sequences of all available primers in the lab, and that the assemblies to be sequence-verified have annotations indicating the zones that the sequencing should cover and zones where primer annealing should be avoided.

.. image:: https://raw.githubusercontent.com/Edinburgh-Genome-Foundry/Primavera/master/docs/_static/images/annotated_genbank.png

   :width: 600px

.. code:: python

    from primavera import PrimerSelector, Primer, load_record

    import os

    # LOAD ASSEMBLIES RECORDS AND AVAILABLE PRIMERS

    records = [load_record(file_path, linear=False)

               for file_path in ['my_record_1.gb', 'my_record_2.gb']]  # etc

    available_primers = Primer.list_from_fasta('example_primers.fa')

    # SELECT THE BEST PRIMERS

    selector = PrimerSelector(tm_range=(55, 70), size_range=(16, 25))

    selected_primers = selector.select_primers(records, available_primers)

    # PLOT THE COVERAGE AND WRITE THE PRIMERS IN A SPREADSHEET

    selector.plot_coverage(records, selected_primers, 'coverage.pdf')

    selector.write_primers_table(selected_primers, 'selected_primers.csv')

The returned ``selected_primers`` contains a list of lists of primers (one list for each construct). The PDF report returned looks like this:

.. image:: https://raw.githubusercontent.com/Edinburgh-Genome-Foundry/Primavera/master/docs/_static/images/annotated_primer_selection.png

   :width: 600px

Installation

------------

You can install Primavera through PIP:

.. code::

    pip install primavera

You will also need to install the NCBI-BLAST+ software. For instance on Ubuntu:

.. code:: shell

    apt-get install ncbi-blast+

License = MIT

-------------

Primavera is an open-source software originally written at the `Edinburgh Genome Foundry `_ by `Zulko `_ and `released on Github `_ under the MIT licence (Copyright 2017 Edinburgh Genome Foundry, University of Edinburgh). Everyone is welcome to contribute!

More biology software

---------------------

.. image:: https://raw.githubusercontent.com/Edinburgh-Genome-Foundry/Edinburgh-Genome-Foundry.github.io/master/static/imgs/logos/egf-codon-horizontal.png

 :target: https://edinburgh-genome-foundry.github.io/

Primavera is part of the `EGF Codons `_ synthetic biology software suite for DNA design, manufacturing and validation.