- Source materials, references, and related tutorials
- Step one: Launch an Atmosphere instance
- Step two: Connect to your Atmosphere instance and import sample data and JBrowse
- Step three: Gather all the GFF files from your sample output and place them in their own directory
- Step four: Setup JBrowse and start the apache server
- Step five: Prepare your MAKER-P output for visualization using JBrowse
- Step six: View the sample data in JBrowse
This tutorial assumes you have the following inputs:
- MAKER-P produced gff files
- Reference Genome
- *nix computing setup that satisfies the JBrowse requirements (See: http://jbrowse.org/install/) - we will be using an Atmosphere instance for this.
Source materials, references, and related tutorials
To complete this tutorial, you will need to:
- Complete an MAKER-P annotation (See tutorials by J.Stein and S.Subramaniam for running this at iPlant)
- Launch an Atmosphere instance (Make sure you have access to Atmosphere - See documentation)
In addition to the sources above, material for this tutorial is also derived from:
Step one: Launch an Atmosphere instance
For the purpose of this tutorial, we will use the workshop instance: TSW Workshop Williams 1.0
- Log in to Atmosphere https://atmo.iplantcollaborative.org/ (ensure you have access - go to https://user.iplantcollaborative.org/dashboard/ - if Atmosphere is not listed under 'My Services' scroll down to Available Services and request access to Atmosphere).
- Click 'Launch New Instance'
- Under 'Select an Image' search for 'TSW Workshop Williams 1.0'
- If desired, name your image.
- If you will be using the sample data, you may leave this instance size as 'tiny 1(1 CPUs, 4GB memory, 30G disk), if working with your own data you may choose an appropriate size.
- Click Launch Instance
Launching an instance should take 15-20 minutes; launch times and instance sizes are subject to the capacity of Atmosphere at any given time.
Step two: Connect to your Atmosphere instance and import sample data and JBrowse
In this tutorial, we have left a lot for you to do - this should be very close to setting up and analyzing the data on most any system.
1. SSH into your Atmosphere instance; enter your password when prompted
2. Configure iCommands
When prompted, enter the following values to complete the configuration
Host name (DNS) of the server to connect to
irods user name
(your iPlant username)
Current iRODS password
(your iPlant password)
3. Import a folder containing the sample data and the JBrowse software from the iPlant Data Store using an iget command; then switch into that directory:
4. Unzip both files in the 'maker_viz' folder:
Step three: Gather all the GFF files from your sample output and place them in their own directory
1. Find all the gff files (At least the ones we care about, e.g. 'Chr*.gff') and move them to the top level 'sample_MAKER-P_v.2.3_output' directory
Step four: Setup JBrowse and start the apache server
1. Move the JBrowse directory to a new location which the user can write to,
Configure ownership to ensure write access:
2. Change into the new JBrowse directory
3. Complete the JBrowse setup (Be sure you are in the location '/var/www/JBrowse-1.11.6/' )
4. Start the Apache server (or make sure it is already running)
5. Find your host name, copy down the result of the following command.
6. Open a web browser or new tab and test your JBrowse setup by entering the following URL:
So for example, if your hostname was 'vm65-209.iplantcollaborative.org' your URL would be:
Step five: Prepare your MAKER-P output for visualization using JBrowse
We will run two scripts on the MAKER-P data, one to prepare the selected GFF files and another to prepare the genome. These scripts are part of the standard JBrowse download.
1. Still in the '/var/www/JBrowse-1.11.6/' directory, run the maker2jbrowse on the GFF files we copied in the sample_output folder (this will take a minute to run).
2. Prepare the reference genome (which you used in MAKER-P, and which has been provided in the sample data) using the prepare-refseqs.pl script.
3. Move the reference genome and the output to the Jbrowse data folder:
Step six: View the sample data in JBrowse
Using the URL from Step 4 (No. 6) load your data in a web browser:
http://your_host_name_goes_here/JBrowse-1.11.6/index.html?data=data where data is the name of the output folder we used for the maker2jbrowse script (by default called data).