📄 installation.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd"><html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>Installing QMG</title></head><body BGCOLOR="#E0FFE0" TEXT="#000000" LINK = "#0080C0" VLINK = "#004060" ALINK = "#FF0000" ><center><table><tr><td><a href="qmg2_0_home.html"><img src=logo1.jpg alt="QMG logo"></a></td><td><h1>Installing QMG</h1></td></table></center><p>QMG2.0 runs on a variety of Unix platforms, and also under Windows NTrunning on an Intel-compatible PC.<p>There are a number of options for installing QMG. Unix users should download the source files and then compile themwith a C++ compiler, for example, <a href="http://egcs.cygnus.com">egcs1.1.2 or gcc-2.95</a>.Windows users can also download the source files and compile themusing, for example, Microsoft Visual C++ 5.0.Windows users lacking the proper compiler can also download executables.There are two kinds of executables: the Tcl/Tk executables orthe Matlab executables. These instructions will go over all the options.<h2><a name="download"></a>Downloading the software</h2><ul><li><a href = "ftp://ftp.cs.cornell.edu/pub/vavasis/qmg2_0/qmg2_0.tar.gz">Download QMG 2.0 source code qmg2_0.tar.gz in tar gzip'd format. (0.9 MB.)</a>Untar the tar file in a new, empty directory.<li><a href = "ftp://ftp.cs.cornell.edu/pub/vavasis/qmg2_0/qmg20.zip">Download QMG 2.0 source code qmg20.zip in zip format. (1.1 MB.)</a>Unzip the zip file in a new, empty directory.<li><a href = "ftp://ftp.cs.cornell.edu/pub/vavasis/qmg2_0/qmg20mb.zip">Download QMG2.0-for-Matlab executables qmg20mb.zip for Windows NT/i386 only(2.4 MB.)</a> Unzip the file qmg20mb.zip in a new, empty directory.<li><a href = "ftp://ftp.cs.cornell.edu/pub/vavasis/qmg2_0/qmg20tb.zip">Download QMG2.0-for-Tcl/Tk executables qmg20tb.zip for Windows NT/i386 only (1.0 MB.)</a>Unzip the file qmg20tb.zip in a new, empty directory.<li><a href = "ftp://ftp.scriptics.com/pub/tcl/">Tcl-Tk download site.</a>Also available at this site is a self-extracting archive for the <a href = "ftp://ftp.scriptics.com/pub/tcl/misc/unz512xN.exe">unzipprogram</a> for Windows.</ul><h2>Installing Tcl/Tk</h2>Users who would like the Tcl/Tk front-end must first install Tcl/Tk.<p>QMG 2.0 is written assuming that you will use Tcl/Tk 8.1.1. QMG shouldbe compatible with Tcl/Tk 8.0 and with versions numbered higher than 8.1,but is not compatible withTcl 7.x.Tcl/Tk is a free software package originally written by J. Ousterhout and now maintained by the staff of Scriptics. It includes a scripting environment,a GUI-building toolkit, remote procedure calls, and otheruseful features. It runs on a variety of Unix platforms aswell as Macs and Windows.Unix users should download the Tcl/Tk source code andcompile it. Windows users can download the Tcl/Tk source code and compile it with Microsoft or Borland C compilers,or else they can download aself-extracting executable that installs the binaries. Many sites already have Tcl/Tk installed somewhere; check withyour system administrator before you go to the trouble of installing it.<p>Tcl/Tk also uses <code>tkcon.tcl</code>, a Tcl script file for aconsole interface written by Jeffrey Hobbs. Tkcon is shippedwith QMG, so you do not have to download it separately. In the Tcl/Tk environment, some QMG 2.0 routines are C++ extensions to theTcl/Tk core and are statically loaded routines. Others are coded in Tcl. Tcl dynamic loading is used to load Tk.Tcl namespace and packages are not used.<h2>Installing Matlab</h2>Matlab is commercial product that includes many routines for numerical computation, graphics and a scripting environment.For information contact <a href="http://www.mathworks.com/">The Mathworks, Inc.</a>There are free software packages that imitate Matlab,but none of them has been tested with QMG.<p>You do not need to install Matlab if you plan to script QMGwith the Tcl/Tk language. The Tcl/Tk scripting environment does not include thefinite element solver that comes QMG—this portion of QMG isavailable only to Matlab users.<h2>Role of the scripting language</h2>The QMG package uses the scripting languageas a front end for all the geometricmodeling routines and the mesh generator itself. Several routines are written entirely in the scripting language.For example, the<a href="fe.html">finite element solver</a>(<a href="ref.html#gmfem"><code>gmfem</code></a>and related routines) is written in Matlab.<p>You need to be familiar with the scripting environment (either Matlabor Tcl/Tk) in order to use QMG.Matlab comes with online demos and tutorials to get started, andthere are a number of textbooks on Matlab—see the home page of<a href="http://www.mathworks.com/">The Mathworks, Inc.</a>for more information.There are several books on Tcl/Tk, for instanceJ. Ousterhout, <em>Tcl and the Tk Toolkit</em>, Addison Wesley, 1994.This documentation includes <a href="tclsyntax.html">a very brief synopsis of Tcl/Tk</a> that will get you started.<p>The mesh generator and a few other routinesare available as <a href="standalone.html">stand-alone shellcommands</a>. These standalone commands run the Tcl/Tk version of QMG by feeding it short scripts. Therefore, to install QMG in standalone mode, follow the instructions for a Tcl installation.<h2>Installing the QMG source code (Unix and Windows/Intel) </h2>The following information is about building QMG from the sourcecode.If you have downloaded the Windows executable files rather thanthe source code, please skip ahead to the information below about<a href="#env">setting up your environment.</a>The QMG source code is available by anonymous ftp at the downloadsection <a href="#download">above</a>.After unzipping/untarring, there will be filesand directories with the following names and purposes. In the following instructions, $QMG_ROOT stands for the directory in which you unzipped/untarredQMG.(These directories are set up so that you can build theQMG software for several different platforms sharing a commonnetworked file system.)<ul><li>directory <code>$QMG_ROOT/build</code>: This directory has a four subdirectories each of which hasa makefile. The four are: unixmatlab, unixtcl, windowsmatlab,and windowstcl. These correspond to the four supportedplatforms (Unix/Matlab, etc.).<li>file <code>$QMG_ROOT/copyright</code>: the copyright statement and licensing terms for QMG.<li>directory <code>$QMG_ROOT/data</code>:This directory contains some interesting data, for instance, the fivePlatonic solids.<li>directory <code>$QMG_ROOT/doc</code>: This directory containsthese html files that you are reading.<li>directory <code>$QMG_ROOT/ex</code>: You can start Matlabin this directory if you are making a Matlab installation.<li>directory <code>$QMG_ROOT/mex</code>: This directoryholds the compiled mex files for matlab. It is initially empty.<li>directory <code>$QMG_ROOT/mfiles</code>:This directory contains the matlab m-files that go with QMG.These are used only if you script QMG with Matlab.<li>directory <code>$QMG_ROOT/mfiles2</code>:This directory contains the m-files that contain tests QMG, as well as some utilities to assist in testing.<li>directory <code>$QMG_ROOT/src</code>:This directory has a number of subdirectories: common, model, meshgen,matlab, tcl, unix, win. These subdirectories contain theC++ source code. Each subdirectory also contains some portionsof makefiles. See the <a href="source.html">guide to the source code.</a><li>directory <code>$QMG_ROOT/tcl</code>:This directory contains the Tcl files that go with QMG.These are used only if you script QMG with Tcl/Tk.<li>directory <code>$QMG_ROOT/tcl2</code>:This directory contains Tcl files that test QMG, as well as some utilities to assist in testing.</ul><h2>Executing the makefiles</h2>The QMG package source code comes with a number of Makefiles for buildingQMG on different platforms.As mentioned above, the subdirectories are called<code>unixmatlab</code>, <code>unixtcl</code>, <code>windowsmatlab</code>and <code>windowstcl</code>. Proceed to the subdirectorycorresponding to the platform you use.In this directory you will find a makefile(named <code>Makefile</code> in Unix and <code>makefile</code> in Windows) and a second file called<code>custom</code>. This latter file needs to be customized.Use an editor to modify it according to the comments in the file.<p>QMG 2.0 has been successfully compiled with the followingUnix compilers: egcs (version 1.1.2 or higher), KCC (version 3.2f orhigher), Mips-Pro (version 7.3 or higher). It cannot be compiledwith older compilers that do not support namespaces, STL or templates. It also cannot be compiled by Sun C++ 5.0.<p>When customization is done, build the binaries using thecommand <code>make</code>in Unix or <code>nmake</code> in Windows.<p>The makefiles for building QMG under Matlab will put the executablefiles in directory $QMG_ROOT/mex. The makefiles for building QMGunder Tcl/Tk will leave the executable (a single file called <strong>qmg</strong> in Unixor <strong>qmg.exe</strong> in Windows) in the subdirectory of build where make wasexecuted.<h3>XDR in Tcl/QMG </h3>QMG uses XDR (Sun RPC) in Tcl only. The necessary XDR routines areshipped with QMG. But you may prefer to use your own built-inXDR routines, which may be more efficient. Instructions in thefile named <code>custom</code> explain this option.<h3>Lapack and BLAS in QMG</h3>QMG uses Lapack/BLAS in both Tcl and Matlab versions. The necessaryLapack (actually, Clapack, the C version of Lapack) and BLAS routines⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -