Mercurial > repos > davidecangelosi > pipe_t
view README.md @ 19:8503457bd0c4 draft
planemo upload for repository https://github.com/igg-molecular-biology-lab/pipe-t.git commit f98eba79c2036aa3e1b8f9048c0b1e61d4d87b60
| author | davidecangelosi |
|---|---|
| date | Tue, 28 May 2019 04:35:18 -0400 |
| parents | 5e8bf316343d |
| children | 46cb147d53df |
line wrap: on
line source
 PIPE-T: A Galaxy tool for analyzing RT-qPCR data ======== PIPE-T is Galaxy tool that offers several state-of-the-art options for parsing, filtering, normalizing, imputing and analyzing RT-qPCR expression data. Integration of PIPE-T into Galaxy allows experimentalists with strong bioinformatic background, as well as those without any programming or development expertise, to perform complex analysis in a simple to use, transparent, accessible, reproducible, and user-friendly environment. Table of Contents <a name="toc" /> ------------------------ - [How to install PIPE-T](#how-to-install-pipet) - [From the galaxy toolshed](#from-the-galaxy-toolshed) - [Using docker](#using-docker) - [How to analyze RT-qPCR data using PIPE-T](#how-to-analyse-data-with-pipet) - [example](#first-example) How to install PIPE-T <a name="how-to-install-pipet" /> [[toc]](#toc) ------------------------ PIPE-T can be easily installed from the [Main ToolShed](#from-the-galaxy-toolshed) or using [Docker](#using-docker) system. ### From the galaxy toolshed <a name="from-the-galaxy-toolshed" /> [[toc]](#toc) [PIPE-T installation from the Main ToolShed repository ](https://toolshed.g2.bx.psu.edu/view/davidecangelosi/pipe_t/3168db2e0ff5) To install PIPE-T from the Main Tool Shed, you need an Admin account on your Galaxy Project instance. During PIPE-T installation setup, we recommend installing dependencies through Conda. To fetch PIPE-T installation, click on the link Install new tools located in the Admin tab of your Galaxy index page.  Click on the Galaxy Main Tool Shed button.  Type pipe_t in the searchbox located on top of the page.  PIPE-T tool will appear in the same page.  Click on the Preview and install option located in the dropdown menu of the tool. Select one of the available revisions and click on the Install to Galaxy. Type PIPE-T in the box Add new tool panel section and click the Install button as it is shown in the screenshot below.  Wait until all dependencies are resolved.  Now, you can start your analysis with PIPE-T. For detailed instructions about tools installation visit the [Galaxy documentation website](https://docs.galaxyproject.org/en/master). ### Using Docker [<img src="https://live.staticflickr.com/1580/24174642365_68f0c433e2.jpg" target="_blank" alt="drawing" width="60"/>](https://www.docker.com/) <a name="using-docker" /> [[toc]](#toc) A dockerized version of Galaxy containing PIPE-T, based on [bgruening galaxy-stable](https://github.com/bgruening/docker-galaxy-stable) is also available. At first you need to install Docker. Please follow the instructions to install docker based on your machine OS: - [<img target="_blank" src="https://upload.wikimedia.org/wikipedia/commons/e/e0/Windows_logo.png" alt="drawing" width="150"/>](https://hub.docker.com/editions/community/docker-ce-desktop-windows) - [<img target="_blank" src="https://upload.wikimedia.org/wikipedia/commons/thumb/f/fa/Apple_logo_black.svg/1024px-Apple_logo_black.svg.png" alt="drawing" width="40"/> <img target="_blank" src="https://upload.wikimedia.org/wikipedia/commons/thumb/0/00/MacOS_wordmark.svg/216px-MacOS_wordmark.svg.png" alt="drawing" width="120"/>](https://hub.docker.com/editions/community/docker-ce-desktop-mac ) - [<img target="_blank" src="http://pngimg.com/uploads/linux/linux_PNG29.png" alt="drawing" width="150"/>](https://docs.docker.com/install/linux/docker-ce/ubuntu/) After the successful installation, all you need to do is: ``` docker run --rm -d -p 21:21/tcp -p 443:443/tcp -p 80:80/tcp -p 8800:8800/tcp -p 9002:9002/tcp davidecangelosi/galaxy-pipe-t:latest ``` If you already have run galaxy-pipe-t with docker and want to fetch the last docker image of galaxy-pipe-t, type ``` docker pull davidecangelosi/galaxy-pipe-t docker run -d -p 21:21/tcp -p 443:443/tcp -p 80:80/tcp -p 8800:8800/tcp -p 9002:9002/tcp davidecangelosi/galaxy-pipe-t ``` Then, you just need to open a web browser (chrome or firefox are recommanded) and type ``` http://localhost ``` into the adress bar to access Galaxy running PIPE-T.  The Galaxy Admin User has the username `admin@galaxy.org` and the password `1234`. In order to use some features of Galaxy, like import history, one has to be logged in with this username and password. Docker images are "read-only", all your changes inside one session will be lost after restart. This mode is useful to present Galaxy to your colleagues or to run workshops with it. To install Tool Shed repositories or to save your data you need to export the calculated data to the host computer. Run this command setting your local landing path (`/host/path/targetfolder/`): ``` docker run -d -p 8080:80 \ docker run -d -p 21:21/tcp -p 443:443/tcp -p 80:80/tcp -p 8800:8800/tcp -p 9002:9002/tcp \ -v /host/path/targetfolder/:/export/ \ davidecangelosi/galaxy-pipe-t:latest ``` For more information about the parameters and docker usage, please refer to https://github.com/bgruening/docker-galaxy-stable/blob/master/README.md#Usage How to analyse data with PIPE-T <a name="how-to-analyse-data-with-pipet" /> [[toc]](#toc) ------------------------ PIPE-T offers several options for the analysis of RT-qPCR data. The main steps are summarized in the following figure.  ##### Input To start any PIPE-T execution, users must upload two types of input files: - A List collection of tab-separated text files containing the resulting data of the RT-qPCR experiment (ListOfFile) - A tab-separated text file associating each filename in ListOfFile with a treatment group (FileTreatment). ##### Output One single execution of PIPE-T produces the following output files: - A tab-separated text file containing the raw Ct values for every samples and transcript - A PNG file showing the distribution of the Ct values of every samples obtained after the Ct filtering and categorization step visualized as sequence of boxplots. - A tab-separated text file containing the normalized Ct values - A PNG file showing the cumulative distribution plot before and after data normalization of the coefficient of variation of every transcript. - A PNG file showing the distribution of the normalized Ct values visualized as sequence of boxplots. - A tab-separated text file containing data after imputation - A tab-separated text file containing the results of the differential expression analysis. ### Example application <a name="first-example" /> [[toc]](#toc) In this example, we will show you how to perform a simple analysis with PIPE-T on mCRC data. We have chosen the 53 metastatic colorectal cancer study that we presented in our manuscript. The top rows relative to an example file of a hypothetical ListOfFile is reported in the table below. Note that file contains data about the type of the file, dates and any other relevant information about the experiment.  An example FileTreatment is reported in the table below. Note two columns named sampleName and Treament compose that file.  ##### Uploading procedure The first step is uploading the file to analyze. To this end, Click on the link Load your own data in the history tab on the right.  Galaxy will show a Uploading dashboard. Click on the Collection tab of the dashboard.  Upload your tab-separated text files (one per sample) and Click the Start button.  Wait until all files have been uploaded and click to the Build button.  In the bottom right text box, Type a name for the list collection and Click on the Create List button.  Congratulations! You created your ListOfFile. Now we need to upload FileTrteatment. To do this, open the Upload tool as we did for ListOfFile, click on the regular tab.  Upload your tab-separated text FileTreatment and Click on the Start Button.  Wait until the file is fully loaded.  Congratulations! You are now ready to perform your analysis with PIPE-T.  ##### Parameter set up of a PIPE-T analysis To carry out analysis with PIPE-T you need to set up a number of parameters. Some parameters are already configured by default, but you can change them. The following screenshots summarize the parameter settings of the analysis of the mCRC data. Analysis is relative to the files uploaded in the preceding section. ##### File Uploading and parsing  ##### Ct filtering and categorization  ##### Normalization  ##### Transcript filtering and imputation  ##### Differential expression analysis  Click on Execute button to start analysis. When the execution ends, PIPE-T returns seven output files in the history tab in the right panel. ##### Results Here, we included the 7 output files returned by PIPE-T using the parameters set up in the preceding section.   