GBrowse: Difference between revisions

Jump to navigation Jump to search
24 bytes removed ,  2 years ago
no edit summary
No edit summary
No edit summary
Line 5: Line 5:


<!--T:2-->
<!--T:2-->
GBrowse is a combination of database and interactive web pages for manipulating and displaying annotations on genomes. It requires a web interface to display. GBrowse has been installed on [[Cedar]]. The web address of the installation is https://gateway.cedar.computecanada.ca.
GBrowse is a combination of database and interactive web pages for manipulating and displaying annotations on genomes. It requires a web interface to display. GBrowse is installed on [[Cedar]]. The web address of the installation is https://gateway.cedar.computecanada.ca.


<!--T:3-->
<!--T:3-->
Line 13: Line 13:


<!--T:5-->
<!--T:5-->
In order for GBrowse to be able to access your files and directories, Compute Canada (CC) staff will create a shared account for each research group that requests access to GBrowse. While using GBrowse, any member of a research group can read GBrowse config files and input files belonging to any other member of that group. If you wish to use GBrowse, the Principal Investigator (PI) of your group must agree to this change from the usual file security practices. Have the PI write to our [[Technical support]] indicating that they want a GBrowse account to be created for the group, and that they understand the implications of the shared account.
In order for GBrowse to be able to access your files and directories, our staff will create a shared account for each research group that requests access to GBrowse. While using GBrowse, any member of a research group can read GBrowse config files and input files belonging to any other member of that group. If you wish to use GBrowse, the Principal Investigator (PI) of your group must agree to this change from the usual file security practices. Have the PI write to our [[Technical support]] indicating that they want a GBrowse account to be created for the group, and that they understand the implications of a shared account.


<!--T:6-->
<!--T:6-->
Line 23: Line 23:


<!--T:9-->
<!--T:9-->
Since Gbrowse needs to be able to read config files of all users within a group, place your GBrowse config files in the following directory:
Since GBrowse needs to be able to read config files of all users within a group, place your GBrowse config files in the following directory:


  <!--T:10-->
  <!--T:10-->
Line 43: Line 43:


<!--T:15-->
<!--T:15-->
where <code>''DATABASE''</code> is the name of your database and <code>''SHARED''</code> is the shared-account. The <code>.my.cnf</code> file is a text file that is created by CC staff. It contains information required for the shared account to make a connection to MySQL.  
where <code>''DATABASE''</code> is the name of your database and <code>''SHARED''</code> is the shared account. The <code>.my.cnf</code> file is a text file that is created by our staff. It contains information required for the shared account to make a connection to MySQL.  


<!--T:16-->
<!--T:16-->
If you decide to use Postgres you need the following in your GBrowse config files:
If you decide to use Postgres, you need the following in your GBrowse config files:


  <!--T:17-->
  <!--T:17-->
Line 63: Line 63:
GBrowse is able to read <code>.bam</code> files directly. You do not need to upload them to the database in order to display them. If you want GBrowse to read these .bam files directly:
GBrowse is able to read <code>.bam</code> files directly. You do not need to upload them to the database in order to display them. If you want GBrowse to read these .bam files directly:
* Files need to be copied to your <code>/project</code> directory and they should be readable by the group.  
* Files need to be copied to your <code>/project</code> directory and they should be readable by the group.  
* The directory that contains the <code>.bam</code> files must have the setgid and group-execute bits turned on; that is, the output of <code>ls –l</code> must show a small "s" in the group-execute field (not large "S").
* The directory that contains the <code>.bam</code> files must have the <tt>setgid</tt> and <tt>group-execute</tt> bits turned on; that is, the output of <code>ls –l</code> must show a small "s" in the group-execute field (not a large "S").
* Make sure that the <code>.bam</code> file's group-ownership is set to your group and not your username. For example, <code>jsmith:jsmith</code> is wrong, <code>jsmith:def-kjones</code> is right.  
* Make sure that the .bam file's group ownership is set to your group and not to your username. For example, <code>jsmith:jsmith</code> is wrong, <code>jsmith:def-kjones</code> is right.  
* Edit your config file to specify the path to the <code>.bam</code> file. Here is an example:
* Edit your config file to specify the path to the .bam file. Here is an example:


  <!--T:21-->
  <!--T:21-->
Line 84: Line 84:


<!--T:25-->
<!--T:25-->
In this example <code>''DATABASE''</code> is the name of your database and <code>example_genomic_sequence.fa</code> is the [https://en.wikipedia.org/wiki/FASTA_format fasta file] containing the entire genome that you want to visualize with GBrowse. <code>header_file</code> contains details about the length of the chromosomes. Here is an example of a header file:
In this example <code>''DATABASE''</code> is the name of your database and <code>example_genomic_sequence.fa</code> is the [https://en.wikipedia.org/wiki/FASTA_format FASTA file] containing the entire genome that you want to visualize with GBrowse. <code>header_file</code> contains details about the length of the chromosomes. Here is an example of a header file:


<!--T:26-->
<!--T:26-->
Line 101: Line 101:


<!--T:28-->
<!--T:28-->
Once you uploaded your data to your database you need to grant view access to the <code>''SHARED''</code> account so that GBrowse is able to access your database for reading. Please see [[Database servers#How_to_share_your_MySQL_data|How to share your MySQL data]].
Once you uploaded your data to your database, you need to grant view access to the <code>''SHARED''</code> account so that GBrowse is able to access your database for reading. Please see [[Database servers#How_to_share_your_MySQL_data|How to share your MySQL data]].




</translate>
</translate>
rsnt_translations
56,430

edits

Navigation menu