RNASEQ - OVERVIEW


1.1 - ABOUT RNASEQ

RNASeq is a Client-Desktop Application of the GPRO suite with custom dedication to manage and run pipelines and workflows for differential expression and enrichment analysis based on RNASeq data using a protocol based on the State-of-the -Art (Fig.1). The application is coupled with an infrastructure of server-side dependencies (pipelines, databases and tools) that we distribute in a container that can be installed on a remote server or on a PC with sufficient RAM. The app also includes a File Transfer Protocol system (FTP) to facilitate the upload and download of files from the user’s computer to or from the server; a progress tracker (job tracking system), and two different execution modes (a “step-by-step” mode, and a “pipeline-like” mode).

The Step-by-Step mode is a procedure similar to those implemented in Galaxy (Afgan et al 2018) and others GUI-based solutions for NGS data analysis. This mode organizes the different steps of the RNASeq workflow (i.e. quality analysis, preprocessing, mapping, transcriptome assembly and/or quantification, differential expression, and enrichment) into an intuitive menu providing a selection of command line interface (CLI) third party software for each step allowing different protocols to perform the analysis with or without a reference genome or transcriptome. At the same time each CLI tool has an interface implementation with distinct fields to declare the inputs and outputs files or for tuning the options and parameters provided by that tool.

In contrast, the pipeline mode is a pipeline configuration system allowing the user to execute all the steps of a given protocol automatically one after the other. To this end the user just need to select an specific pipeline from a list, declare the experiment design as well as the input and output data, then configure the option and parameters and finally run the pipeline where the distinct analyses will be executed sequentially one after another.


Figure 1

Figure 1: Bioinformatic protocol implemented in RNAseq for differential expression and enrichment analysis according to the most common RNA-seq practices. The tool provides two execution modes (Step-By-Step and Pipeline-like) and two alternative analytical paths (“Mapping & Counting” and “Tophat/Hisat2 & Cufflinks”). An interactive version of this protocol is available at GENIE our virtual assitant.


CITING RNASEQ:

Hafez AI, Soriano B, Elsayed AA, Futami R, Ceprian R, Ramos-Ruiz R, Martinez G, Roig FJ, Torres-Font MA, Naya-Catala F, Calduch-Giner JA, Trilla-Fuertes L, Gamez-Pozo A, Arnau V, Sempere-Luna JM, Perez-Sanchez J, Gabaldon T, Llorens C. 2023. Client Applications and Server-Side Docker for Management of RNASeq and/or VariantSeq Workflows and Pipelines of the GPRO Suite. Genes; 14(2):267. https://doi.org/10.3390/genes14020267

CITING THE GPRO SUITE:

Futami R, Muñoz-Pomer A, Viu JM, Dominguez-Escribá L, Covelli L, Bernet GP, Sempere JM, Moya A, Llorens C. 2011. GPRO: the professional tool for management, functional analysis and annotation of omic sequences and databases. Biotechvana Bioinformatics: 2011-SOFT3, http://bioinformatics.biotechvana.com/index.php/article/35

1.2 - VERSIONS AND DOWNLOADS

RNASeq includes an installer for Windows 7 (64 bit), a self-extracting disk image for Mac OS X 10.6 or later (64 bit), and a compressed tarball archive for Linux 2.6 kernel series or later (64 bit). You can download the lastest version of these executables at this link:

1.3 - INSTALLATION AND REQUIREMENTS

1.3.1 - INSTALLING RNASEQ IN YOUR PC

RNASeq is a Java application that can be easily installed on PCs with at least 2GB of RAM and that have installed the Java Runtime Environment (Java JDK) version 11 or above.

To check if you already have a JDK installed, open a command line interface and type:

java -version
If you have the java version 11.0_xx, you should see the following message:
$ java -version
jopenjdk 11.0.14.1 2022-02-08
OpenJDK Runtime Environment (build 11.0.14.1+1-Ubuntu-0ubuntu1.20.04)
OpenJDK 64-Bit Server VM (build 11.0.14.1+1-Ubuntu-0ubuntu1.20.04, mixed mode, sharing)
If you see the “Command not found” error message, this means that JRE is not installed in your computer yet.

For installing JRE, go to the official JRE repository here and download the version that suits your operating system. Once installed, check again the output of the java -version command show above on your command line interface. Sometimes, although the JRE is installed, it is not set at the root path.

To install the Windows version
Download the RNASeq-win32.win32.x86_64.zip file and unzip it. Then browse to the executable file “RNASeq.exe” and execute/run it.

To install the Mac version
Download the RNASeq-macosx.cocoa.x86_64.zip file and unzip it. Then browse to the executable binary file "RNASeq.app" and execute/run it.

To install the Linux version
Download the RNASeq-linux.gtk.x86_64.zip file and unzip it. Then browse to the executable binary file “RNASeq” and execute/run it.

