To get the ribbons 2.45 binary / no support distribution over the network
	(This is SGI specific, requires IRIX OS IRIX 5.2 or higher)
	(This is just version 2.4 compiled under IRIX 5.2):


    1)  Set up a directory named "ribbons" on your machine.

	Go there:

		cd /somewhere/on/your/machine/ribbons


    2)  Get the ~6 megabyte compressed tape archive files.

	Connect to our machine (xtal.cmc.uab.edu == 138.26.45.1) via FTP:

		ftp xtal.cmc.uab.edu
			or
		ftp 138.26.45.1

	Login as "anonymous",  e-mail address as password.

	Issue the following commands:

		cd /ribbons/rib245 	{ go to right directory }
		get untar.csh           { get the script to unpack archives }
		binary			{ to set file type for transfer }
		get rib_bin.z		{ get the executables /bin directory }
		get rib_dat.z		{ get the /data directory }
		get rib_doc.z		{ get the /doc/rgb/showcase dirs }
		get rib_etc.z		{ get assorted extra dirs }
		bye			{ quit FTP }

	The files should be this big (ls -lt):
        -rw-r--r-- 1 carson   cmc          424 Dec  6 09:30 untar.csh
	-rw-r--r-- 1 carson   cmc      1081736 Dec  6 09:20 rib_bin.z
        -rw-r--r-- 1 carson   cmc       906779 Dec  6 09:20 rib_dat.z
        -rw-r--r-- 1 carson   cmc      2070020 Dec  6 09:21 rib_doc.z
        -rw-r--r-- 1 carson   cmc       203493 Dec  6 09:21 rib_etc.z
        -rw-r--r-- 1 carson   cmc       516350 Dec  6 09:21 rib_src.z



    3)  Uncompress and extract the information.

	Issue the following commands:

		csh untar.csh   ( you should see many file names scroll by )	

        Issue the following commands to see if you got it all:

                ls -F         { -F flags directories by adding trailing '/' }
                              { you should see ~13 directories }

        At this point, you may remove all the *.z archives and untar.csh
        (unless you want to make a backup in this form).



    4)  See if it works.

	All ribbons users must:
	1)	have the environment variable RIBBONS_HOME set.
	2)	have the directory  $RIBBONS_HOME/bin  in their UNIX path.

	To set the environment variable interactively,
	    Go to your directory "ribbons", type:
		setenv RIBBONS_HOME `pwd`

	To set the environment variable automatically on login,
	    Add the line below to your .login or .cshrc file:
		setenv RIBBONS_HOME  /the/full/path/on/your/machine/ribbons

	To add to your command path interactively,
	    After doing the "setenv", type:
		set path = ( $path $RIBBONS_HOME/bin )
		rehash

	To add to your command path automatically on login,
	    Add the two lines below to your .login or .cshrc file:
		setenv RIBBONS_HOME  /the/full/path/on/your/machine/ribbons
		set path = ( $path $RIBBONS_HOME/bin )


        Issue the following commands:

	1)	Run the interactive demo:

                	ribbons-demo

           Notes:
		Sweep out the window opened by the interactive program.
		Choose a model to view with RightMouse pop-up menu.
		LeftMouse controls scaling, MiddleMouse XY rotations.
		The workings are supposed to be intuitive.
		"Help" selected from MainMenu brings up Showcase screens.


	2)	Run with your data:
           	For a default ribbon of your favorite single-chain protein,
		create a new directory, go there, copy your coordinates
		with ONLY the protein atoms in your PDB file, then:

                	ribbon-model prot.pdb "a title"
			ribbons -n prot


	3)	Look at some sample images:
		Brings up the IRIS Showcase with images and the
		steps required to create them.

			i-ribbons
           Notes:
		"Help" selected from ribbons MainMenu also can call this.
		Can also read the /data/*.notes files for each model.


        The documentation will be sent by U.S.Mail if requested.
	It is also in the doc/ directory in LaTeX format.
        (The compressed *.ps file is also in the ~/doc directory.)
	Please also read ascii *.text files in the doc/ directory
	for extra stuff not yet in the manual.



    5)  Let me know

        E-mail after you get & test it. -mike
	carson@cmc.uab.edu