The PSciCo Project: Internal Page

Documents

Setting up PSciCo on Windows NT

To get pscico running on Windows NT, you need to install the following items:

the SML/NJ ML system on your machine
the cvs source control system on your machine
a pscico working directory on your machine

Installing SML/NJ on NT

To install SML/NJ on NT, you need to get the binaries, and libraries, install the binaries and libraries, set up the SML/NJ directory structure and set up the environment.

Get the binaries for the latest SML/NJ.
Follow the instructions at Bell Labs. There is a new self installing software package for SML/NJ, but I have not tried installing it.

NOTE: When you set the environment variable SMLNJ_HOME, be sure to enclose the path in double quotes. Otherwise, SML/NJ will misinterpret your path.

SML/NJ Library

If you want to include SML/NJ library structures conveniently, you need to add some environment variables, folders, and files to your system. The following modifications allow you to use the same .cm files on both UNIX and NT. In the following instructions, I assume that your SML/NJ root folder has the path C:/Program Files/smlnj.

Set CM_PATH to C:/Program Files/smlnj.
Create a directory named 'lib'.
Create a file called 'smlnj-lib.cm' with the following line:
Alias C:\Program Files\smlnj\smlnj-lib\util\sources.cm
You can add more CM Alias files to the lib directory to support other SML/NJ services like YACC and CML.

Adding the following line to your .cm files enables you to use the SML/NJ library routines.
lib/sml-nj.cm

To view the paths that CM uses to search for .cm files, use the following command at the SML/NJ prompt:
CM.set_path NONE;

PSciCo Library

You can easily make CM search the PSciCo libraries by appending your pscico working directory path to your CM_PATH variable.

Using CVS with Windows NT

Installing CVS

In the following instructions, I assume that the CVS working directory is 'C:\Program Files\unix\cvs'. You can use any directory you like though. A working directory is the directory you checkout files to, and modify source code in.

Download the CVS archive 'cvs-1_9-win.zip' from pscico's tools directory.
Unzip the CVS archive into 'C:\Program Files\unix\cvs'.
Add the directory 'C:\Program Files\unix\cvs' to your environment's PATH variable.
Test that CVS is properly installed by bringing up the DOS command prompt, and typing the command 'cvs -v'. You should see a message stating that the version of CVS is 1.9.

Using CVS Locally

To use CVS locally, you need to mount pscico's AFS repository as a network drive. If you can't do this please read Using CVS Remotely. Assume you have the pscico directory mounted as drive 'P:'

Set the environment variable CVSROOT to ':local:P:\srccvs'.
Set the environment variable USER to your user name.

Now you need to install the pscico source tree on your machine, by checking out the source tree using CVS. Assume you want the pscico directory installed in the directory 'C:\user\derby'.

Bring up the DOS command prompt.
CD to the directory 'C:\user\derby'.
Type the command cvs checkout pscico.

This procedure will install a directory called pscico in the directory 'C:\user\derby' containing the current pscico sources. You can bring the source files in your working directory upto date by issuing the following command:
cvs update -d
The -d option creates any new directories which have been added to the project.

NOTE:It is important that the -d flag comes after update keyword. cvs -d updatemeans something totally different.

Using CVS Remotely

I'm working with the CVS maintainer to figure out how to use CVS remotely.

Installing Pscico on Unix

To set up pscico on Unix, you need set up the following items:

the environment variables for pscico
a pscico working directory

Pscico's Environment Variables

You need to modify your shell's startup script. If you are using bash, you would add the folling lines to your .bashrc:

# The pscico project directory PSCICO=/afs/cs/project/pscico # Your working directory WORKING=~/pscico # Pscico's source code repository CVSROOT=$PSCICO/srccvs export CVSROOT # The latest version of SML/NJ SMLHOME=$PSCICO/src/sml/smlnj/110 # Set up the path to use the latest cvs and SML/NJ PATH=/afs/cs/misc/cvs/@sys/beta/bin:$SMLHOME/bin:$PATH # Set the search path for CM to look in the pscico and SML/NJ libraries CM_PATH=$WORKING/lib:$SMLHOME export CM_PATH

Pscico's Working Directory

Using the Pscico Project

Pscico's CVS setup

Pscico
- app - contains various scientific applications
  - nbody - contains various nbody implementations
  - convexhull - contains various convex hull implementations
- lib - contains code implementing PSCICO library routines
  - numbers - algebra, e.g., rings, fields
  - geometry - geometry, e.g., points, vectors, hyperplanes
  - graphics - contains code for creating 3D models in VRML. Here is a torus to test out
  - random - contains source files implementing a simple sequential random number generator. I will extend this module with a parallel random number generator later.
  - generatepoints - contains source files for generating different distributions of points
  - sequence - in progress
- www - This module contains the HTML index page for the top level PSCICO dirctory.
  - media - This module contains pictures, textures, etc. for the home page.

Questions

If you have any question about this web page, please send mail to Dave Swasey.

Last update: Monday, July 30, 2001 2:12:21 PM