1.3.2 - SERVER SIDE DEPENDENCIES

RNASeq is a Client Side + Server Side solution thus meaning that the application is coupled via API with a bioinformatic infrastructure called GPRO Server Side that contains all the dependencies needed by RNASeq to execute the workflows and pipelines. These dependencies are scripts, databases and the following third party CLI software:

The GPRO Server Side can be installed in the PC of the user or in remote servers as a Cloud Computing resource. However, its installation is a complex task due to the lot of dependencies and requirements (besides of the CLI software) for installing and running this infrastructure. For this reason, we distribute the GPRO Server Side in a Docker container that can be easily installed for the user in a couple of steps. Indications for installation of the GPRO Server Side Docker are available here.

1.3.3 - LINKING RNASEQ WITH THE SERVER SIDE

Once the GPRO server side docker has been installed you need to link RNASeq to it. To do this, go to [Preferences → Pipeline connection settings] in the top menu and type the following into the configuration Dialog (Fig.2):

  1. Your email address: to receive notifications from the server.
  2. Host / IP address: here you should type localhost (see figure 2).
  3. Port number:This field should be filled only in case of you installed the server side manually and need to access via SSH. In that case the default number will be 22.
  4. Username and password: Your ID credentials provided to access the host server.

As also shown in Figure 2 you can also check the option “Run GPRO server locally using Docker” to let you to automatically start the GPRO container each time you run RNASeq (Also note that if you have this option checked you do not need to type the port). You can test if the app is connected to the Server Side clicking on the tab “Test connection settings”. Alternatively, if you install the Server Side manually (without the Docker) just add the IP of the remote server where the Server Side is hosted, add the port information (by default 22) and keep the Option “Run GPRO server locally using Docker” unchecked.

Figure 2

Figure 2: Server connection dialog.

1.3.4 - RAM ASSIGNATION TO YOUR PC

To modify the RAM assigned to RNASeq, you can edit two parameters (‘Xms’ and ‘Xmx’) in the “RNASeq.ini” configuration file. In Linux or Windows computers, the “RNASeq.ini” configuration file is located inside the RNASeq app folder. In macOS computers, the file can be found by right-clicking on [RNASeq.app → Show package contents → Contents → MacOS → RNASeq.ini.].

Within the “RNASeq.ini” file, the Xms and Xmx parameters look like this:

Xms1024m (Minimum allocated memory)
Xmx2048m (Maximum allocated memory)
Numeric values in the parameter names correspond to the RAM (in Megabytes) assigned to RNASeq. To change the amount of RAM that is assigned to the app, simply modify these values. Please keep in mind that the maximum amount of RAM assigned to RNASeq will depend on your computer’s total RAM. For example, if your computer has a total of 8GB of RAM, we recommend that you assign Xms2048m and Xmx4096m for optimal performance. You may even increase the value of Xmx up to Xmx6144m. We do not however recommend the use of RAM values near to the maximum available memory of your PC. This could reduce the stability of your computer’s operating system.

1.4 - GETTING FAMILIAR

1.4.1 - RNASEQ LAYOUT

The layout of RNASeq is structured in the following sections: the "Directory Browser", the "FTP Browser", the "Working Space", the "Top menu" and the "Step-by-step Interface Menu". (Fig. 3)


Figure 3

Figure 3: Main layout of RNASeq. Both the Directory and FTP Browser windows can be either resized or masked by clicking on the window icons at the top right corner of their respective windows. All files and folders contained in either of these browsers can be managed manually using the mouse. Please keep in mind that the window views shown in this manual will change depending on the operative system used.

1.4.2 - FUNCTIONS OF THE TOP MENU

The Top Menu presents the following tabs, each of which has a scroll down list with the following functions:







GPRO licensing and Usage           Former versions           TSI-100903-2019-11

Biotechvana


Valencia Lab
Parc Cientific Universitat de Valencia
Carrer del Catedràtic Agustín Escardino, 9. 46980 Paterna (Valencia) Spain
Madrid Lab
Parque Científico de Madrid
Campus de Cantoblanco
Calle Faraday 7, 28049 Madrid Spain
Contact us
Phone: +34 960 06 74 93
Email: biotechvana@biotechvana.com

Supported by


Hipra Scientific S.L.U, Polypeptide Therapeutic Solutions S.L., Biotechvana S.L. and Nostrum Biodiscovery constitute the consortium of enterprises participating in the project "Research of a new vaccine for a human respiratory disease", granted by the CDTI (Center for Industrial Technological Development), and supported by the Ministry of Science and Innovation and financed by the European Union – NextGenerationEU. The main objective of this project is to design a safe immunogenic and effective vaccine against the respiratory syncytial virus.

Biotechvana © 2015
Privacy policy
Política de privacidad
This website use cookies, by continuing to browse the site you are agreeing to our use of cookies. More info about our cookies here.