Readme.txt                              2/23/96
==========
 Files in this directory:
   mmap_SPARCstation103.tar.Z    Mental Maps v1.0.3 distribution file.
   readme.txt      (this file) Description, installation instructions, and
                   hardware/software requirements of Mental Maps.

   * Be sure you switch to 'binary' mode before transferring this file to
  your system.  Simply type 'binary' at the ftp prompt.

 Mental Maps (MMap)
 ==================
  Mental Maps is a program that allows students to test their
knowledge about the location of cities.  Mental Maps may also
be configured to ask questions about the cities such as their
population, average summer and winter temperature, cost of
living and desirability as a home for the user.  This program
can serve as a way of collecting information about students'
perceptions about cities for further in-class discussion.

  Installation 
  =========
  This program is distributed as a 'tarred' and 'compress'ed archive 
  file.

     1) Locate the distribution files.
     2) Uncompress the file mmap_SPARCstation103.tar.Z:
                 type:     uncompress mmap_SPARCstation103.tar   <return>
     3) Untar the file mmap_SPARCstation103.tar
                 type:     tar -xvf mmap_SPARCstation103.tar
   
   The programs files will be extracted under the subdirectory named
    mmap that will be created under your current working directory.
 
  Running the Program
  =====================
      1) Change to the  directory to which it was installed
      2) Type:
	  mmap &

Requirements to Run Mental Maps 
======================================
    Hardware Requirements
    ---------------------
    - SPARCstation
    - Mouse
    - 1 MB Hard drive space.
      (Does not include the temporary space needed for the distribution file.)

    Software Requirements
    ---------------------
    - Solaris version 2.4
    - X Windows

 Documentation
 =============

   User's Manual
   ============
     Once Mental Maps is installed, the Mental Maps User's Manual is in the
     directory \<installdir>\info (eg. \mmap\info).  It is in three formats:

     Format                   File Name
     --------------           -----------
     LaTeX                    MMAP.TEX
     Post Script              MMAP.PS
     ASCII text               MMAP.DOC

   Technical Manual
   ================
     A technical manual describing how to change the configuration of
     Mental Maps is also provided.  This document is found in the same
     directory as the User's Manual.  It is in three formats:

     Format                   File Name
     --------------           -----------
     LaTeX                    MMAPTM.TEX
     Post Script              MMAPTM.PS
     ASCII text               MMAPTM.DOC

  The LaTeX format is included so that you may use LaTeX to compile,
  view, and print the manual.  Since you need LaTeX to do that, we have
  included the two other formats.  The Post Script format requires a
  PostScript printer or GhostScript.  The plain ASCII text format may be
  printed on any standard printer.

Where to get help
=================
If you need help or for more information on Project GeoSim, contact:
        Dr. Cliff Shaffer
        Department of Computer Science
        Virginia Tech
        Blacksburg, VA 24061
        (703) 231-4354
        geosim@cs.vt.edu


How to acquire GeoSim software
==============================
  GeoSim software, documentation, and sample classroom exercises are
  available free via anonymous FTP or Gopher from:

     geosim.cs.vt.edu

  Or via World Wide Web (Mosiac) with the following URL:

     http://geosim.cs.vt.edu

  You can contact us by email at:
     geosim@cs.vt.edu

  If you would like to be on our email list and receive news about
  updates and new programs, just send us an email message at the
  above address.

  If you do not have Internet access, write us to receive a price
  list for software on floppy diskette at:
      Project GeoSim
      Department of Computer Science
      Virginia Tech
      Blacksburg, VA 24061