LobSTR tutorial » History » Revision 6
Revision 5 (Bryan Cosca, 10/15/2014 02:48 PM) → Revision 6/19 (Jonathan Sheffi, 10/15/2014 03:09 PM)
h1. Running lobSTR v.3 using Arvados This tutorial demonstrates how to run the lobSTR pipeline using the example that Melissa Gymrek provides at her "page":http://melissagymrek.com/lobstr-code/usage.html. LobSTR is a tool for profiling Short Tandem Repeats (STRs) from high throughput sequencing data. The lobSTR publication is available here: "Gymrek M, Golan D, Rosset S, & Erlich Y. lobSTR: A short tandem repeat profiler for personal genomes. Genome Research. 2012 April 22.":http://genome.cshlp.org/content/early/2012/04/19/gr.135780.111.abstract This tutorial introduces will introduce the following Arvados features: * How to run lobSTR v.3 using Arvados * How to access your pipeline results. * How to browse and select input your data for lobSTR and submit re-run the pipeline. # Start at the by going to our "Curoverse":https://curoverse.com/ website and click clicking the Log In button at the top. We currently support all Google / Google Apps google/google apps accounts for authentication. By and by simply choosing a Google-based your account, your account will be automatically created and redirect to the "Arvados Workbench":https://workbench.qr1hi.arvadosapi.com/. # In the *Active pipelines* panel, you can click on the *Run a pipeline...* button. Doing so opens This will open a dialog box titled *Choose a pipeline to run*. # Select *lobstr v.3* and click the *Next: choose inputs* button. Doing so loads This will load a new page to where you will supply the inputs for the pipeline. # The default inputs from Melissa's git repository are already pre-loaded. Click on the *Run* button. The page updates to show you that the pipeline has been submitted to run on the Arvados cluster. # After the pipeline starts running, you can track its the progress by watching log messages from jobs. This page refreshes automatically. You will see a complete label under the job the column when the pipeline completes successfully. The current run time of the job in CPU and clock hours is also displayed. You can view individual job details by clicking on the job name. # Once the job is finished, the output can be viewed to the right of the run time. # Click on the download button to the right of the file to download your results, or similarly the magnifying glass to quickly view your results. h2. Uploading data and using it on Arvados Full documentation can be found "here":http://doc.arvados.org/user/tutorials/tutorial-keep.html # Install First, Begin by installing the "Arvados Python SDK":http://doc.arvados.org/sdk/python/sdk-python.html on the system from which you will upload the data (such as your workstation, or a server containing data from your sequencer). Doing so This will install the Arvados file upload tool, arv-put. # Navigate back to your Workbench dashboard and create a new project by clicking on the Projects dropdown menu and clicking Home. # Click on [+ Add a subproject]. Feel free to edit the Project name or description by clicking the pencil to the right of the text. # To add data, return back to your shell and use the command arv-put as well as the name of your file and the tag --project-uuid qr1hi-xxxxx-yyyyyyyyyyyyyyy. The qr1hi tag can be found in the url of your new project. # The output value xxxxxxxxxxxxxxxxxxxx+yyyy is the Arvados collection locator that uniquely describes this file. # Once that is uploaded, uploaded navigate back to the dashboard and click on *Run a pipeline...* and choose lobstr v.3. # You can change the input by clicking on [Choose] next to the *Input fastq collection ID*. # Click on the Dropdown menu and click on your created project and choose your desired input collection. Click OK and Run to run lobSTR v.3 on your data!