Quick start of NanoDJ VICE app in DE¶
Goal¶
NanoDJ is a Dockerized Jupyter Notebook for interactive Oxford Nanopore MinION sequence manipulation and genome assembly. It integrates basecalling, read trimming and quality control, simulation and plotting routines with a variety of widely used aligners and assemblers, including procedures for hybrid assembly.
- Facilitate ONT sequence analyses by integrating capabilities for data manipulation, sequence comparison and assembly in field experiments or for educational purposes.
- Interactively explore your data with beautiful visualizations that provide new perspectives.
- Easily share results with your team, even those members without NanoDJ installed.
In this quick start, we will show you how to launch NanoDJ VICE app in DE.
Prerequisites¶
Downloads, access, and services¶
In order to complete this tutorial you will need access to the following services/software
Prerequisite Preparation/Notes Link/Download CyVerse account You will need a CyVerse account to complete this exercise Register
Platform(s)¶
We will use the following CyVerse platform(s):
Platform | Interface | Link | Platform Documentation | Learning Center Docs |
---|---|---|---|---|
Discovery Environment | Web/Point-and-click | Discovery Environment | DE Manual | Guide |
Input and example data¶
In order to complete this quickstart you will need to have the following inputs prepared.
Note
The example input data (which contains data and Jupyter notebooks) is already prefilled for you during app launch
Input File(s) | Format | Preparation/Notes | Example Data |
---|---|---|---|
Fast5 and Jupyter notebooks |
|
Input data can be a list of FAST5 files from previous basecalled runs (e.g. a Metrichor output) or event level signal data to be basecalled using the latest ONT caller | data_transfer.sh (Community Data -> iplantcollaborative -> example_data -> nanodj and select data_transfer.sh script) |
Get started: Launch NanoDJ¶
- Login to the Discovery Environment.
- Click on Apps window in the DE workspace and search for and run NanoDJ.
- Under “Analysis Name” leave the defaults or make any desired notes.
- Under “Parameters” for ‘Input files’, click the “+” and browse
data_transfer.sh
(iplantcollaborative > example_data > nanodj and selectdata_transfer.sh
script). - Click Launch Analysis. You will receive couple of notifications on the bell corresponding to job submission and running with the “Access your running analysis here”.
- Clicking on the “Access your running analysis” will open the NanoDJ JupyterLab in another tab in the browser after a brief building phase.
Note
You will be asked to authenticate again to the JupyterLab with your CyVerse username and password
- Open the Terminal in the main JupyterLab interface (under ‘others’ section), navigate to the
vice
folder and execute thedata_transfer.sh
script to initiate the test data downloading process. You will be asked to enter your CyVerse password again to initiate the downloading process.
cd vice
bash data_transfer.sh
Enter your current iRODS password:
- Finally, once you finish analysis, navigate to the Discovery Environment tab, select the Analysis window and select the analysis, click “save and complete analysis”. Upon clicking complete analysis, the analysis will be completed and all the outputs will be brought back to the analysis folder. Alternatively you can use
iput -rPVT <folder name>
command to transfer the data back to the data store.
Note
Currently quick starts uses a reduced test data but if you want to try the full test data, then instead of using data_transfer.sh
, use data_transfer_full.sh
script which is in the same folder as the other script.
Additional information, help¶
- Full materials for the webinar is available here
- See the original JupyterLab quick start
- See the original NanoDJ for how to run ONT data analysis
- Contact CyVerse support by clicking the intercom button on the page.
Fix or improve this documentation
- Search for an answer: |CyVerse Learning Center|
- Ask us for help: click |Intercom| on the lower right-hand side of the page
- Report an issue or submit a change: |Github Repo Link|
- Send feedback: Tutorials@CyVerse.org