Getting Started Guide

This document provides a basic overview of the functionality of Eureka! Clinical Analytics.

Browser Compatibility

We have made a great deal of effort to support recent versions of major browsers (Firefox, Safari, Chrome and Internet Explorer), though we have not tested every version. We have tested on Mac OS X (Snow Leopard, Lion and Mountain Lion), Windows 7 and the Ubuntu and Mint Linux distributions. Firefox and Internet Explorer have received the most testing. If you encounter an issue while using your favorite browser, we encourage you to try Firefox or Internet Explorer instead. Please report the issue using the email address in the Contact page so that we can investigate and enhance compatibility with your browser of choice.

First Time

The first time that you go to Eureka! in your browser, you will see a button bar underneath the Eureka! logo. On the left side of the button bar, there are buttons for getting Help, requesting an account on Eureka! (Register), learning more about the Eureka! Clinical Analytics project (About) and getting contact
information for technical support (Contact). On the right-hand-side, there initially is a single button to login to your account (Login), which you may use after you have registered with Eureka! Clinical Analytics and your account has been created.


To obtain a user account on the website, click Register in the button bar. You must provide your first and last name, an organization name, an email address that will serve as your user id, and a password (minimum 8 characters). You then will need to click the checkbox next to End User Agreement, which means that you agree to its terms (please click the End User Agreement link to read!). Then, click Submit. You will receive an email at the entered email address with instructions to verify that it was you who requested the account.

After you verify your account request, your account will be created. You will receive another email when your account has been created and is ready to use. If you do not receive this email within the specified timeframe, send an email to the address listed in the Contact page for help.

First Time Login

Once your account is ready to use, go to the website and click the Login button on the right-hand side of the button bar. You will enter the email address and password that you specified in the Register page. If you have forgotten which of your email addresses that you used or your password, please follow the instructions on the Contact page for getting help.


After you have logged in, your email address will be displayed on the right-hand-side of the button bar. Next to it, you will find buttons for ending your session (Logout), editing data elements (Editor), uploading data to i2b2 (Upload Data), and going to i2b2 (i2b2). You also will see an additional button on the left-hand side of the button bar called Account, which if clicked will show you your account information and allow you to change your password. After you change your password, you will receive a notification by email. If you get this notification email and you did not change your password, please contact us to report the incident.

Creating Data Elements

Content about creating data elements goes here.

Creating a Spreadsheet

Eureka! currently supports uploading data into i2b2 from an Excel spreadsheet with the xlsx extension. The spreadsheet’s contents must conform to a specific format and the data must be represented in a certain way for Eureka! to recognize the data and load it into i2b2 properly. Eureka! comes with a sample spreadsheet that conforms to the proper format. To get it, click the Upload Data button in the button bar, and then click the Download Sample Spreadsheet link. We recommend that you use the sample as a template for creating your own data spreadsheets. Go to Creating a Spreadsheet for details.

Uploading a Spreadsheet

Once your spreadsheet is created, click the ‘Choose File’ button on the ‘Upload Data’ page and select your spreadsheet in the file chooser. We recommend starting by uploading the sample file (see previous section) without modification. The name of the spreadsheet file should appear on the page. Then click Upload. Status messages on the Upload Data page will tell you where in the upload process your file is. You may logout of Eureka! while an upload is taking place and the upload will not be disrupted. The next time you log in and go to the Upload Data page, the status of your upload will be displayed. When the status messages indicate that the upload has completed, it is ready to view in i2b2.

Going to i2b2

Click the i2b2 button in the button bar to go to your own personal i2b2 "project" in a separate window. You will need to login to i2b2 using the same email account and password that you used to login to Eureka! Clinical Analytics as your username and password, respectively. Leave the i2b2 Host as "localhost". After you click Login, you will be taken to your dataset. Click the Help button in the upper right corner of the i2b2 user interface for directions.

Uploading a New Dataset

You only can have one dataset loaded into your i2b2 project at a time. When you upload a new dataset after having uploaded data previously, the old data will be deleted.

Ending Your Eureka! Session

Click the Logout button to end your Eureka! Clinical Analytics session. It is highly recommended that you close your browser to ensure your account’s security. i2b2 has its own Logout link in the upper right corner of the i2b2 user interface that you should use to end your i2b2 session. You may go back to i2b2 to query your dataset at any time either by using the i2b2 button in the button bar or going directly to i2b2 in your web browser.

Getting More Help

If you did not find the answer to your question or the solution to your problem here, please send an email to help [at] eurekaclinical [dot] org. We will get back to you shortly! If you encounter an issue, we encourage you to report it to help [at] eurekaclinical [dot] org so that we can fix it as soon as possible. When reporting an issue, please include as much as possible of the following information: your operating system (for example, Mac, Windows, Redhat Linux) and version, your web browser (for example, Firefox, Chrome, Safari, Internet Explorer) and version, a detailed description of the behavior you saw that is incorrect, and a description of the behavior that you expected. If we are unable to reproduce what you saw, we may contact you via email for more information.