Quick links and FAQs on S-Plus: More on S-Plus, graphics, printing, etc:

More info on emacs editor, unix, computing, etc:


Intro to S-Plus

S-Plus is an interactive environment for graphics and scientific computation with a range of statistical modelling and analysis tools. We'll use S-Plus on the Acpub unix machines. Go to OIT's acpub unix pages if you're not already familiar with the basics of unix workstations and the public clusters.

To get started, here are a few S-Plus commands to read in the VA data set. First you should download this and the data file from the Data Sets link -- See the walk-through information on Lab 1. Learn S-Plus by doing. The S-Plus environment has a comprehensive on-line, window-based help system once you get beyond the basics; see the cheat sheet.

The best way to operate with S-Plus is from within the emacs editor. This allows you to easily re-use and edit S-Plus commands you used earlier, and does not require much knowledge of emacs. We'll support this in the course. Click on the "S-Plus within emacs" link on the list above to get going, and then follow the info on Lab 1.


S-Plus within emacs

In your home directory on acpub you may have a file called .emacs already; if not create one with an editor and simply add the line

(load "S-site")

If the file is already there, add the above line at the end. This will set you up to run S-Plus inside emacs. Try it:

Useful Shortcuts in Emacs
Familiarizing yourself with some shortcuts in the Emacs Reference Card makes life with emacs a whole lot easier.


Printing S-Plus graphs

First you should specify a default printer in the graphics window in S-Plus, as follows.

In the Soc 133 cluster, the two printers are imaginatively named soclp1 and soclp2.

In order to directly print the displayed graph in a motif() graphics window in S-Plus, go to the Options menu on the motif window and select "Printing...". In the window that comes up there is a command line: type "lpr -Psoclp2" to select soclp2 as the default printer for all future graphs. Then click on the "Apply" button, and then the "Save" button, and then close the window.

From here on, clicking the "Print" selection on the motif() window will print the displayed graph to that printer


Saving postscript files of graphs

You can save graphs in postscript files for later printing. For example,

  
        postscript(file="somefilename.ps")
        plot(prior,post)
        more plot commands here ...
        dev.off()  
  

creates a file called somefilename.ps in your directory, and all the graphs done before dev.off() are in there instead of on the motif() display.

Then from an x-window, you can print via either of

  
        lpr -Psoclp1 somefilename.ps
        lpr -Psoclp2 somefilename.ps
 

Working on your own PC you can ftp postscript files for viewing and printing in your room.


Multiple graphics windows

You may open two or more motif() windows and postscript() files for printing simultaneously. These are known by S-Plus as graphics devices, and referred to by dev commands. The first device opened is the window in which you are typing -- this is device 1. If you open a motif() window next, S-Plus knows it as device 2. Open another motif() window, that's device 3. Open a postscript() file next, and that's device 4, and so on. Then you can switch between devices to draw graphs on any one motif() screen, save to file, etc.-- do this using the dev.set() command whose argument is just the device number. At any time, graphs will go to the "current" device, always the last one used or opened. Here's an example; as usual the # signs are comments ignored by S-Plus.

  
        motif()                      # opens motif device, number 2 by 
default
        plot(...)                    #   and plots on motif device 2
        postscript(file="a.ps")      # open postscript file a.ps, now 
device 3
        plot(..)                     #   and draw something there 
        dev.set(2)                   # switch back to the motif screen
        plot(...)                    #   and a new plot there
        dev.set(3)                   # switch back to the a.ps file
        plot(...)                    #   add a plot there 
        motif()                      # open another motif screen
        plot(...)                    #   and draw there
        dev.set(2)                   # back to the first motif screen
        dev.off(3)                   # closes device 3 -- here the 
postscript file
    #    ...
    #    etc
  

As usual, explore the on-line help file (search by keyword dev) for more information.


Finding points on plots

In S-Plus with a graph displayed, enter the command

         locator(1) 
then click with the left mouse key somewhere on the graph. You'll see the x and y coordinates returned.

You could also assign these to a 2 element vector, say, myvec, via

         myvec<-locator(1)
Then click, then look at myvec by typing its name


The S-Plus MySwork directory

Every variable, vector, etc. created in S-Plus is saved in a directory named MySwork -- use the unix command ls -a to list all "hidden" files and directories starting with the "." and that do not get listed when you use the basic ls. This will reside as a subdirectory of your home directory or, if you created an "sta113" (or other name) directory for work on this course, MySwork will probably be in there. This means S-Plus objects will still be there if you log out and later log in and begin S-Plus again.

Problem: Every time you run an S-Plus session, more stuff is dumped there, for possible use in future S-Plus sessions. This grows and clogs up your disk space, and acpub allocates a limited amount to each user. Clean up periodically by simply erasing everything in there: in unix: rm MySwork/* removes everything in there, but leaves the MySwork directory for further use. Another strategy is to have a different MySwork subdirectory for each project you're working on.


X-Windows at home

X-Win32 is a computer program, available from OIT for free, that allows your home computer to mimic that of a cluster computer. You run it on your PC, log into acpub and then can open x-windows, run emacs, S-Plus graphics, etc etc as if you were sitting in an acpub cluster. Telecommute to school.


Viewing & downloading notes and slides

You can download my slides and notes -- most in postscript and pdf formats. This is easy directly on the acpub unix machines via Netscape. Clicking on a link to a postscript document will launch the Ghostview viewer under Netscape. Clicking on a link to a pdf document will launch the Adobe Acrobat viewer under Netscape. On your own PC or Mac, use an existing postscript or pdf viewer set up a plug-in application for your browser. For postscript (which is preferred) you can easily install the Ghostview previewer for PCs and Macs; here's the info:

Ghostview and GSview under Netscape and I.E. on PCs:


BUGS software

The more adventurous (computingwise) among you might, in later stages of the course, get interested in other software, including a package called BUGS that is developing as a general-purpose statistical modelling package, and is likely to be of interest as an application and research tool in future (as is S-Plus) for students continuing with statistics at a more advanced level.