Set up the Eclipse ptII project .classpath for Ptolemy II

Once you have downloaded the Ptolemy II source files, Eclipse uses the .classpath file to set paths and exclude files.
There are two choices:
  1. In the Ptolemy II source tree, copy .classpath.default to .classpath. This choice is the simpler choice, but might exclude optional third party packages.
    If you are working with accessors, then only choose this option if you have already checked out accessors repo, see: Eclipse is unaware of the version control aspects of the Ptolemy II project, use the shell version of Subversion to update the tree..
  2. Run ./configure. This choice is more complex, but this choice will include optional third party software that is already installed on your machine.
    If you checked out the ptII svn repo using read/write access and you have an EECS LDAP account on repo.eecs.berkeley.edu, then running ./configure or reloading an accessor will check out the accessors repo for you.
    If you checked out the ptII svn repo using read/write access and you have an external account name (an account that is an email address) on repo.eecs.berkeley.edu, then you must check out the accessors repo before running configure.
  1. Choose one of the options below

    A. Copy .classpath to .classpath.default

    OR

    B. Run ./configure

    Ptolemy II includes a number of packages that rely on software that you may or may not have installed, such as MATLAB, the rxtx package (for serial port connections), Java Advanced Imaging (JAI), the Java Media Framework (JMF), and Java 3D. If you wish to use or extend these features, you will need to perform a few extra steps. These steps require execution of a script called configure in the Ptolemy II home directory.

    The procedure below will modify the .classpath file that is provided in the version control repository to customize it for the software that you have installed.

    1. Unfortunately Windows does not ship with Unix shell commands like make. The workaround is to install Cygwin, see http://ptolemy.eecs.berkeley.edu/ptolemyII/ptIIlatest/cygwin.htm
    2. Start up the Cygwin Bash shell: Start | Run | Cygwin
    3. Change to the directory where the Ptolemy II source code was installed. For example:
      	      cd c:/Ptolemy/ptII8.1.devel
                  
      Note that if there are spaces in the path name to the directory where your Ptolemy installation is located, then you should use double quotes around the path:
      	      cd "c:/Documents and Settings/yourLogin/workspace/ptII"
      	  
    4. Set $PTII to the location of the Ptolemy II source tree:
      	      export PTII=c:/Ptolemy/ptII8.1.devel
      	    
      Again, if there are spaces in the path, use double quotes: export PTII="c:/Documents and Settings/yourLogin/workspace/ptII"
    5. Run:
      	      ./configure
      	    
      This will create $PTII/.classpath
  2. Choose one of the choices above.
  3. Once you have configured .classpath, go back to Eclipse and do File | Refresh so that Eclipse gets the updated .classpath file.
  4. Build Ptolemy II by doing Project | Build All.
    Note that you may want to select Project | Build Automatically..
  5. Go on to Running Ptolemy II.