| 1 |
<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> |
| 2 |
<html> |
| 3 |
<head> |
| 4 |
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
| 5 |
<meta name="GENERATOR" content="Mozilla/4.75 [en] (X11; U; Linux 2.2.14-5.0 i686) [Netscape]"> |
| 6 |
<meta name="Author" content="AJA@MIT"> |
| 7 |
<title>Getting started</title> |
| 8 |
</head> |
| 9 |
<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000"> |
| 10 |
|
| 11 |
<center> |
| 12 |
<h1> |
| 13 |
Compile the code</h1></center> |
| 14 |
We'll walk you through the compilation of "exp4" which simulates zonal |
| 15 |
flow over a Gaussian bump. |
| 16 |
<p>From the top-level source directory, where you installed the code, cd |
| 17 |
to verification/exp4: |
| 18 |
<blockquote> |
| 19 |
<pre>% cd verification/exp4</pre> |
| 20 |
</blockquote> |
| 21 |
There are four sub-directories and a README file. |
| 22 |
<ul> |
| 23 |
<li> |
| 24 |
<i>CVS/ </i>is where version information is stored by CVS. You should never |
| 25 |
need to enter/read/change this.</li> |
| 26 |
|
| 27 |
<br><b><i>Please don't delete this directory/information.</i></b> |
| 28 |
<li> |
| 29 |
<i>code/ </i>contains copies of the source code unique to this experiment |
| 30 |
that over-ride the originals. This is our way of customizing the code.</li> |
| 31 |
|
| 32 |
<li> |
| 33 |
<i>input/</i> contains the input files and parameters for this experiment.</li> |
| 34 |
|
| 35 |
<li> |
| 36 |
<i>results/</i> contains a single text file, <i>output.txt</i>, which we |
| 37 |
use for quickly assessing the state of the code.</li> |
| 38 |
</ul> |
| 39 |
Now cd into <i>input/</i> and run the configuration tool <i>genmake</i>: |
| 40 |
<blockquote> |
| 41 |
<pre>% cd input</pre> |
| 42 |
|
| 43 |
<pre>% ../../../tools/genmake -mods=../code</pre> |
| 44 |
|
| 45 |
<pre>% make depend</pre> |
| 46 |
</blockquote> |
| 47 |
<i>genmake</i> will create a file <i>Makefile </i>and report which packages |
| 48 |
are being included/excluded. <i>make depend</i> figures out the file dependancies |
| 49 |
that allows <i>make</i> to work efficiently. You'll also notice the number |
| 50 |
of files in the current directory has greatly expanded. This are all symbolic |
| 51 |
links to the original source code. |
| 52 |
<p>You only need to do the above steps once; here after, you can edit the |
| 53 |
code and re-compile with <i>make</i>. |
| 54 |
<p>Compile and link the code: |
| 55 |
<blockquote> |
| 56 |
<pre>% make</pre> |
| 57 |
</blockquote> |
| 58 |
This will take some time, depending on your system. [Hint: compiling on |
| 59 |
remotely mounted disks is often really slow] |
| 60 |
<p>If all goes well, you're ready to <a href="runModel.html">run the model</a>... |
| 61 |
<p> |
| 62 |
<hr WIDTH="100%"> |
| 63 |
<table CELLSPACING=0 CELLPADDING=0 WIDTH="100%" NOSAVE > |
| 64 |
<tr NOSAVE> |
| 65 |
<td NOSAVE>Last modified on $Date: 2001/10/12 17:46:59 $</td> |
| 66 |
|
| 67 |
<td> |
| 68 |
<div align=right>CVS: $Source: /u/gcmpack/mitgcm.org/sealion/getting_started/gettingStarted.html,v |
| 69 |
$Revision: 1.2 $</div> |
| 70 |
</td> |
| 71 |
</tr> |
| 72 |
</table> |
| 73 |
|
| 74 |
</body> |
| 75 |
</html> |