EBioinfraGateUserDoc < EBioScience

%INCLUDE{ "BioLab.BioLabTemplate" }%
---+!! e-BioinfraGateway

%TOC%

The e-Bioinfra Gateway (%BROWN%e-Bioinfra Gateway%ENDCOLOR%) is a web application that provides facilitated access to the [[http://www.biggrid.nl][Dutch Grid infrastructure]] for researchers that need to analyse large data collections with complex or compute-intensive methods. The researcher just needs to follow some steps on a web interface using any web browser. The web link is *[[http://www.ebioscience.amc.nl/ebioinfragateway/][http://www.ebioscience.amc.nl/ebioinfragateway/]]*

The following steps are needed to use the %BROWN%e-Bioinfra Gateway%ENDCOLOR%:
   * [[#Registration][Register]]
   * [[#Data_Transport][Prepare data to be transported to the grid]]
   * [[#Applications][Run the application]]
The %BROWN%e-Bioinfra Gateway%ENDCOLOR% is developed and maintained by the [[WebHome][e-BioScience]] group of the [[http://www.bioinformaticslaboratory.nl][Bioinformatics Laboratory of the AMC]], Department of Epidemiology, Biostatistics and Bioinformatics (KEBB). This research is supported by the !BiGGrid project (NWO funding), the COMMIT project "e-Biobanking with imaging for healthcare", and the AMC ICT Innovation Fund.

For more information please [[ContactUs][contact us]].

---++ Registration

<!--
<p align="center"><object width="640" height="385"><param name="movie" value="http://www.youtube.com/v/KbLgEJpJPr4?fs=1&hl=en_US&rel=0&color1=0x006699&color2=0x54abd6"></param><param name="allowFullScreen" value="true"></param><param name="allowscriptaccess" value="always"></param><embed src="http://www.youtube.com/v/KbLgEJpJPr4?fs=1&hl=en_US&rel=0&color1=0x006699&color2=0x54abd6" type="application/x-shockwave-flash" allowscriptaccess="always" allowfullscreen="true" width="640" height="385"></embed></object></p>
-->

| <p>In order to use the e-BioinfraGateway, users should register as follows:</p> <ol> <li>1 Provide the needed information on the [[http://www.ebioscience.amc.nl/ebioinfragateway/register][registration web page]], and agree to the terms and conditions.</li> <li>Fill out the intended usage form: [[http://bioinformaticslaboratory.nl/twiki/bin/view/EBioScience/EbioinfragatewayIntendedUsage][here]].</li> <li>Our administration will inform you via email as soon as your account is activated.</li> </ol><p>NOTE:</p> <p>Your account includes access privileges to the e-BioinfraGateway website and to the data staging machine, to which the data should be uploaded. The passwords to both accounts are the same.</p> | [[%ATTACHURL%/registration-form.PNG][<img width="500" alt="registration-form.PNG" src="http://www.bioinformaticslaboratory.nl/twiki/pub/EBioScience/EBioinfraGateUserDoc/registration-form.PNG" title="Registration Form" />]] |

---++ Experiment Setup

In the documentation pages of each experiment type, there is usually a section which describes the supported input data and any additional step to prepare the input data. Please make sure that you read that section carefully and you provide the input data exactly as described in that section.

In addition, please note that we highly recommend to the users of the e-BioinfraGateway to start their data analysis with a small set of data (e.g., 2 subjects) and confirm the results before proceeding with the complete data set analysis.

#DataTransportSection
---++ Data Transport

<span style="color: #000000;">The research data to be analysed on the Grid needs to be transferred to grid storage outside the AMC network in a secure manner. This is done with the aid of an intermediary storage server at the AMC, called </span><span style="color: #b22222;">data staging machine</span>. Each researcher has a private space that can hold data for a limited time (1-2 weeks). All data copied into this machine are automatically transported to the Grid storage. Likewise, all results generated by calculations executed on the Grid are copied back to the data staging machine.

Files can be copied to/from this space by the researcher using regular ftp client programs such as [[http://winscp.net/eng/index.php][WinSCP]], [[http://fireftp.mozdev.org/][FireFTP]] or [[http://filezilla-project.org][FileZilla]]. For the examples on the user documentation we are using !FireFTP. If you don't have administrative rights on your windows / AMC-OpenPC machine you can use [[http://downloads.sourceforge.net/filezilla/FileZilla_3.4.0_win32.zip][the .ZIP version of FileZilla]], which does not require installation (just unzip and use).

*Important Notes:*
   * Please avoid using "." (except the final dot before extension), and "spaces" in the file name. So "subject.001.nii" and "subject 001.nii" are not good but "subject-001.nii" and "subject_001.nii" and "subject-001.tar.gz" are good.
   * File names should be between 1 and 50 charachters (and not longer).
   * Please make sure that your input data is prepared according to each experiment requirements.
   * You have to select individual files (and not directories) in the 'input selection' page of experiment. (We suggest using a flat directory structure for input data but if you prefer to store your input files in sub-folders then you need to provide 'custom input data directory' on 'upload' page.)
   * <strong>Issues with the Internet Explorer (on AMC !OpenPCs): </strong>Please use a _real_ web browser (i.e., Mozilla Firefox). Unfortunately Internet Explorer is unable to detect redirects to _SFTP_ links that are used for accessing the files.

---++ Applications

| *Application Name* | *Function*  | *Documentation*  |
| DTI Preprocessing | preprocessing of the DTI Atlas data analysis  | [[PredtiUserDoc][DTI Preprocessing on the e-BioinfraGateway User Documentation]]  |
| DTI Atlas | registration of large collections of DTI images  | [[DTIAtlasUserDoc][DTI Atlas on the e-BioinfraGateway User Documentation]]  |
| Freesurfer | brain surface segmentation from MRI images  | [[FreesurferUserDoc][Freesurfer on the e-BioinfraGateway User Documentation]]  |
| BLAST | alignment of DNA sequence data with a given database | [[BLASTUserDoc][BLAST on the e-BioinfraGateway User Documentation]] |
| T-B Cell Variation | | [[TBCellVariationUserDoc][T-B Cell Variation User Documentation]] |
| Genome Compare | counts and clusters homologous genes to find related strains | [[GenomeCompareUserDoc][Genome Compare User Documentation]] |

---++ Publications

   * S. Shahand, M. Santcroos, A. H. van Kampen, and S. Olabarriaga. _A Grid-enabled Gateway for Biomedical Data Analysis_. [[http://dx.doi.org/10.1007/s10723-012-9233-4][Springer Journal of Grid Computing]].
   * S. Shahand, M. Santcroos, Y. Mohammed, V. Korkhov, A. Luyf, A. van Kampen, and S. Olabarriaga. _Front-ends to Biomedical Data Analysis on Grids_. In Proceedings of !HealthGrid 2011, Bristol, UK, 2011. [[%ATTACHURL%/ebioinfragate.pdf][PDF]]
Attachments
Topic attachments
I	Attachment	Action	Size	Date	Who	Comment
pdf	ebioinfragate.pdf	manage	244.4 K	2011-08-01 - 13:22	ShayanShahand	healthgrid 2011 paper
Topic revision: r41 - 2013-05-06 - ShayanShahand