Difference between revisions of "PrimerDesigner.pm"

From GMOD
Jump to: navigation, search
m
m
 
(16 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
[[Image:PrimerDesigner.png|right]]
 
[[Image:PrimerDesigner.png|right]]
<font style="font-size:12pt">
 
PrimerDesigner is a [[GBrowse]] plugin, written by Sheldon McKay, that uses use the <span class="pops">[http://primer3.sourceforge.net primer3]</span> program to design PCR primers for selected regions within the genome browser.  Please feel free to [mailto:mckays@cshl.edu,gmod-gbrowse@lists.sourceforge.net?subject=PrimerDesigner%20plugin contact the author] or [mailto:gmod-gbrowse@lists.sourceforge.net?subject=PrimerDesigner%20plugin The Gbrowse mailing list] for help or more information.
 
</font>
 
<br>
 
  
<div class=switch id=video title="Video demonstration">
+
PrimerDesigner is a [[GBrowse]] plugin, written by [[User:mckays|Sheldon McKay]], that uses use the [http://primer3.sourceforge.net primer3] program to design PCR primers for selected regions within the genome browser.  Please feel free to [mailto:mckays@cshl.edu,gmod-gbrowse@lists.sourceforge.net?subject=PrimerDesigner%20plugin contact the author] or [mailto:gmod-gbrowse@lists.sourceforge.net?subject=PrimerDesigner%20plugin The Gbrowse mailing list] for help or more information.
* The video below is a demonstration of designing PCR primers using this GBrowse plugin
+
 
<flash>file=Primers1.swf|scale=exactfit|width=900|height=500|play=false</flash>
+
The video below demonstrates designing PCR primers using the PrimerDesigner plugin.
</div>
+
 
<br><br><br>
+
==How to use the PrimerDesigner plugin==
=How to use the PrimerDesigner plugin=
+
===Accessing the plugin===
==Accessing the plugin==
+
 
*From GBrowse main page, the PrimerDesigner plugin, as well as other installed plugins, can be accessed via the 'Reports and Analysis' menu.
 
*From GBrowse main page, the PrimerDesigner plugin, as well as other installed plugins, can be accessed via the 'Reports and Analysis' menu.
 
*In GBrowse, navigate to the genomic region you are interested in, then select 'Design PCR primers' from the menu and click 'Configure'
 
*In GBrowse, navigate to the genomic region you are interested in, then select 'Design PCR primers' from the menu and click 'Configure'
Line 23: Line 18:
 
[[Image:Zoom_pan.png|border]]
 
[[Image:Zoom_pan.png|border]]
  
==Selecting the target for the PCR primers==
+
===Selecting the target for the PCR primers===
 
* If no target region is specified, primers will be designed to amplify the center of the displayed sequence, indicated by a vertical red line.
 
* If no target region is specified, primers will be designed to amplify the center of the displayed sequence, indicated by a vertical red line.
 
* You can specify the target region for PCR primers using rubber-band selection.
 
* You can specify the target region for PCR primers using rubber-band selection.
Line 36: Line 31:
 
[[Image:Target_Selected.png|border]]
 
[[Image:Target_Selected.png|border]]
  
==PCR primer design parameters==
+
===PCR primer design parameters===
 
* Design parameters, such as primer length, GC content, etc can be configured at the bottom of the page.
 
* Design parameters, such as primer length, GC content, etc can be configured at the bottom of the page.
 
* Each parameter can be clicked for detailed information.
 
* Each parameter can be clicked for detailed information.
Line 44: Line 39:
 
[[Image:PCR_Params.png|border]]
 
[[Image:PCR_Params.png|border]]
  
==Predicted PCR Primer Results==
+
===Predicted PCR Primer Results===
 
* Once you have clicked 'Design Primers', you will see a results page similar to the example below.
 
* Once you have clicked 'Design Primers', you will see a results page similar to the example below.
 
* The PCR primers are mapped back onto the image, so you can see the location of the predicted PCR amplicon.
 
* The PCR primers are mapped back onto the image, so you can see the location of the predicted PCR amplicon.
Line 52: Line 47:
 
[[Image:PCR_Results.png|border]]
 
[[Image:PCR_Results.png|border]]
  
==Note On Quality Scores==
+
===Note On Quality Scores===
 
* Occasionally you will see quality scores flagged in red.
 
* Occasionally you will see quality scores flagged in red.
 
* Optimal primer scores should be less than 1
 
* Optimal primer scores should be less than 1
Line 61: Line 56:
 
[[Image:Uh_oh.png|border]]
 
[[Image:Uh_oh.png|border]]
  
=How to install the PrimerDesigner plugin=
+
==How to install the PrimerDesigner plugin==
First of all, you will need to [[Gbrowse#Installation| install GBrowse]], with all of its prerequisites, such as [[Bioperl#BioPerl_Background|BioPerl]] and [[GMOD News Archives#BioGraphics_now_housed_at_gmod.org|Bio::Graphics]]
+
First of all, you will need to [[Gbrowse#Installation| install GBrowse]], with all of its prerequisites, such as [[Bioperl#BioPerl_Background|BioPerl]] and [[:News/BioGraphics now at gmod.org|Bio::Graphics]]
  
==Dependencies==
+
===Dependencies===
===Primer3===
+
====Primer3====
 
* Follow [http://primer3.sourceforge.net this link] to go the primer website at Sourceforge.
 
* Follow [http://primer3.sourceforge.net this link] to go the primer website at Sourceforge.
 
* Primer3 is a binary executable, developed by Steve Rozen and colleagues, that the PrimerDesigner plugin uses to to the actual work of designing primers
 
* Primer3 is a binary executable, developed by Steve Rozen and colleagues, that the PrimerDesigner plugin uses to to the actual work of designing primers
 
* The plugin passes the DNA sequence and primer design parameters to this program and then parses the results
 
* The plugin passes the DNA sequence and primer design parameters to this program and then parses the results
====Installing Primer3====
+
=====Installing Primer3=====
 
* [http://sourceforge.net/project/showfiles.php?group_id=112461&package_id=211061&release_id=595603 Download or compile] the suitable primer3 binary executable for your website.
 
* [http://sourceforge.net/project/showfiles.php?group_id=112461&package_id=211061&release_id=595603 Download or compile] the suitable primer3 binary executable for your website.
 
* If necessary, change the name of the binary to 'primer3' so that it is recognized by the PrimerDesigner plugin
 
* If necessary, change the name of the binary to 'primer3' so that it is recognized by the PrimerDesigner plugin
 
* The default path for primer is in '/usr/local/bin'.  If you have installed it elsewhere, be sure to the the 'binpath' option (see below) in your configuration file.
 
* The default path for primer is in '/usr/local/bin'.  If you have installed it elsewhere, be sure to the the 'binpath' option (see below) in your configuration file.
  
===Bio::PrimerDesigner===
+
====Bio::PrimerDesigner====
 
* Follow [http://search.cpan.org/dist/Bio-PrimerDesigner this link] for information about the Bio::PrimerDesigner package.
 
* Follow [http://search.cpan.org/dist/Bio-PrimerDesigner this link] for information about the Bio::PrimerDesigner package.
 
* Bio::PrimerDesigner is a set of perl modules that provide a low-level [http://en.wikipedia.org/wiki/API API] for the primer3 program.
 
* Bio::PrimerDesigner is a set of perl modules that provide a low-level [http://en.wikipedia.org/wiki/API API] for the primer3 program.
 
* '''Note: ''' Bio::PrimerDesigner is not part of BioPerl or GBrowse; you will have to install this package for the Primerdesigner plugin to work.
 
* '''Note: ''' Bio::PrimerDesigner is not part of BioPerl or GBrowse; you will have to install this package for the Primerdesigner plugin to work.
====Installing Bio::PrimerDesigner====
+
=====Installing Bio::PrimerDesigner=====
 
* Bio::PrimerDesigner is on CPAN (the '''C'''omprehensive '''P'''erl '''A'''rchive '''N'''etwork).
 
* Bio::PrimerDesigner is on CPAN (the '''C'''omprehensive '''P'''erl '''A'''rchive '''N'''etwork).
 
* To install it, you can use the [http://www.troubleshooters.com/codecorn/littperl/perlcpan.htm CPAN shell].
 
* To install it, you can use the [http://www.troubleshooters.com/codecorn/littperl/perlcpan.htm CPAN shell].
  
==Configuration==
+
===Configuration===
===The Configuration File===
+
====The Configuration File====
====Activating the Plugin====
+
=====Activating the Plugin=====
 
To activate the Primer Designer plugin, simple add its name to the list of available plugins in the configuration file for you data source.
 
To activate the Primer Designer plugin, simple add its name to the list of available plugins in the configuration file for you data source.
  
Line 98: Line 93:
 
'''NOTE:''' For this plugin to work properly, you must ensure that all dependencies (described above) are that the GBrowse database has DNA sequence.
 
'''NOTE:''' For this plugin to work properly, you must ensure that all dependencies (described above) are that the GBrowse database has DNA sequence.
  
====Configurable Options====
+
=====Configurable Options=====
 
To configure the plugin, add a stanza like this at the end of your [GENERAL] section:
 
To configure the plugin, add a stanza like this at the end of your [GENERAL] section:
  
Line 113: Line 108:
 
:The default value is 'local'
 
:The default value is 'local'
 
:Recognized options are 'local' (primer3 installed on the same server as Gbrowse) or remote (primer3 is installed on another server).
 
:Recognized options are 'local' (primer3 installed on the same server as Gbrowse) or remote (primer3 is installed on another server).
:The 'remote' method is implicit if the binpath option is set to a URL beginning with <nowiki>'http://'</nowiki>
+
:The 'remote' method is implicit if the binpath option is set to a URL beginning with  
 +
<nowiki>'http://'</nowiki>  
 
;default size
 
;default size
 
:The default value is 10_000
 
:The default value is 10_000
Line 127: Line 123:
 
:You must check the site to see if there is a genome sequence for you species and modify the above example accordingly
 
:You must check the site to see if there is a genome sequence for you species and modify the above example accordingly
  
 +
== PrimerDesigner and [[GBrowse]] 2 ==
 +
 +
The PrimerDesigner plugin does not work with [[GBrowse]] 2.00.  Work is currently underway to fix this before the next release of GBrowse.
 +
 +
[[Category:GBrowse Plugins]]
 
[[Category:GBrowse]]
 
[[Category:GBrowse]]
 
[[Category:HOWTO]]
 
[[Category:HOWTO]]
 
[[Category:Help]]
 
[[Category:Help]]

Latest revision as of 11:19, 22 August 2013

PrimerDesigner.png

PrimerDesigner is a GBrowse plugin, written by Sheldon McKay, that uses use the primer3 program to design PCR primers for selected regions within the genome browser. Please feel free to contact the author or The Gbrowse mailing list for help or more information.

The video below demonstrates designing PCR primers using the PrimerDesigner plugin.

How to use the PrimerDesigner plugin

Accessing the plugin

  • From GBrowse main page, the PrimerDesigner plugin, as well as other installed plugins, can be accessed via the 'Reports and Analysis' menu.
  • In GBrowse, navigate to the genomic region you are interested in, then select 'Design PCR primers' from the menu and click 'Configure'

Reports and Analysis.png

  • You will then see a view similar to this:

PrimerDesigner Front.png

  • At the top right corner is a navigation menu that allows you to zoom and pan the displayed segment in a manner similar to the main Gbrowse user interface.

Zoom pan.png

Selecting the target for the PCR primers

  • If no target region is specified, primers will be designed to amplify the center of the displayed sequence, indicated by a vertical red line.
  • You can specify the target region for PCR primers using rubber-band selection.
  • To activate this feature, point your mouse on the scale bar at the top of the image and click your mouse-button down, without releasing it.
  • Then drag your mouse to the left or right to highlight the region or annotations you are interested in.
  • In the example below, the first exon of gene F29C4.2 is highlighted with rubber-band selection.

Target Highlight.png

  • Once you are done selecting, release the mouse button and the page will reload with the selected region targeted for PCR primers

Target Selected.png

PCR primer design parameters

  • Design parameters, such as primer length, GC content, etc can be configured at the bottom of the page.
  • Each parameter can be clicked for detailed information.
  • Reasonable default options are provided for each parameter. These options usually work but can be adjusted as desired.
  • The size of the PCR product is calculated based on the size of the selected region. This can be manually adjusted, if desired.

PCR Params.png

Predicted PCR Primer Results

  • Once you have clicked 'Design Primers', you will see a results page similar to the example below.
  • The PCR primers are mapped back onto the image, so you can see the location of the predicted PCR amplicon.
  • Below the image, primer statistics are show.
  • You can also click to expand the sections marked with the [+] icon for more detailed reports.

PCR Results.png

Note On Quality Scores

  • Occasionally you will see quality scores flagged in red.
  • Optimal primer scores should be less than 1
  • Higher scores often result from minor departures from optimality criteria such as primer length, GC content, etc.
  • If the primers do not fall to far outside of the requested parameters, it is not serious.
  • However, being mindful that the primers are only as good as the available sequence will allow, making changes to the allowed product size range or target coordinates will permit more optimal primers to be selected.

Uh oh.png

How to install the PrimerDesigner plugin

First of all, you will need to install GBrowse, with all of its prerequisites, such as BioPerl and Bio::Graphics

Dependencies

Primer3

  • Follow this link to go the primer website at Sourceforge.
  • Primer3 is a binary executable, developed by Steve Rozen and colleagues, that the PrimerDesigner plugin uses to to the actual work of designing primers
  • The plugin passes the DNA sequence and primer design parameters to this program and then parses the results
Installing Primer3
  • Download or compile the suitable primer3 binary executable for your website.
  • If necessary, change the name of the binary to 'primer3' so that it is recognized by the PrimerDesigner plugin
  • The default path for primer is in '/usr/local/bin'. If you have installed it elsewhere, be sure to the the 'binpath' option (see below) in your configuration file.

Bio::PrimerDesigner

  • Follow this link for information about the Bio::PrimerDesigner package.
  • Bio::PrimerDesigner is a set of perl modules that provide a low-level API for the primer3 program.
  • Note: Bio::PrimerDesigner is not part of BioPerl or GBrowse; you will have to install this package for the Primerdesigner plugin to work.
Installing Bio::PrimerDesigner
  • Bio::PrimerDesigner is on CPAN (the Comprehensive Perl Archive Network).
  • To install it, you can use the CPAN shell.

Configuration

The Configuration File

Activating the Plugin

To activate the Primer Designer plugin, simple add its name to the list of available plugins in the configuration file for you data source.

For example:


# Installed plugins
plugins = Spectrogram SequenceDumper PrimerDesigner

NOTE: For this plugin to work properly, you must ensure that all dependencies (described above) are that the GBrowse database has DNA sequence.

Configurable Options

To configure the plugin, add a stanza like this at the end of your [GENERAL] section:

[PrimerDesigner:plugin]
binpath = /usr/bin/
method  = local
ispcr   = http://genome.ucsc.edu/cgi-bin/hgPcr?db=cb3
binpath
The default value is '/usr/local/bin'
Use this option to specify where the primer3 binary is located, if not in the default '/usr/local/bin'
If you are using a remote URL (primer3 is installed on another server), specify a URL instead.
method
The default value is 'local'
Recognized options are 'local' (primer3 installed on the same server as Gbrowse) or remote (primer3 is installed on another server).
The 'remote' method is implicit if the binpath option is set to a URL beginning with

'http://'

default size
The default value is 10_000
This option specifies the default segment size to show in the PrimerDesigner image
max range
The default value is 300
This option species the degree to which the PCR product size can depart from the optimal size, as determined by the size of the selected target area for PCR primers.
ispcr
This option can be set to a URL that point to the UCSC in silico PCR sight.
If selected, in silico PCR results will be reported in the output of this plugin
These results help to determine if the correct amplicon is found and also indicate whether other PCR products

are amplified by the primer pair.

You must check the site to see if there is a genome sequence for you species and modify the above example accordingly

PrimerDesigner and GBrowse 2

The PrimerDesigner plugin does not work with GBrowse 2.00. Work is currently underway to fix this before the next release of GBrowse.