readme_src

算断裂的

You have downloaded QMG2.0.1 source code.  QMG2.0 is written by
S. Vavasis (and others mentioned in src files) and is copyrighted (c)
1999 by Cornell University.  See the accompanying file 'copyright' for
your license to use QMG2.0.

To continue installation, you must be running Windows or Unix, and you
must have a C++ compiler.  You must also have a front-end scripting language,
either Matlab or Tcl/Tk.

For Tcl/Tk only: download Tcl/Tk from the archive, which is currently
(7/99) located at: ftp://ftp.scriptics.com.

For Matlab only: purchase Matlab from the Mathworks Incorporated.  The
webpage is http://www.mathworks.com.

Run make on the source.  "make" should be run from a subdirectory
of ./build.  There are pre-written makefiles for 
   Unix / Matlab
   Unix / Tcl
   Windows / Matlab
   Windows / Tcl

In each subdirectory, there is a file called custom that you must
customize according to the instructions in that file.  On all unix
systems, run make by typing "make".  For windows using Visual C++,
type "nmake".

If the make program runs successfully, then
  - if you are building for Tcl/Tk, you will end up with an executable
named "qmg" ("qmg.exe" under Windows) in the relevant subdirectory of ./build.
  - if you are building for Matlab, you will end up with a bunch of mex
files in directory ./mex.

At this point, the directions diverge:


------------- FOR TCL/TK: -------------------

To finish installation, you must:

  (1) For Windows: make sure your PATH environment variable includes
the directory containing tclXX.dll where XX is the version number.  Note: 
Use backslashes for these paths.  

  (2) Set environment variables TCL_LIBRARY and TK_LIBRARY to the directories
containing init.tcl and tk.tcl respectively.  Windows & Unix: Use forward 
slashes for these paths.  Note: if plan to use QMG in batch-only mode (no
windows), TK_LIBRARY does not have to be set.

  (3) Set environment variable QMG_ROOT to the directory that contains this
readme_src file.  Windows & Unix: Use forward slashes for this path.

  (4) Set the environment variable TK_DLL_PATH to the path where tkXX.dll
(Windows) or libtkX.X.so (Unix) is located.  This is the dynamic library
holding Tk.  You do not need to set this variable if you plan to use
QMG in batch-only mode (no windows).  Windows & Unix: Use forward slashes 
for this path.
 
  (5) Unix only: make sure your DISPLAY environment variable is set.
This is not necessary if you plan to use QMG in batch-only mode.
 
  (6) Now you are ready to go.  The executable is either ./build/unixtcl/qmg
or .\build\windowstcl\qmg.exe. Run it to start QMG.  You can add this directory
to your PATH, or else (Windows only) create a shortcut in your program
manager.  You should probably run through all 11 tests as mentioned in
the on-line documentation by typing
     source $qmg_library2/alltests.tcl
into the QMG shell.


------------- FOR MATLAB: -------------------

To finish installation, you must:

  (1) Install Matlab 5.x.  This is a commercial product available from
The Mathworks, Inc.

  (2) Go to directory ./ex (subdirectory of this directory).

  (3) Now run Matlab.  A greeting should appear telling you that the QMG
2.0 startup file ran successfully.  You should probably run through 
all 11 tests as mentioned in the on-line documentation by typing
     alltests
into the Matlab shell.

  (4) If you want to run QMG from a different directory, please move the
startup.m file to that directory.  If you already have a startup file,
please merge QMG's with your own.  

  (5) Once you have moved the startup file, it  may no longer be
able to find the executables.  The environment variable QMG_ROOT
should be set to the path with subdirectories named 'mex',
'mfiles' and 'mfiles2' (which is this current directory immediately
after unpacking) before starting matlab.