medview

Medview viewer is a distributed collaborative neuroimage visualization application that is delivered to the users over the web without requiring the installation of any additional software or browser plugging. This not only enhances accessibility and usability for the end-users but automatically provides them with the latest application updates without requiring any technological skills or administrator-level access to their computing devices.

The viewer can read a directory tree (chrome) or multiple neuroimage files in the same directory (other browsers) for their visualization and collaboration through the embedded viewerjs.Viewer visualization object (VObj). Alternatively users can directly drag in and drop files/folders onto the viewer.

Users can start a real-time collaboration session as the collaboration owner or alternatively joint to an existing collaboration session by clicking the "Start collaboration" button. The Google’s login and/or authorization windows will then pop up and after successful completion they will be able to share visualization and collaborate in real-time.

Please take a look at the viewerjs.Viewer's wiki to learn how to interact with the embedded VObj through peripheral device controls.

A live version the web application is available here: http://fnndsc.github.io/medview/.

Build

This project uses grunt.

Pre-requisites:

• NodeJs - http://nodejs.org/

Ubuntu / Debian

On Ubuntu type systems, you might need to also install legacy node support:

sudo apt-get install nodejs-legacy

Install npm support

• Ensure that your npm is up-to-date:

sudo npm update -g npm

• Install grunt's command line interface (CLI) globally:

sudo npm install -g grunt-cli

• Install bower:

sudo npm install -g bower

Post npm issues

If you encounter issues with permissions (unable to mkdir for example) when you run npm as yourself, make sure that in your home dir that the npm tree is owned by you:

cd ~
sudo chown -R $(whoami) ~/.npm

Clone

Directly with ssh

git clone git@github.com:FNNDSC/medview.git

or, with https

https://github.com/FNNDSC/medview.git

Once you've cloned the repo, you'll need to build the subcomponents.

Install components (viewerjs)

The following are run from the checked out medview directory.

• Install grunt and gruntplugins packages that are needed for development and building. These are defined in package.json:

npm install

• Now install the medview source dependencies listed in bower.json:

bower install

• Run grunt to test and build the project:

grunt

The production web app is built within the directory dist.