Ptolemy 0.7.1 has been installed in /usr/local/packages/ptolemy0.7.1 on
the Solaris machines in the Learning Resource Center.  We installed
pre-built binaries that used the following version of the GNU C++ compiler:

  egcs-2.90.27 980315 (egcs-1.0.2 release)

Hence, you will need to use this version of the GNU compiler when
dynamically linking new functionality into Ptolemy.

0.7.1 signifies the seventh major release of Ptolemy.  The '0' in front
means that Ptolemy is considered experimental, university software and
not commercial software.  Nonetheless, several parts of Ptolemy have been
commercialized.

To set up your account to run Ptolemy, you can either copy over my .cshrc,
.mycshrc, and .mylogin files from my ~bevans LRC account, or add the
following to your .cshrc file:


# Open Windows home
setenv OPENWINHOME /usr/openwin

# Ptolemy settings.
# PTOLEMY is the full path name where Ptolemy is installed
# PTARCH is the type of machine on which you are running, e.g. sol2.5.
# Even though the LRC machines are 
setenv PTOLEMY /usr/local/packages/ptolemy0.7.1
if (-x $PTOLEMY/bin/ptarch) then
  setenv PTARCH `$PTOLEMY/bin/ptarch`
else if (-x $HOME/bin/scripts/ptarch) then
  setenv PTARCH `$HOME/bin/scripts/ptarch`
else
  setenv PTARCH sol2.5
endif

# Use the right version of the GNU compiler and set the shared library path
source $PTOLEMY/bin/g++-setup

# Add to the shared library path according to the local LRC setup
# SHLIB_PATH is for HPs; LD_LIBRARY_PATH is for other Unix operating systems
if ( $PTARCH =~ hppa* ) then
  set hpxwinlibs=/usr/local/X11/lib
  set hpuserlibs=/usr/lib
  setenv SHLIB_PATH {$hpxwinlibs}:{$hpuserlibs}:{$SHLIB_PATH}
else
  set solxwinlibs={$OPENWINHOME}/lib:/usr/local/X11/lib
  set soluserlibs=/usr/lib:/usr/ucblib:/usr/dt/lib
  setenv LD_LIBRARY_PATH {$solxwinlibs}:{$soluserlibs}:${LD_LIBRARY_PATH}
endif

# Ptolemy user installation -- $PTOLEMY/bin has to go before
# $PTOLEMY/bin.$PTARCH for tycho and mkPtolemyTree to work 
set path=($PTOLEMY/bin $PTOLEMY/bin.$PTARCH $path)


You will also need to add the following line to your ~/.Xdefaults file:

vem*technology:                 $PTOLEMY/lib/colors

Once you made these changes, you will need to restart X windows.
If you are using a X terminal, then please make sure that you start
an X windows manager such as twm.  If you start the Common Desktop
Environment (CDE) and you try to run Ptolemy, Ptolemy may crash
because it cannot find one of the CDE fonts.

To finish the installation, do the following in your home directory:

cd
ln -s /usr/local/packages/ptolemy/demo/init.pal .

This is a palette of the demonstration programs.  When Ptolemy starts, it looks
for init.pal.  And finally

pigi &

to run Ptolemy.  Pigi stands for the Ptolemy Interactive Graphical Interface.

All three of the Ptolemy manuals (User's Manual, Programmer's Manual,
and Kernel Manual) are available on-line at

http://ptolemy.eecs.berkeley.edu/

The LRC also has a User's manual available for check out.  Ptolemy also
has on-line help, and has a built-in Web browser.  The Web brower is
a part of Tycho.  Hit 'y' for Tycho and then select "Ptolemy Home
Page" under the "Help" menu.

To get started, begin with Chapter 2 of the User's Manual which introduces
you to the user interface.  Then, go to Chapter 5 of the User's Manual and
do some of the student exercises.

By hitting the middle mouse button, you will get the schematic management
menu.  By hitting SHIFT and the middle mouse button, you will get the Ptolemy
menu for running demonstrations, etc.  'SHIFT-R' will run a demonstration, and
'i' will look inside an icon.

Enjoy!

Brian L. Evans
Assistant Professor
bevans@ece.utexas.edu