Difference between revisions of "EPIC-CoGe Tutorial"

From CoGepedia
Jump to: navigation, search
(Adding private data)
 
(11 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
{|
 +
|<center>Demo of Quantitative Data:</center>
 +
|<center>Demo of SNP Data:</center>
 +
|<center>Demo of Loading Data:</center>
 +
|-
 +
|{{#ev:youtube|WlVXwyo4mZM|300}}
 +
|{{#ev:youtube|JQ_xKH1sxy8|300}}
 +
|{{#ev:youtube|Yx0QGpcJ34Q|300}}
 +
|-
 +
|+ '''---=== Try EPIC-CoGe: http://genomevolution.org/r/939v ===---'''
 +
|}
  
==Overview==
 
{{#ev:youtube|uFfArVc3w04|500px|thumb|right|Video tutorial of EPIC-CoGe Browser!}}
 
This tutorial is aimed at providing an introductory overview of new features in CoGe for the [[EPIC-CoGe]] system.  These include:
 
# CoGe [[User accounts]]
 
# Adding private/restricted [[experiment data]] (in this case, epigenetic data)
 
# Creating [[Notebooks]] of collections of data
 
# Visualizing experimental data with CoGe's implementation of [http://jbrowse.org/ JBrowse]
 
# [[Sharing data]] with collaborators
 
  
Each section has a brief overview of the process and a video on how to do it.
 
  
 +
== Overview ==
  
==User accounts==
+
This tutorial is aimed at providing an introductory overview of new features in CoGe for the [[EPIC-CoGe]] system. These include:
[[File:Screen shot 2013-05-29 at 3.28.04 PM.png|thumb|right|300px|You can find where to log into CoGe at the top of every page.  Also, there is a handy link for getting a CoGe account.]]
+
 
The first thing you will want to do is get a CoGe user account. This is very easy:
+
#CoGe [[User accounts]]
#Register an iPlant account
+
#Adding private/restricted [[Experiment data]] (in this case, epigenetic data)
 +
#Creating [[Notebooks]] of collections of data
 +
#Visualizing experimental data with CoGe's implementation of [http://jbrowse.org/ JBrowse]
 +
#[[Sharing data]] with collaborators
 +
 
 +
Each section has a brief overview of the process and a video on how to do it.
 +
 
 +
<br>
 +
 
 +
== User accounts ==
 +
 
 +
[[Image:Screen shot 2013-05-29 at 3.28.04 PM.png|thumb|right|300px]] The first thing you will want to do is get a CoGe user account. This is very easy:  
 +
 
 +
#Register an iPlant account  
 
#Log in
 
#Log in
[[How to get a CoGe account | More details on how to get a CoGe account]]
 
  
By having a user account, you will be able to:
+
[[How to get a CoGe account|More details on how to get a CoGe account]]
* Add private data to CoGe
+
* Share private data with other users
+
* Create notebooks (collections of data -- experiments and genomes)
+
* Have CoGe track your analytical history (makes it easy to revisit old analyses)
+
  
==Adding private data==
+
By having a user account, you will be able to:
[[File:Screen shot 2013-05-29 at 11.57.01 AM.png|thumb|right|200px|"Create" menu on [[user profile]] to add new data to CoGe]]
+
  
[[File:Screen shot 2013-05-29 at 3.09.57 PM.png|thumb|right|300px|Adding an epigenetics experiment to the genome of Arabidopsis thaliana]]
+
*Add private data to CoGe
 +
*Share private data with other users
 +
*Create notebooks (collections of data -- experiments and genomes)
 +
*Have CoGe track your analytical history (makes it easy to revisit old analyses)
  
[[File:Screen shot 2013-05-29 at 3.15.38 PM.png|thumb|right|300px|Additional annotations added for an experiment to provide provenance and detailed [[metadata]]. ]]
+
== Adding private data ==
 +
'''Get Example Data''': [[Example data for EPIC-CoGe]]
  
[[File:Screen shot 2013-05-29 at 3.12.23 PM.png|thumb|right|300px|Experiment highlighted in user profile where it can be easily shared with other users]]
+
[[Image:Screen shot 2013-05-29 at 11.57.01 AM.png|thumb|right|200px]]  
  
Once you have a CoGe account, you can add new data to CoGe.  To do this:
+
[[Image:Screen shot 2013-05-29 at 3.09.57 PM.png|thumb|right|300px]]  
# Go to your [[user profile]] (click on "My Profile" located in the menu at the top-right of any CoGe page)
+
# Click on the "Create" button to get a menu of things you can create
+
* Select:
+
** [[Load Genome]]: to load in fasta sequences for a genome
+
** [[Load Annotation]]: to add genome annotations in GFF to a previously loaded genome
+
** [[Load Experiment]]: to add quantitative data to an experiment
+
  
===Example with an Arabidopsis Ago4 mutant===
+
[[Image:Screen shot 2013-05-29 at 3.15.38 PM.png|thumb|right|300px]]
  
Here we are going to load in an experiment that is based on bisulfite sequencing of Arabidopsis mutants generated by Steven Jacobsen ([http://www.ncbi.nlm.nih.gov/pubmed/23313553 ref]).  You can download the data used for this example [http://data.iplantcollaborative.org/quickshare/5ab86ae353cbb475/GSM980991_ago4_CHG.csv.csv here].
+
[[Image:Screen shot 2013-05-29 at 3.12.23 PM.png|thumb|right|300px]]  
  
* Go to your user profile page: (quick link: http://genomevolution.org/CoGe/User.pl)
+
Once you have a CoGe account, you can add new data to CoGe. To do this:
* Click "Create" located on the left of the page
+
 
* Select "Load Experiment". This will link you to [[LoadExperiment]]. (quick link: http://genomevolution.org/CoGe/LoadExperiment.pl)
+
#Go to your [[User profile]] (click on "My Profile" located in the menu at the top-right of any CoGe page)
* When [[LoadExperiment]] loads, you will have to enter information about the experiment
+
#Click on the "Create" button to get a menu of things you can create
** Name: CHH_ago4_Stroud_2013
+
 
** Description: CHH methylation
+
*Select:
** Version: 1
+
**[[Load Genome]]: to load in fasta sequences for a genome
** Source: Jacobsen Lab
+
**[[Load Annotation]]: to add genome annotations in GFF to a previously loaded genome
*** Note: First search to see if a data source exists. If it does not, you can create a new one by pressing "new".
+
**[[Load Experiment]]: to add quantitative data to an experiment
** Restricted: Check!
+
 
** Genome: Arabidopsis thaliana Col-0 (thale cress) (v10.01, id 16911): unmasked
+
=== Example with an Arabidopsis Ago4 mutant ===
*** An experiment must be linked to a genome. Type in part of the name of an organism to start searching for matching genomes.
+
 
* Next comes the part of selecting a data file for the experiment. There are three ways to submit your data file to CoGe:
+
Here we are going to load in an experiment that is based on bisulfite sequencing of Arabidopsis mutants generated by Steven Jacobsen ([http://www.ncbi.nlm.nih.gov/pubmed/23313553 ref]). You can download the data used for this example [http://data.iplantcollaborative.org/quickshare/5ab86ae353cbb475/GSM980991_ago4_CHG.csv.csv here].
** Upload from your computer
+
 
** Fetch from the [[iPlant Data Store]]
+
*Go to your user profile page: (quick link: http://genomevolution.org/CoGe/User.pl)  
** Fetch from a remote http or ftp server
+
*Click "Create" located on the left of the page  
{{#ev:youtube|4UXDCQ6WzN4}}
+
*Select "Load Experiment". This will link you to [[LoadExperiment]]. (quick link: http://genomevolution.org/CoGe/LoadExperiment.pl)  
* After the experiment has been added, you can manage its information in [[ExperimentView]]:
+
*When [[LoadExperiment]] loads, you will have to enter information about the experiment  
** Change its name, description, source and version
+
**Name: CHH_ago4_Stroud_2013  
** Add experiment types to it (e.g. BS-Seq)
+
**Description: CHH methylation  
** Make it public or private
+
**Version: 1  
** Add annotations: these are additional descriptors (text, images, and links) for the experiment
+
**Source: Jacobsen Lab  
* The experiment now shows up in your [[user profile]]
+
***Note: First search to see if a data source exists. If it does not, you can create a new one by pressing "new".  
 +
**Restricted: Check!  
 +
**Genome: Arabidopsis thaliana Col-0 (thale cress) (v10.01, id 16911): unmasked  
 +
***An experiment must be linked to a genome. Type in part of the name of an organism to start searching for matching genomes.  
 +
*Next comes the part of selecting a data file for the experiment. There are three ways to submit your data file to CoGe:  
 +
**Upload from your computer  
 +
**Fetch from the [[IPlant Data Store]]  
 +
**Fetch from a remote http or ftp server
 +
 
 +
{{#ev:youtube|4UXDCQ6WzN4}}  
 +
 
 +
*After the experiment has been added, you can manage its information in [[ExperimentView]]:  
 +
**Change its name, description, source and version  
 +
**Add experiment types to it (e.g. BS-Seq)  
 +
**Make it public or private  
 +
**Add annotations: these are additional descriptors (text, images, and links) for the experiment  
 +
*The experiment now shows up in your [[User profile]]  
 
**Note: If the experiment was marked as being restricted, a "®" shows up next to its name
 
**Note: If the experiment was marked as being restricted, a "®" shows up next to its name
  
== Creating [[Notebooks]] to manage collections of data ==
+
== Creating [[Notebooks]] to manage collections of data ==
[[File:Screen Shot 2013-05-30 at 11.42.18 AM.png|thumb|right|300px|Popup box to fill out when you create a notebook in the [[user profile]] page.]]
+
 
[[File:Screen Shot 2013-05-30 at 11.47.41 AM.png|thumb|right|300px|Showing the newly created notebook entitled "Arabidopsis Ago mutants".  By hovering the mouse over the notebook, information about the notebook appears to the right of the "my stuff" list.]]
+
[[Image:Screen Shot 2013-05-30 at 11.42.18 AM.png|thumb|right|300px]] [[Image:Screen Shot 2013-05-30 at 11.47.41 AM.png|thumb|right|300px]] [[Image:Screen Shot 2013-05-30 at 3.05.38 PM.png|thumb|right|300px]] CoGe's [[Notebooks]] are designed to make it easy to organize a set of data (genomes, [[Experiments]], [[Genomic features]]) and add additional information/[[Metadata]] in the form of annotations to the collection of data. In addition, notebooks can be shared with other users of CoGe and are also used to bundle data together in various tools. For example, the [[EPIC-CoGe Browser]] uses notebooks to display multiple [[Experiments]] in the same track.
[[File:Screen_Shot_2013-05-30_at_3.05.38_PM.png|thumb|right|300px|Notebook containing multiple experiments.  Note that of the experiments, one is private and several are public.]]
+
 
CoGe's [[Notebooks]] are designed to make it easy to organize a set of data (genomes, [[experiments]], [[genomic features]]) and add additional information/[[metadata]] in the form of annotations to the collection of data. In addition, notebooks can be shared with other users of CoGe and are also used to bundle data together in various tools. For example, the [[EPIC-CoGe Browser]] uses notebooks to display multiple [[experiments]] in the same track.
+
=== To create a notebook ===
 +
 
 +
*Go to your user profile page. (quick link: http://genomevolution.org/CoGe/User.pl)
 +
*Click the "Create" button located on the right side of the page and select "New Notebook".
 +
*A box will appear titled "Create New Notebook". Here, type in a name, description (optional), and select the type.
 +
**Type is to help you organize your data.
 +
*Click the red "Create Notebook" to create the notebook.
 +
*The notebook will now in the list of your items. You can search for it by name using the text box located at the top right of the list, or only show notebooks by click on the notebook icon.
 +
**If you hover over the [[Notebook]], information about the notebook appears to the right of the "my stuff" list.
 +
*To add information to the notebook, click on the notebook which will take you to [[NotebookView]]. (quick link: http://genomevolution.org/CoGe/NotebookView.pl?nid=503)
 +
*In [[NotebookView]], click "Add Items" to add items:
 +
*When the "Add Items to Notebook" popup box appears, you can select the types of data to search and then use the textbox to type in a search tearm.
 +
**The different tabs limit which sets of data to search -- my stuff are things you have added or have been given access, the others are for public data
 +
*Find the experiment you previously added to CoGe. In this example, the experiment was named "ago4_mutant". Once you find it, select it and press the "Add Selected Items" button.
 +
*Next, search for additional "Ago" mutants by search through the public experiments and add them to your notebook.
 +
*Next, add an annotation to the notebook by pressing the "Add Annotation" button and filling out the popup box.
 +
**In the example shown, the annotation included a figure from a [http://www.plantphysiol.org/content/159/3/984.full Plant Physiology article on gene silencing movement in Arabidopsis.]
 +
 
 +
== To visualize experiments in the [EPIC-CoGe Browser]] ==
 +
 
 +
[[Image:Screen Shot 2013-05-30 at 11.19.08 AM.png|thumb|center|800px]]
 +
 
 +
To visualize genomic data in CoGe, you need to go to CoGe's genome browser. Part of the [[EPIC-CoGe]] project was to develop a a genome browser that would make it easy for people to overlay [[Quantitative data]] on a genome. One challenge to this is how to design an interface that scales well to hundres if not thousands of [[Experiment|experiments]]. To do this, the [[CoGe team]] has integrated [http://jbrowse.org JBrowse]. Besides from the wealth of features JBrowse brings, the [[CoGe team]] has developed extensions that mimic the look of the [[GenomeView|original genome browser]] in CoGe as well as an hooks to CoGe's [[Experiment|experiments]], [[Notebooks]], and [[User-data management system]].  
  
===To create a notebook===
+
*To launch CoGe's genome browser, click on an experiment to launch [[ExperimentView]]. (quick link: http://genomevolution.org/CoGe/ExperimentView.pl?eid=330)
 +
*From [[ExperimentView]], click on the link to [[OrganismView]] for the genome to which the [[Experiment]] is associated. This link is located next to the "Genome:" in the "Experiment info" box. For the link listed above, the genome is "Arabidopsis thaliana Col-0 (thale cress) (v10.02, id16911): unmasked". (quick link: http://genomevolution.org/CoGe/OrganismView.pl?gid=16911)
 +
*Scroll to the bottom of [[OrganismView]] and launch the genome browser by clicking the button "Launch Genome Viewer". (quick link: http://genomevolution.org/CoGe/GenomeView.pl?z=6&amp;x=20000&amp;gid=16911&amp;chr=1)
 +
*Currently, when [[GenomeView]] loads, it will load the CoGe's original genome browser. To switch to the JBrowse version, select "JBrowse" from the menu next to "Viewer" located above the genome view port. (quick link: http://genomevolution.org/CoGe/GenomeView.pl?z=6&amp;x=20000&amp;gid=16911&amp;chr=1;viewer=JBrowse)
 +
**Note: the quick link will automatically load the JBrowse viewer
 +
**Note: this behavior may change in the future to launch the JBrowse version of the genome browser.
 +
*Information on how to use JBrowse may be found: http://jbrowse.org/
 +
*CoGe specific changes to JBrowse include:
 +
**CoGe-style gene models
 +
**CoGe-style GC content track
 +
**Tracks selection located to the right
 +
**Hooks to CoGe's experiments to visualize [[Experiment|experiments]] and [[Quantitative data]]
 +
**Hooks to CoGe's notebooks to visualization multiple sets of [[Experiment|experiments]] in the same track
 +
**Ability to dynamically transform tracks showing multiple [[Experiment|experiments]] (e.g. calculate average values)
  
* Go to your user profile page.  (quick link: http://genomevolution.org/CoGe/User.pl)
+
=== Video demonstration of EPIC-CoGe browser ===
* Click the "Create" button located on the right side of the page and select "New Notebook".
+
* A box will appear titled "Create New Notebook".  Here, type in a name, description (optional), and select the type.
+
** Type is to help you organize your data.
+
* Click the red "Create Notebook" to create the notebook.
+
* The notebook will now in the list of your items.  You can search for it by name using the text box located at the top right of the list, or only show notebooks by click on the notebook icon.
+
** If you hover over the [[notebook]], information about the notebook appears to the right of the "my stuff" list.
+
* To add information to the notebook, click on the notebook which will take you to [[NotebookView]].  (quick link: http://genomevolution.org/CoGe/NotebookView.pl?nid=503)
+
* In [[NotebookView]], click "Add Items" to add items:
+
* When the "Add Items to Notebook" popup box appears, you can select the types of data to search and then use the textbox to type in a search tearm.
+
** The different tabs limit which sets of data to search -- my stuff are things you have added or have been given access, the others are for public data
+
* Find the experiment you previously added to CoGe.  In this example, the experiment was named "ago4_mutant".  Once you find it, select it and press the "Add Selected Items" button.
+
* Next, search for additional "Ago" mutants by search through the public experiments and add them to your notebook.
+
* Next, add an annotation to the notebook by pressing the "Add Annotation" button and filling out the popup box.
+
** In the example shown, the annotation included a figure from a [http://www.plantphysiol.org/content/159/3/984.full Plant Physiology article on gene silencing movement in Arabidopsis.]
+
  
==To visualize experiments in the [EPIC-CoGe Browser]]==
+
{{#ev:youtube|WlVXwyo4mZM}}
[[File:Screen Shot 2013-05-30 at 11.19.08 AM.png|thumb|800px|center|View of the [[EPIC-CoGe Browser]] showing various tracks.  Of interest are the tracks showing different types of [[quantitative data]] from [[experiments]], including tracks that have multiple [[experiments]].  To the left of the viewer is the menu for finding and selecting tracks for visualization.  If you mouse over quantitative data, colored values appear that correspond to the various experiments.  Note that the track with multiple experiments is organized as a [[Notebook]]. ]]
+
  
To visualize genomic data in CoGe, you need to go to CoGe's genome browser.  Part of the [[EPIC-CoGe]] project was to develop a a genome browser that would make it easy for people to overlay [[quantitative data]] on a genome.  One challenge to this is how to design an interface that scales well to hundres if not thousands of [[experiment|experiments]].  To do this, the [[CoGe team]] has integrated [http://jbrowse.org JBrowse].  Besides from the wealth of features JBrowse brings, the [[CoGe team]] has developed extensions that mimic the look of the [[GenomeView|original genome browser]] in CoGe as well as an hooks to CoGe's [[experiment|experiments]], [[notebooks]], and [[user-data management system]].
+
== [[Sharing data]] in CoGe ==
  
* To launch CoGe's genome browser, click on an experiment to launch [[ExperimentView]].  (quick link: http://genomevolution.org/CoGe/ExperimentView.pl?eid=330)
+
[[Image:Screen shot 2013-02-07 at 10.51.03 AM.png|thumb|right|400px]] Sharing data in CoGe is very easy. There are two general ways to do it:
* From [[ExperimentView]], click on the link to [[OrganismView]] for the genome to which the [[experiment]] is associated.  This link is located next to the "Genome:" in the "Experiment info" box.  For the link listed above, the genome is "Arabidopsis thaliana Col-0 (thale cress) (v10.02, id16911): unmasked". (quick link: http://genomevolution.org/CoGe/OrganismView.pl?gid=16911)
+
* Scroll to the bottom of [[OrganismView]] and launch the genome browser by clicking the button "Launch Genome Viewer".  (quick link: http://genomevolution.org/CoGe/GenomeView.pl?z=6&x=20000&gid=16911&chr=1)
+
* Currently, when [[GenomeView]] loads, it will load the CoGe's original genome browser.  To switch to the JBrowse version, select "JBrowse" from the menu next to "Viewer" located above the genome view port. (quick link: http://genomevolution.org/CoGe/GenomeView.pl?z=6&x=20000&gid=16911&chr=1;viewer=JBrowse)
+
** Note: the quick link will automatically load the JBrowse viewer
+
** Note:  this behavior may change in the future to launch the JBrowse version of the genome browser. 
+
* Information on how to use JBrowse may be found: http://jbrowse.org/
+
* CoGe specific changes to JBrowse include:
+
** CoGe-style gene models
+
** CoGe-style GC content track
+
** Tracks selection located to the right
+
** Hooks to CoGe's experiments to visualize [[experiment|experiments]] and [[quantitative data]]
+
** Hooks to CoGe's notebooks to visualization multiple sets of [[experiment|experiments]] in the same track
+
** Ability to dynamically transform tracks showing multiple [[experiment|experiments]] (e.g. calculate average values)
+
  
===Video demonstration of EPIC-CoGe browser===
+
*Share data directly with another user
{{#ev:youtube|WlVXwyo4mZM}}
+
*Share data with a [[User group]] group of users
  
==[[Sharing data]] in CoGe==
+
To share:  
[[File:Screen shot 2013-02-07 at 10.51.03 AM.png|thumb|right|400px|Sharing is fun and easy!]]
+
Sharing data in CoGe is very easy.  There are two general ways to do it:
+
* Share data directly with another user
+
* Share data with a [[user group]] group of users
+
  
To share:
+
*Go to the user profile page by clicking "My Profile" from the menu located on the top-right of every CoGe page. (quick link: http://genomevolution.org/CoGe/User.pl)  
* Go to the user profile page by clicking "My Profile" from the menu located on the top-right of every CoGe page. (quick link: http://genomevolution.org/CoGe/User.pl)
+
*Select the check-box next to data item(s) your wish to share from the list under "My Stuff"  
* Select the check-box next to data item(s) your wish to share from the list under "My Stuff"
+
*Click on the share button [[Image:Share-icon.png]] at the top of the list  
* Click on the share button [[Image:share-icon.png]] at the top of the list
+
*Search and select the person or [[User-group]] with whom you wish to share (see right).  
* Search and select the person or [[user-group]] with whom you wish to share (see right).
+
*Click "Add" to add that person or [[User-group]]  
* Click "Add" to add that person or [[user-group]]
+
*Click "Done" when you are finished.  
* Click "Done" when you are finished.
+
*If the person you are seeking is not there, tell them to [[Get a CoGe account]]
* If the person you are seeking is not there, tell them to [[get a CoGe account]]
+
  
Video of process:
+
Video of process:  
  
 
{{#ev:youtube|uFfArVc3w04}}
 
{{#ev:youtube|uFfArVc3w04}}

Latest revision as of 21:29, 2 March 2014

Demo of Quantitative Data:
Demo of SNP Data:
Demo of Loading Data:
---=== Try EPIC-CoGe: http://genomevolution.org/r/939v ===---


Overview

This tutorial is aimed at providing an introductory overview of new features in CoGe for the EPIC-CoGe system. These include:

  1. CoGe User accounts
  2. Adding private/restricted Experiment data (in this case, epigenetic data)
  3. Creating Notebooks of collections of data
  4. Visualizing experimental data with CoGe's implementation of JBrowse
  5. Sharing data with collaborators

Each section has a brief overview of the process and a video on how to do it.


User accounts

Screen shot 2013-05-29 at 3.28.04 PM.png
The first thing you will want to do is get a CoGe user account. This is very easy:
  1. Register an iPlant account
  2. Log in

More details on how to get a CoGe account

By having a user account, you will be able to:

  • Add private data to CoGe
  • Share private data with other users
  • Create notebooks (collections of data -- experiments and genomes)
  • Have CoGe track your analytical history (makes it easy to revisit old analyses)

Adding private data

Get Example Data: Example data for EPIC-CoGe

Screen shot 2013-05-29 at 11.57.01 AM.png
Screen shot 2013-05-29 at 3.09.57 PM.png
Screen shot 2013-05-29 at 3.15.38 PM.png
Screen shot 2013-05-29 at 3.12.23 PM.png

Once you have a CoGe account, you can add new data to CoGe. To do this:

  1. Go to your User profile (click on "My Profile" located in the menu at the top-right of any CoGe page)
  2. Click on the "Create" button to get a menu of things you can create

Example with an Arabidopsis Ago4 mutant

Here we are going to load in an experiment that is based on bisulfite sequencing of Arabidopsis mutants generated by Steven Jacobsen (ref). You can download the data used for this example here.

  • Go to your user profile page: (quick link: http://genomevolution.org/CoGe/User.pl)
  • Click "Create" located on the left of the page
  • Select "Load Experiment". This will link you to LoadExperiment. (quick link: http://genomevolution.org/CoGe/LoadExperiment.pl)
  • When LoadExperiment loads, you will have to enter information about the experiment
    • Name: CHH_ago4_Stroud_2013
    • Description: CHH methylation
    • Version: 1
    • Source: Jacobsen Lab
      • Note: First search to see if a data source exists. If it does not, you can create a new one by pressing "new".
    • Restricted: Check!
    • Genome: Arabidopsis thaliana Col-0 (thale cress) (v10.01, id 16911): unmasked
      • An experiment must be linked to a genome. Type in part of the name of an organism to start searching for matching genomes.
  • Next comes the part of selecting a data file for the experiment. There are three ways to submit your data file to CoGe:
    • Upload from your computer
    • Fetch from the IPlant Data Store
    • Fetch from a remote http or ftp server
  • After the experiment has been added, you can manage its information in ExperimentView:
    • Change its name, description, source and version
    • Add experiment types to it (e.g. BS-Seq)
    • Make it public or private
    • Add annotations: these are additional descriptors (text, images, and links) for the experiment
  • The experiment now shows up in your User profile
    • Note: If the experiment was marked as being restricted, a "®" shows up next to its name

Creating Notebooks to manage collections of data

Screen Shot 2013-05-30 at 11.42.18 AM.png
Screen Shot 2013-05-30 at 11.47.41 AM.png
Screen Shot 2013-05-30 at 3.05.38 PM.png
CoGe's Notebooks are designed to make it easy to organize a set of data (genomes, Experiments, Genomic features) and add additional information/Metadata in the form of annotations to the collection of data. In addition, notebooks can be shared with other users of CoGe and are also used to bundle data together in various tools. For example, the EPIC-CoGe Browser uses notebooks to display multiple Experiments in the same track.

To create a notebook

  • Go to your user profile page. (quick link: http://genomevolution.org/CoGe/User.pl)
  • Click the "Create" button located on the right side of the page and select "New Notebook".
  • A box will appear titled "Create New Notebook". Here, type in a name, description (optional), and select the type.
    • Type is to help you organize your data.
  • Click the red "Create Notebook" to create the notebook.
  • The notebook will now in the list of your items. You can search for it by name using the text box located at the top right of the list, or only show notebooks by click on the notebook icon.
    • If you hover over the Notebook, information about the notebook appears to the right of the "my stuff" list.
  • To add information to the notebook, click on the notebook which will take you to NotebookView. (quick link: http://genomevolution.org/CoGe/NotebookView.pl?nid=503)
  • In NotebookView, click "Add Items" to add items:
  • When the "Add Items to Notebook" popup box appears, you can select the types of data to search and then use the textbox to type in a search tearm.
    • The different tabs limit which sets of data to search -- my stuff are things you have added or have been given access, the others are for public data
  • Find the experiment you previously added to CoGe. In this example, the experiment was named "ago4_mutant". Once you find it, select it and press the "Add Selected Items" button.
  • Next, search for additional "Ago" mutants by search through the public experiments and add them to your notebook.
  • Next, add an annotation to the notebook by pressing the "Add Annotation" button and filling out the popup box.

To visualize experiments in the [EPIC-CoGe Browser]]

Screen Shot 2013-05-30 at 11.19.08 AM.png

To visualize genomic data in CoGe, you need to go to CoGe's genome browser. Part of the EPIC-CoGe project was to develop a a genome browser that would make it easy for people to overlay Quantitative data on a genome. One challenge to this is how to design an interface that scales well to hundres if not thousands of experiments. To do this, the CoGe team has integrated JBrowse. Besides from the wealth of features JBrowse brings, the CoGe team has developed extensions that mimic the look of the original genome browser in CoGe as well as an hooks to CoGe's experiments, Notebooks, and User-data management system.

Video demonstration of EPIC-CoGe browser

Sharing data in CoGe

Screen shot 2013-02-07 at 10.51.03 AM.png
Sharing data in CoGe is very easy. There are two general ways to do it:
  • Share data directly with another user
  • Share data with a User group group of users

To share:

  • Go to the user profile page by clicking "My Profile" from the menu located on the top-right of every CoGe page. (quick link: http://genomevolution.org/CoGe/User.pl)
  • Select the check-box next to data item(s) your wish to share from the list under "My Stuff"
  • Click on the share button Share-icon.png at the top of the list
  • Search and select the person or User-group with whom you wish to share (see right).
  • Click "Add" to add that person or User-group
  • Click "Done" when you are finished.
  • If the person you are seeking is not there, tell them to Get a CoGe account

Video of process: