VitruTrace: VT-Graph

An application for real-time graphing of physiological data


VT-Graph is an android application developed for the VirtuTrace project under the direction of Drs. Nir Keren and Warren Franke. The system is used for collecting physiological data from participants during simulations with soldiers, law enforcement officers, and firefighters in virtual reality environments. The participant is hooked to Biopac which monitors physiological data such as ECG, cardiac output, respiration rate, and galvanic skin response which is sent to an Android device running VT-Graph.

User Guide

Getting Started

This guide will walk you through the basic steps of using the VT-Graph application. It will explain how to connect to a server from an Android application, how to create a “Dashboard” which is a particular configuration of graphs, and how to activate and switch between these Dashboards.

Connecting to a server

When you launch the app you will see a dialog that says “Configure Server” with two editable fields. The first is the SERVER IP field in which you will enter the IP or server name that you wish to connect to. The last server connected to will be remembered by the application so you don’t need to type it in every time. The second is the PORT NUMBER. The default port number is 9999, but if the BioPac daemon (not explained here) is set to use a different port then you will need to change this setting.

When you have entered the corrent information, click the “Connect” button in the bottom right of the dialog to connect to a server. If you accidentally dismiss the dialog without connecting, that’s ok, just click “connect” in the top right corner of the action bar to launch the “Configure Server” dialog again.

Creating a Dashboard

After connecting to a server you will see an action bar across the top of an otherwise blank screen. Clicking the icon and “BioGraph” in the upper left corner of the screen will open a slide-out menu. This will hold a list of the configured Dashboards and has “+Create New…” button.

To create a new Dashboard, click the “+Create New…” button. This will launch a dialog with the title “Enter Dash Name”. Enter the desired name and click “ok”. This will create and save a Dashboard and launch another dialog to create and edit graphs.

Creating a Graph

The Graph List

After creating a Dashboard, a dialog will automatically launch that says “Select Graph:”. This can also be reached by clicking on a Dashboard in the slide out menu and selecting “edit” from the options menu that pops up. Selecting a graph that has already been made will allow you to edit it, and selecting “+Create New…” will open a screen to configure a graph. There currently is no way to delete a graph once it has been created for a Dashboard. Hopefully this will be fixed, but until then the only way around this is to create a new Dashboard with the correct number of graphs.

Entering a Name/Selecting a Type

The “Edit/Create Graph” screen has a text field in the top to enter the name of the graph. After that is a drop down to select the type of graph. Right now the supported types are “line” and “text”. A line graph will draw a standard line graph, connecting each of the incoming data points in a line, scrolling across the screen. This is good for visualizing data such as an ecg form or the pattern of a participants breathing. A text graph will display a a numerical value (with units, if provided by the system), showing the most recent value received. This is useful for showing the patients heartrate or respiration.

Selecting Channels

Below that there is a list of data channels that you can choose to have displayed on a particular graph. These are the channels that are provided by the BioPac and will be a series of letter/number pairs such as A1 (for analog channel 1), D1 (for digital channel 1), or C1 (for calculated channel 1). Be careful, if you configure a graph to talk to channel A1 now, but try to activate this graph later when connected to a server that does not have a channel A1, the app may behave inappropriately or crash. If you are using a line graph you may select multiple channels, provided they have the same sampling rate. If you are using a text graph you should only select one channel. If the list is empty that means you aren’t connected to a server OR the server isn’t configured properly.

Selecting a position

Below the channel list you will see the Position selector. On either side of the screen will be arrows (“«” and “»”) and below that will be a preview area. The display is divided into a 3x2 grid, and each graph can take up any size rectangle within that grid. That means that a graph can take up a 1x1, 2x1, 2x2, or any other open spot. However, the options are automatically restricted to those that do not overlap with other graphs. Pressing the left or right arrow will change the preview to show where this graph will be. When you are satisfied with the configuration of the graph, click save which will take you back to the Graph List where you can edit other graphs or create more.

Activating a Dashboard

From the slide out menu, select the Dashboard that you want to activate. A popup menu will show you options such as “rename” the Dashboard, “activate” a Dashboard to see its graphs plotting, “delete” a dashboard to remove it and all its graphs from the system, or “edit” it to add or edit graphs. Selecting “Activate” will update the main display area to show the graphs that were configured and will begin fetching information from the server that you have connected to. If you are NOT connected to a server, the app may crash. If that happens, re-launch the application, make sure you connect properly, and try again. Once activated you should see the information scrolling across the screen.