Difference between revisions of "GBrowse Tutorial"

From GMOD
Jump to: navigation, search
m
m
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{| class="tutorialheader"
+
There are several [[GBrowse]] tutorials:
| align="right" | {{#icon: 2009SummerSchoolAmericas170.png|2009 GMOD Summer School - Americas|120|2009 GMOD Summer School - Americas}}<br /><br />{{#icon: GMOD2009Europe170.png|2009 GMOD Summer School - Europe|120|2009 GMOD Summer School - Europe}}
+
| {{TutorialTitleLine|[[GBrowse]]}}<br />
+
2009 [[GMOD Summer School]] - [[2009 GMOD Summer School - Europe|Europe]] & [[2009 GMOD Summer School - Americas|Americas]]<br />
+
July & August 2009<br />
+
[[User:Scott|Scott Cain]]
+
|}
+
__NOTITLE__
+
  
 +
; [[GBrowse Tutorial 2012|GBrowse tutorial from 2013 GMOD Summer School]]
 +
: This tutorial was taught by [[User:Scott|Scott Cain]] at the [[2013 GMOD Summer School]] and the [[2012 GMOD Summer School]]. It demonstrates setting up, configuring and using [[GBrowse]] with some sample data. GBrowse is provided on an Amazon Machine Image: see [[Cloud|GMOD in the Cloud]] for more information on getting a GMOD AMI.
 +
 +
; [[GBrowse Tutorial 2010|GBrowse tutorial from 2010 GMOD Summer School]]
 +
: This tutorial was originally taught by [[User:Scott|Scott Cain]] at the [[2010 GMOD Summer School - Americas]].  It walks you through setting up and running [[GBrowse]] with some sample data.  It provides a [[VMware]] image to work on, and relies heavily on the {{GBrowseAdminTutorialLink|GBrowse Administration Tutorial}}.
  
<div class="emphasisbox">
 
<center><span style="font-size: 140%">There are several [[GBrowse]] [[:Category:Tutorials|tutorials]]:</span></center>
 
 
; [http://www.openhelix.com/gbrowse GBrowse User Tutorial] at [http://www.openhelix.com OpenHelix]
 
; [http://www.openhelix.com/gbrowse GBrowse User Tutorial] at [http://www.openhelix.com OpenHelix]
 
: Demonstrates the GBrowse ''user'' interface.
 
: Demonstrates the GBrowse ''user'' interface.
  
 
; {{GBrowseAdminTutorialLink|GBrowse Administration Tutorial}}
 
; {{GBrowseAdminTutorialLink|GBrowse Administration Tutorial}}
: Step by step guide on how to configure and load data into GBrowse.
+
: Step by step guide on how to configure and load data into [[GBrowse]].  Administration tutorials are available for both the {{GBrowseAdminTutorialLink|current version}}, and the earlier {{GBrowse1AdminTutorialLink|1.x versions}}.
  
 
; [[GBrowse NGS Tutorial]]
 
; [[GBrowse NGS Tutorial]]
 
: Instructions on how to visualize [[next generation sequencing]] data in GBrowse using [http://samtools.sourceforge.net SAMtools].  The tutorial includes a starting [[VMware]] image, and uses the example data that comes with SAMtools.
 
: Instructions on how to visualize [[next generation sequencing]] data in GBrowse using [http://samtools.sourceforge.net SAMtools].  The tutorial includes a starting [[VMware]] image, and uses the example data that comes with SAMtools.
  
; This tutorial
+
; [http://youtu.be/jxA6VMN97Y8 GBrowse video tutorial]
: This tutorial was originally taught by [[User:Scott|Scott Cain]] at the [[2009 GMOD Summer School - Europe]].  It walks you through setting up and running [[GBrowse]] with some sample data.  It provides a [[VMware]] image to work on, and relies heavily on the {{GBrowseAdminTutorialLink|GBrowse Administration Tutorial}}.
+
: Produced by [http://eupathdb.org EuPathDB]; please direct praise and thanks to them!
 
+
: '''Note:''' This tutorial was also taught at the [[2009 GMOD Summer School - Americas]], but the notes and system image used here are from the [[2009 GMOD Summer School - Europe|Europe course]].
+
</div>
+
 
+
 
+
__TOC__
+
 
+
 
+
= VMware =
+
{|
+
| valign="top" |This tutorial was taught using a [[VMware]] system image as a starting point.  If you want to start with that same system, download and install the ''Starting'' image.  There is also an ''Ending'' image for this tutorial, which contains the system after this tutorial (and the [[GBrowse_syn Tutorial]]) have been finished.
+
 
+
'''''See [[VMware]] for what software you need to use a VMware system image, and for directions on how to get the image setup and running on your machine.'''''
+
|
+
{| style="margin-left: 1em; margin-top: 0; " class="wikitable"
+
! Download
+
|-
+
| align="center" | [ftp://ftp.gmod.org/pub/gmod/Courses/2009/SummerSchoolEurope/GmodSumSch2009EU2.zip Starting&nbsp;Image]<br>
+
[ftp://ftp.gmod.org/pub/gmod/Courses/2009/SummerSchoolEurope/GmodSumSch2009EU3.tar.gz Ending Image]<br />
+
----
+
Username:&nbsp;gmod<br />Password: gmod
+
|}
+
|}
+
 
+
= Caveats =
+
{{TutorialCaveats}}
+
 
+
=Prerequisites=
+
 
+
Most installed before using apt or cpan
+
 
+
<div class="emphasisbox">
+
Should be able to install Bio::Graphics via cpan like such:
+
 
+
  cpan> install Bio::Graphics
+
 
+
Weirdly, cpan thinks that BioPerl 1.6 is not installed yet, so it will install it, as well as updating Data::Stag (it will take a few minutes and requires cpan)
+
 
+
(In hindsight, the apt-get of libgd-tools below ''might'' have fixed this problem.)
+
</div>
+
 
+
Instead get it the source from http://search.cpan.org/CPAN/authors/id/L/LD/LDS/Bio-Graphics-1.97.tar.gz
+
 
+
If you download that from Firefox, it will put on the desktop.
+
 
+
<bash>cd ~/Desktop
+
tar xzvf Bio-Graphics-1.97.tar.gz
+
cd Bio-Graphics-1.97
+
perl Build.PL
+
./Build
+
./Build test
+
sudo apt-get install libgd-tools
+
./Build test
+
sudo ./Build install
+
</bash>
+
 
+
=Install GBrowse=
+
 
+
*Update [[GBrowse]] [[Glossary#CVS|cvs]] repository (it is an anonymous cvs checkout):
+
  cd ~/software/gbrowse-pre-1.70/
+
  cvs update -d
+
 
+
  perl Makefile.PL
+
  ... accept defaults
+
  make
+
  sudo make install
+
 
+
=Tutorial=
+
 
+
Go to http://localhost/gbrowse
+
 
+
 
+
 
+
=GBrowse2=
+
[[:Category:GBrowse 2|GBrowse 2]] is a re-architecture of [[GBrowse]] that uses [[Glossary#AJAX|AJAX]] techniques to allow independent rendering of tracks and multiple distributed databases.  It is designed to allow the use of load management and distributes processing on a compute farm, which enhanced performance and the user experience.  It is due to be released in late 2009.
+
 
+
We will not cover GBrowse 2 in depth this year but will have a demo, time permitting.
+
 
+
*[[Migrating_from_GBrowse_1.X_to_2.X|transitioning from GBrowse 1.x to 2.x]]
+
*[[Running a GBrowse2 render farm]]
+
*[[GBrowse 2.0 HOWTO]]
+
 
+
=Example Advanced Features=
+
==PrimerDesigner Plugin==
+
[[Image:PrimerDesigner.png|right|border|300px]]
+
<span class="pops">[[GBrowse Plugins]]</span> allow you to add extra functionality to your genome browser.
+
* The [[PrimerDesigner.pm|PrimerDesigner plugin]] used primer3 to design PCR primers for the selected region from within [[GBrowse]].
+
* You can find out how to use and install this plugin, even see a ''fascinating'' video demonstration, <span class="pops">[[PrimerDesigner.pm|on the PrimerDesigner page]]</span>.
+
 
+
==Rubber-Band Select Menus==
+
[[Image:Rubber1.png|right|thumb|250px|An example of a select menu that appears after a region of the details panel is selected]]
+
"Rubber-band", or drag-selection is a user-interface feature of [[GBrowse]] 1.69 and later. It a JavaScript/DHTML-based feature that works in all major web browsers and is turned on by default.
+
 
+
* The rubber-band selection that is activating by dragging your mouse on the scalebar for the details section activated a menu that specifies various operations that can be performed on the selected sequence region.
+
* The [[GBrowse Configuration HOWTO|GBrowse configuration file]] can be used to control the contents and appearance of this menu.
+
* You can also add menus to the scalebar for the overview and regionview panels.
+
* See [[RubberBandSelection]] for more information, including menus, configuration (and a video demo!).
+
<br clear="all" />
+
 
+
=Basic [[Chado]] Configuration (if we have time)=
+
 
+
Normally, we'd need Bio::DB::Das::Chado, but it was installed for [[JBrowse]] [[2009 GMOD Summer School - Europe|yesterday]].
+
 
+
Starting material:
+
 
+
  ~/software/gbrowse-pre-1.70/contrib/conf_files/07.chado.conf /etc/apache2/gbrowse.conf/
+
 
+
Some simple tweaks and additions:
+
 
+
*fix the dbi string
+
*add nucleotide matches
+
 
+
==Materialized views for searching==
+
 
+
[[Chado]] comes with a tool to materialize views written by developers at the [[:Category:SGN|SOL Genomics Network]].  A materialized view is faster (at the expense of more disk space) to search than a regular view (which is really a query over potentially several tables).  To create a materialized view that makes searching a GBrowse Chado instance a faster, we can do this:
+
 
+
  gmod_materialized_view_tool.pl -c
+
 
+
which will ask us several obscure questions for which we need to provide obscure answers:
+
<pre>
+
  Give your materialized view a name (word characters only):
+
  all_feature_names
+
 
+
  Where will this MV be located? (schemaname.tablename):
+
  public.all_feature_names
+
 
+
  A view with this name already exists; do you want to replace it
+
  with a materialized view? [y|n]
+
  y
+
 
+
  How often, in seconds, should the MV be refreshed?
+
  You can also type 'daily', 'weekly', 'monthly' (30 days), or 'yearly' (365 days):
+
  weekly
+
 
+
  Enter specifications for the materialized view, OR provide a file in which
+
  the specs are written ('? for help):
+
  feature_id integer,name varchar(255)
+
 
+
  Enter the SQL query for the materialized view,
+
  or a file containing only the query:
+
  SELECT feature_id,CAST(substring(uniquename from 0 for 255) as varchar(255)) as name FROM feature UNION SELECT feature_id, name FROM feature where name is not null UNION SELECT fs.feature_id,s.name FROM feature_synonym fs, synonym s WHERE fs.synonym_id = s.synonym_id
+
 
+
  Enter a comma separated list of fields to index (or return for none):
+
  feature_id,name
+
 
+
  Enter the SQL queries for special indexes,
+
  or a file containing only the query (or return for none):
+
  create index all_feature_names_lower_name on all_feature_names (lower(name))
+
 
+
  Enter 'y' to confirm, 'n' to re-enter data:
+
  y
+
</pre>
+
  
 
[[Category:Tutorials]]
 
[[Category:Tutorials]]
 
[[Category:GBrowse]]
 
[[Category:GBrowse]]

Latest revision as of 17:10, 18 December 2013

There are several GBrowse tutorials:

GBrowse tutorial from 2013 GMOD Summer School
This tutorial was taught by Scott Cain at the 2013 GMOD Summer School and the 2012 GMOD Summer School. It demonstrates setting up, configuring and using GBrowse with some sample data. GBrowse is provided on an Amazon Machine Image: see GMOD in the Cloud for more information on getting a GMOD AMI.
GBrowse tutorial from 2010 GMOD Summer School
This tutorial was originally taught by Scott Cain at the 2010 GMOD Summer School - Americas. It walks you through setting up and running GBrowse with some sample data. It provides a VMware image to work on, and relies heavily on the GBrowse2 Admin Tutorial.
GBrowse User Tutorial at OpenHelix
Demonstrates the GBrowse user interface.
GBrowse2 Admin Tutorial
Step by step guide on how to configure and load data into GBrowse. Administration tutorials are available for both the GBrowse2 Admin Tutorial, and the earlier 1.x versions.
GBrowse NGS Tutorial
Instructions on how to visualize next generation sequencing data in GBrowse using SAMtools. The tutorial includes a starting VMware image, and uses the example data that comes with SAMtools.
GBrowse video tutorial
Produced by EuPathDB; please direct praise and thanks to them!