Alan Kaminsky Department of Computer Science Rochester Institute of Technology 4572 + 2433 = 7005
Home Page

Tuple Board Library

Prof. Alan Kaminsky
Rochester Institute of Technology -- Department of Computer Science

Overview
Preinstalled Version
Download Version
System Requirements
Installation
Usage
License
Documentation (Javadoc)


Overview

Tuple Board (TB) is a new distributed computing paradigm for developing collaborative applications running on ad hoc networks of mobile computing devices. The Tuple Board Library is a tuple board API and middleware written in 100% Java. TB was developed by Professor Alan Kaminsky and his students Chaithanya Bondada and Yutao Cheng in the Department of Computer Science at the Rochester Institute of Technology.

Publications about TB:

Master's projects using TB:


Preinstalled Version

The Tuple Board Library is installed on the Computer Science Department computer systems. When working in your Computer Science Department account, use the preinstalled version.

Classpath -- /home/fac/ark/public_html/tb.jar

Add that JAR file to your classpath when you run the programs. See Usage below for further information.

Documentation -- /home/fac/ark/public_html/tb/doc

Point your HTML browser to that directory or to this URL: http://www.cs.rit.edu/~ark/tb/doc/index.html


Download Version

The download version of the Tuple Board Library is for installation on your personal computer only. Do not install it in your Computer Science Department account. When working in your Computer Science Department account, use the preinstalled version (see above).

There are two versions of the TB distribution that you may download, an executable distribution and a source distribution.

Executable distribution. The executable distribution comes in a Java Archive (JAR) file named "tbYYYYMMDD.jar", where YYYYMMDD are the year, month, and date. The executable distribution includes the TB class files only.

Version 27-Nov-2007 (206,568 bytes): tb20071127.jar

Source distribution. The source distribution comes in a Java Archive (JAR) file named "tbsrcYYYYMMDD.jar", where YYYYMMDD are the year, month, and date. The source distribution includes the TB class files, source files, and documentation files (Javadoc).

Version 27-Nov-2007 (1,427,406 bytes): tbsrc20071127.jar


System Requirements

TB was developed using Java Development Kit (JDK) 1.5.0. TB uses generics and other Java language and Java platform features introduced with JDK 1.5.0 and will not work with earlier JDK versions.


Installation

Executable distribution. To install the executable distribution, simply store the JAR file somewhere. You may wish to change the file name, say to "tb.jar".

Source distribution. To install the source distribution, just unpack the JAR file. The source distribution expands into a subdirectory named "tb". If you already have a subdirectory of that name which you want to save, be sure to unpack the JAR file in some other directory. Documentation is stored under the directory "tb/doc"; point your HTML browser to that directory. Java source files and class files are stored under the directory "tb/lib".


Usage

Executable distribution. When compiling and executing Java programs that use the TB Library, if you have installed the executable distribution, you must set your classpath to include the TB JAR file. Here is an example of a command for the bash shell to set the classpath to the current directory plus the TB JAR file:

export CLASSPATH=.:/home/fac/ark/public_html/tb.jar

Here is an example of a command for the csh shell to set the classpath to the current directory plus the TB JAR file:

setenv CLASSPATH .:/home/fac/ark/public_html/tb.jar

Source distribution. When compiling and executing Java programs that use the TB Library, if you have installed the source distribution, you must set your classpath to include the top-level directory under which the TB Library's Java class files are stored. Here is an example of a command for the bash shell to set the classpath to the current directory plus the TB directory:

export CLASSPATH=.:/home/fac/ark/public_html/tb/lib

Here is an example of a command for the csh shell to set the classpath to the current directory plus the TB directory:

setenv CLASSPATH .:/home/fac/ark/public_html/tb/lib


License

The documentation and Java source files in the Tuple Board Library ("The Library") are copyright © 2006-2007 by Alan Kaminsky. All rights reserved. For further information, contact the author, Alan Kaminsky, at ark­@­cs.rit.edu.

The Library is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

The Library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

A copy of the GNU General Public License is provided in the file gpl.txt. You may also obtain a copy of the GNU General Public License on the World Wide Web at http://www.gnu.org/licenses/gpl.html.

Alan Kaminsky Department of Computer Science Rochester Institute of Technology 4572 + 2433 = 7005
Home Page
Copyright © 2009 Alan Kaminsky. All rights reserved. Last updated 30-Jul-2009. Please send comments to ark­@­cs.rit.edu.