Hi,

We have released two demonstration projects written in Java (not JS)  that show how to use the Processing data visualization framework to create interactive programs to connect to and display data from our Immune Tolerance Network TrialShare system.   TrialShare was created to help clinical trials researchers to present and discover data related to immune system research.

There is a 2D and a 3D program, and the source code and necessary libraries are included in the .zip files.  Both programs use the Processing 2.0, LabKey API,  and the ControlP5 library.  The 3D program also uses Proscene for camera control.

To access the .zip files, you will have to register for a free account at https://www.itntrialshare.org (click on the Request an Account button on the right center).  We only require this because you will need to agree to our terms of use, since we are sponsored by NIAID.  Registration is free and instant; you should receive your email with the registration link within a few seconds.

Once you have a username and password, you can find the source code and libraries at:

https://www.itntrialshare.org/_webdav/Shared/@files/Source/processingTrialshare2D.zip

https://www.itntrialshare.org/_webdav/Shared/@files/Source/processingTrialshare3D.zip

.. or you can go to the Source folder in the file browser at:

https://www.itntrialshare.org/project/Shared/begin.view?

If you are using IntelliJ IDEA, you’ll just need to extract the 2D or 3D source archive to a location of your choosing, and then File>Import Project and select that folder. 

Make sure that you set the JDK to at least 1.7 and the project language level to at least 7.0 (File>Project Structure). 

In Edit Configurations (when you try to run the program), you will need to create a launch configuration based on Application.  The main class will be org.immunetolerance.trialshare.processing.Main.

In the constructor of the TrialShareConnectAndReceive class, you will see one line which reads cn = new Connection("https://www.itntrialshare.org/", "youremail@somewhere.com", "yourtrialsharepassword");.  You should enter your username(email) and password here.  However, I’ve also included serialized versions of the data within the projects in case you wish to work offline or cannot connect to the server.

That’s about it, the program should run but it does take a few seconds before the visualization starts.

The programs run in Jframes with the extended Processing applets inside them.

Please let us know whether you succeed (or fail) at getting these to run.  If you are an Eclipse or Netbeans user, we don’t foresee any problems getting the programs to compile and run but we certainly welcome your feedback and perhaps even the steps needed for those IDE’s.  If you have any questions, you can contact us at trialsharesupport@immunetolerance.org