University of California at Berkeley
           Department of Electrical Engineering & Computer Sciences
                     Instructional & Electronics Support Group

/share/b/pub/tlearn-old.help


*****************************************************************************
  THIS DOCUMENT IS OUT OF DATE AND IS HERE FOR HISTORICAL REFERENCE ONLY
  Tlearn is no longer installed on the EECS Instructional computers.
*****************************************************************************

                                                                   Sep 12 2006

CONTENTS:

	Tlearn on the Instructional UNIX systems
	Using the tlearn software (UNIX)
	Tlearn installation files (UNIX)
	Tlearn on the Instructional NT systems
	Reporting bugs
	For more information


Tlearn on the Instructional UNIX systems
----------------------------------------
  'tlearn' is available on the Instructional UNIX systems on the Solaris SPARC 
  computers such as pulsar.cs and the SunRay labs on the second floor of Soda
  Hall.  Please see http://inst.eecs.berkeley.edu/cgi-bin/clients for a 
  complete list of login servers and labs.

  It is located in /share/instsww/tlearn.   The programs can be started using 
  these UNIX commands:

    /share/instsww/bin/tlearn		(command line interface)
    /share/instsww/bin/xtlearn		(X Window version)
    /share/instsww/bin/tlearn_dsp	(CONNEX display-language version)


  'tlearn' is a neural network simulation package to accompany the work 
 
  Elman, J. L. and Plunkett, Kim.  Exercises in Rethinking Innateness:
  A Handbook for Connectionist Simulations. Cambridge: MIT Press, 1997.
 
  This software is free (released under the GNU General Public License),
  and supported by the Instructional group for Prof. Wilensky and CS188.
 
  Currently we have only compiled it on Solaris SPARC; the code is old 
  and required a little hand-hacking to get going, but should be portable 
  with a little work if the program is required on other architectures.
 
  Xtlearn, a self-contained X Window System interface which provides for
  the generation of error curves, is also available.


Using the tlearn software (UNIX)
-------------------------------
  You can run the program using the commands

    setenv PATH "${PATH}:/share/n/tlearn/bin:/share/instsww/bin"
    tlearn

  "tlearn_dsp", is identical to "tlearn" but also provides for an interface 
  to CONNEX, a language which can display the parameters and results of a 
  connectionist simulation graphically.
  
  tlearn_dsp is not really an X Window interface per se, though; if you want 
  to use the X Window interface "xtlearn", use the command "xtlearn".  You 
  have to start xtlearn in the same directory as your .cf, .data, and .teach 
  files, and that directory must be writable by you.
 
  Except for the CONNEX input file, tlearn and tlearn_dsp take the same input 
  files, specified with the -f <fileroot> option.  To supply the CONNEX input 
  file, if you are working with a fileroot "xor" (e.g., files named xor.cf, 
  xor.data, xor.teach), name the CONNEX input file "xor.dsp".  "tlearn_dsp"
  will look for the .dsp extension and bring up a CONNEX window with the 
  results; you can save the picture with tools such as "xwd", and kill the 
  window when you're done looking at it.
 
  You can read the manual page by adding the "man" directory to your MANPATH 
  and running "man tlearn":
 
   % setenv MANPATH "${MANPATH}:/share/instsww/pkg/tlearn/man"
   % man tlearn
 
  or, equivalently:
 
   % env MANPATH=/share/instsww/pkg/tlearn/man man tlearn
 
  To read the xtlearn manual page use "man xtlearn".
 
  You can put the "setenv" command at the end of your ~/.cshrc file if you
  plan to read the manual page a lot; once you do that, and log in again, you
  need only type "man tlearn" to read the page.
 
  You can read the documentation for the CONNEX graphics input files
  using the command
 
   % more /share/instsww/pkg/tlearn/src/MozerLib/doc/connex.doc 


Tlearn installation files (UNIX)
-------------------------------
 The following files have been installed for 'tlearn':

   tlearn/bin/tlearn             <-- multi-architecture wrapper
   tlearn/bin/tlearn_dsp         <--   "       "          "
   tlearn/bin/xtlearn            <--   "       "          "
   tlearn/bin/HP-UX/tlearn       <-- tlearn program itself (HP)
   tlearn/bin/HP-UX/tlearn_dsp   <-- CONNEX display version (HP)
   tlearn/bin/HP-UX/xtlearn      <-- X-Window interface program (HP)
   tlearn/man/man1/tlearn.1      <-- man page for tlearn
   tlearn/man/man1/xtlearn.1     <-- man page for xtlearn
   tlearn/Exp/exp.c
   tlearn/Exp/exp.o
   tlearn/Exp/Makefile
   tlearn/Exp/exp_table.hp       <-- exponent lookup table
   tlearn/src                    <-- directory with source, test input files


Tlearn on the Instructional NT systems
--------------------------------------
  'tlearn' is available on the Instructional NT systems:

   Run: \\fileservice\cs188\tlearn\Tlearn.exe	     (32-bit MS Windows program)
   Run: \\fileservice\cs188\tlearn\TlearnManual.pdf  (docs in 'acroread' format)

   Also see \\fileservice\Software\Tlearn Folder.


Reporting bugs
--------------
  Please report bugs in the Instructional installation to IESG staff at
  <inst@EECS.Berkeley.EDU>. We will coordinate with the maintainers
  at UCSD, reachable at <innate@crl.ucsd.edu>, to get bugs fixed.


For more information
--------------------
  For more information, visit the following URLs in your favorite web browser:

  http://crl.ucsd.edu/innate/tlearn.html
  ftp://ftp.crl.ucsd.edu/public/neuralnets/tlearn
  ftp://ftp.crl.ucsd.edu/public/neuralnets/tlearn/README


						EECS Instructional Support
						384/386/378 Cory, 333 Soda
						inst@eecs.berkeley.edu