GUI application ‘FishResp’

Home / GUI application ‘FishResp’

Software version: 0.1.0
Authors: Sergey Morozov & Roman Kovalev

Description

The GUI application ‘FishResp’ represents graphical implementation of the R package ‘FishResp’. This application has been developed for users who are not familiar with R language or prefer to work with a graphical user interface (GUI) instead of a command line. The application is free and cross-platform (available for Windows, Linux and Mac OS).

To download the application, please click on an icon representing your operational system.

                       


Installation

The installation process should take not more than 10 minutes. If you use a multi-channel respirometry system to obtain raw respirometry data (e.g. four chambers/tunnels at the same time), we recommend to work with a relatively large screen display to ensure comfort visual interaction with the ‘FishResp’ application.

Please install R and Java Development Kit before setting up the GUI application ‘FishResp’.  Further instructions are OS-specific and can be found below.

Recommended system requirements:
•  Display resolution >= 1366×768
•  RAM >= 2 GB

Software dependencies:
•  R (version >= 3.0.0)
•  R packages: rJava, chron
•  Java Development Kit (JDK)

Windows

To set ‘FishResp’ as a program on Windows, unzip the loaded archive and open the file ‘FishRespSetup.exe‘. Then, accept the license agreement and follow to further instructions of the installation wizard.

× If the R packages 'chron' and 'rJava' are not installed in your R library, the configurator will be automatically opened. Please specify the path to the folders, where R and it's library are located, to install the latest versions of those packages. After installation of the R packages, which might take a few minutes, click 'Save'.

Linux

To install ‘FishResp’ as an application on Linux (the installation process has been tested on Ubuntu 16.04 LTS 64-bit), run the following commands at Terminal:

sudo apt-get install r-base
sudo apt-get install openjdk-8*
sudo apt-get install openjfx

tar -xvf Downloads/FishResp.tar.gz
cd ~/FishResp
chmod u+x install.sh
./install.sh
FishResp

 

MacOS

To set ‘FishResp’ as an application on MacOS, unpack the loaded archive and open the file ‘FishResp.dmg‘. Follow to the instructions of the installer. Then, type this code in Terminal to install R packages ‘chron‘ and ‘rJava”:

cd Downloads/FishResp_mac
sudo Rscript installLibs.r

 


Quick Guide

The software consists of five tabs with functional blocks on the left side and information or graphical modules on the right side of the application. The analysis of data goes step-by-step: from the left tab to the right one, top-down in each tab.

Different colours of tabs and buttons are used as indicators of progress:

– the action is completed

– the action is required

– the action is unavailable

– plot a graph

 

Demo data for the application!

These sets of raw data were collected using an intermittent-flow respirometry approach and AquaResp (Loligo® Systems). Check it now and leave feedback here.

Stickleback            Guppy       


Manual


The manual is currently under progress (%)
40

 


Screenshots

Three screenshots represent the GUI application for Windows, Linux and MacOS, respectively (‘FishResp’, version 0.1.0).

Updated by Sergey Morozov, 18.10.2017