| 1 | adcroft | 1.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 | adcroft | 1.2 | We'll walk you through the compilation of "exp4" which simulates zonal | 
| 15 | adcroft | 1.1 | 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 | adcroft | 1.3 | There are four sub-directories and a README file. | 
| 22 | adcroft | 1.1 | <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 | adcroft | 1.3 | <td NOSAVE>Last modified on $Date: 2001/10/12 17:46:59 $</td> | 
| 66 | adcroft | 1.1 |  | 
| 67 |  |  | <td> | 
| 68 |  |  | <div align=right>CVS: $Source: /u/gcmpack/mitgcm.org/sealion/getting_started/gettingStarted.html,v | 
| 69 | adcroft | 1.3 | $Revision: 1.2 $</div> | 
| 70 | adcroft | 1.1 | </td> | 
| 71 |  |  | </tr> | 
| 72 |  |  | </table> | 
| 73 |  |  |  | 
| 74 |  |  | </body> | 
| 75 |  |  | </html> |