Creating a customized version of Pisces

There are two steps to complete:

1. create a Pisces "work directory";
2. tell Pisces what kind of machine you are on.

Create a Pisces "work directory"

We suggest the following steps:

• % setenv PISCES /u/gcg/Pisces
  (change the directory to reflect your configuration)
• % mkdir $HOME/Pisces
• % mkdir $HOME/Pisces/work
• % cd $HOME/Pisces/work
• % cp $PISCES/work/Make* .
• % cp $PISCES/work/model* .
• % cp $PISCES/work/pisces .
• % chmod +w *
• Edit the Makefile. Change the first line of the Makefile to reflect the location of $PISCES on your system.
• Edit the pisces script and follow its instructions.

Environment setup (tell Pisces your machine type)

Before you do any Pisces development work you should edit your .cshrc (or the init file of whatever shell you use) so that it sets the MACHTYPE environment variable to a value that depends on the type of machine you're logged into. Currently the valid values are "sgi", "sun", and "next". As we expand Pisces to run on more machine types we will add more to this list.

In the simplest case, you will always run Pisces from the same kind of machine. If, for example, the machine on your desk is a SUN, then you can put the following line in your .cshrc file
setenv MACHTYPE "sun" .

The more complicated situation is that several people at your site want to use Pisces, possibly from different machines. At the Geometry Center our system-wide initialization file sets the CPUTYPE environment variable, so you can use its value to determine the value for MACHTYPE. The following C-shell command does this, so you can put this in your .cshrc file:

        switch ($CPUTYPE)
          case NeXT:
            setenv MACHTYPE "next" ;
            breaksw ;
          case iris4:
            setenv MACHTYPE "sgi" ;
            breaksw ;
          default:
          case sun4os4:
            setenv MACHTYPE "sun" ;
            breaksw ;
        endsw
       

The system of Pisces makefiles uses the MACHTYPE value.