To Be Continued ...
Download Instructions
TBC is compiled and run under the Linux Redhat operating system. It can be run by
either downloading the executable code, or by downloading the source code and compiling
it on your own computer. The source code is necessary if you plan on using maps other
than the standard list included in TBC.
Executable download and install instructions.
-
Download executable tar file: TBC Version 5.3.3 March 2004
- Use the following comand to first unzip it and then untar.
gunzip tbc-exec.tar.gz | tar -xvf tbc-5.3.3_exec.tar
- This will create a directory named tbc. To save space, you may (optionally) remove the tar file now.
- Move into the directory tbc. Use the folowing command.
cd tbc. At this point there should be three files in the tbc directory:
an executable file: tbc.ex
an icon file: tbc_icon.xpm
a picture file: bpeckham.xbm
a tutorial file: tbc_tutorial.txt
- If you have the GUI software XFORMS installed, then you will NOT need to
do this step.
Download a shared object library file from XFORMS: libforms.so.0.89.
Download libforms.so.0.89.
The tbc directory should be a part of your $LD_LIBRARY_PATH environment
variable. If this environment variable is already set to some value, use the following
command to apppend the tbc directory:
setenv LD_LIBRARY_PATH $LD_LIBRARY_PATH:'tbc directory path'
If this variable is not already set, use the following command:
setenv LD_LIBRARY_PATH 'tbc directory path'
The setenv command may not work in bash shell. In that case change to csh or
tcsh. You may have to type in one of the following commands.
tcsh or
csh.
- Now type the follwing command on the command line:
tbc.ex (or ./tbc.ex).
You should see the software running.
- Follow the TBC tutorial for help.
- If you want to run TBC from a directory other than from the tbc directory ???????????,
your path variable should contain the tbc directory. If it already does, fine.
Otherwise use the following commands to add the tbc directory to the path variable.
setpath = ( $path 'tbc directory path' )
To find the current (tbc) directory path you may use the pwd command.
Source code download, install and compile.
- Make sure the GLUT toolkit
and XFORMS interface software are installed. (Both are standard on Redhat???????)
Provide links!!!!!
-
Download source code tar file: TBC Version 5.3.3 March 2004.
-
Unzip and untar using the following commands in order
gunzip tbc.tar.gz, and then
tar xvf tbc.tar
- You should see a directory named tbc. Now optionally remove the tbc.tar file.4.
Move into the directory by using the following command: cd tbc
- Open the mkconfig.h file. In this file you will have to enter some information. There are four variables XFORMSINCDIR, GLUTINCDIR, XFORMSLIBDIR, GLUTLIBDIR.
You should provide appropriate values for them. XFORMSINCDIR should have the directory in
which the forms.h file is present. To find the directory you can use the locate command:
locate forms.h
This will tell you the various places where forms.h is present. The value of
XFORMSINCDIR should be only the directory name( exclude the forms.h part! ).
In a similar manner you can find glut.h, libforms.a and libglut.a and these will form
corresponding values for GLUTINCDIR, XFORMSLIBDIR, GLUTLIBDIR.
- Once this is over you are ready to compile TBC. Use the following command: make tbc
- On successful compilation, an executable named tbc.ex will be created.
- Now you will have to set an environment variable named LD_LIBRARY_PATH. If you
do not already have this set to a specific value use this command.
set LD_LIBRARY_PATH = ( XFORMSLIBDIR:GLUTLIBDIR )
Note: Substitute for XFORMSLIBDIR and GLUTLIBDIR whatever values you entered
in the mkconfig.h file.
If you already have this environment variable set to a value. use the following command.
set LD_LIBRARY_PATH = ( ${LD_LIBRARY_PATH}:XFORMSLIBDIR:GLUTLIBDIR )
Note: Again substitute for XFORMSLIBDIR and GLUTLIBDIR whatever values you e
ntered in the mkconfig.h file.
You may want to have this line in your .cshrc or .login or .personal, so that
you wont have to repeat this step this everytime you run TBC.
- Now you are ready to use TBC. Type the following command:
./tbc.ex
- Start using TBC. Read the TBC tutorial for help.
This page is maintained by Bruce Peckham (bpeckham@d.umn.edu)
and was last modified on Monday, 09-May-2005 13:49:24 CDT.