CS 525 Linear Programming
                        MATLAB Setup Instructions
	Available from course homepage and course public directory
		(This is file ~cs525-1/public/MATLAB.setup)

Most of the assignments for this course will be carried out with the
aid of MATLAB, an interactive package for high performance scientific
computing.  

For most of the homeworks (but not the class project), you can use
your own version of matlab, running on your own laptop or on a system
in your own department. If you do so, you need to download the matlab
routines used in this course from the following web page:

http://www.cs.wisc.edu/math-prog/lpbook/

where they are available both individually and packaged as tar and zip
files. Instructions for setting up the matlab path in your local
environment are also given on this page.

You may also use the instructional linux machines in the CS department
(room 1350) to do the assignments. In fact, it is strong recommended
that you follow the steps below even if you do not intend to use CS
machines for your homeworks, as you will need to use these machines
later in the semester for your class project and will need to set up
this environment in any case.

The machines in CS 1350 are named mumble-01.cs.wisc.edu through
mumble-40.cs.wisc.edu. After activating your account (required on the
first login only; see instructions below), do the following:

mumble-10> mkdir matlab
mumble-10> cp ~cs525-1/public/startup.m  ~/matlab/startup.m
mumble-10> matlab &
 
The last command should set up a separate window in which matlab
should be running.  MATLAB has a built-in editor that mimics many of
the standard windows key operations.  It will enable you to create any
`m' files that you need for your work. (You can also create these
files outside of Matlab by using emacs, vi or other text editing
programs.) All the function files that are created by the instructor
as well as the homework and project data files can be found in the
public directory:

  ~cs525-1/public  
  
These are now available to you for use in MATLAB. For example the
function file ljx.m in this directory performs a labeled Jordan
exchange within MATLAB and its use is described in the text. After
copying the "startup.m" file as described above, you don't have to do
anything special to use the function "ljx", since Matlab knows to look
for it in the directory ~cs525-1/public.

If the start up time for MATLAB is too long for you, and you do not
use the "Matlab desktop", you can type the following instead of the
"matlab &" command:

mumble-10> matlab -nojvm  

This command disables the Java virtual machine, and the Matlab desktop
will not start. All matlab commands can then be typed into the window
from which you invoked this command. Alternatively, you can type
        
mumble-10> matlab -nodesktop      

This disables the Matlab desktop, and allows the JVM to start.

For homework assignments you should use the "diary" command to create
a record of your Matlab session, and print your file using the "print -2up" 
command.  For example:
 
mumble-10> matlab
>> diary hwk1.lastname.firstname
>> load hwk1
>> .....whatever homework 1 requires 
>> diary off
>> exit

mumble-10> print -2up hwk1.lastname.firstname

Remote Unix Machine Users 
-------------------------
Suppose you are logged remotely on a machine called cheddar.
On a cheddar window you do the following:

cheddar> xhost +mumble-10.cs.wisc.edu	

In the mumble-10 window on cheddar:

mumble-10> setenv DISPLAY cheddar:0
mumble-10> matlab

First-Time Users
----------------
Go to a Unix terminal that is a displaying a login window. 
Type in "newuser" without quotes next to login and hit return.
Follow next instruction:
[Type] UW Identification Number 
and subsequent instructions.