Home


About us
PALM
PALM-4U
Installation
Release notes
Documentation
Getting Help
Gallery
Developers area

Ignore:
Timestamp:
Mar 13, 2007 2:52:40 AM (18 years ago)
Author:
raasch
Message:

Id string added to all html files

File:
1 edited

Legend:

Unmodified
Added
Removed

  • palm/trunk/DOC/app/chapter_3.5.5.html

    r54 r62  
    11<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
    22<html><head>
    3   <meta http-equiv="CONTENT-TYPE" content="text/html; charset=windows-1252">
    4  
    5   <title>PALM chapter 3.5.5</title><meta name="GENERATOR" content="StarOffice 7  (Win32)">
    6   <meta name="AUTHOR" content="Siegfried Raasch">
    7   <meta name="CREATED" content="20040802;14050943">
    8   <meta name="CHANGED" content="20041117;12180008">
    9   <meta name="KEYWORDS" content="parallel LES model">
    10   <style>
    11         <!--
    12                 @page { size: 21cm 29.7cm }
    13         -->
    14         </style></head>
    15 
    16 <body dir="ltr" lang="en-US">
    17 <h3 style="line-height: 100%;"><font size="4">3.5.5 Compiling and
     3<meta http-equiv="CONTENT-TYPE" content="text/html; charset=windows-1252"><title>PALM
     4chapter 3.5.5</title> <meta name="GENERATOR" content="StarOffice 7 (Win32)"> <meta name="AUTHOR" content="Siegfried Raasch"> <meta name="CREATED" content="20040802;14050943"> <meta name="CHANGED" content="20041117;12180008"> <meta name="KEYWORDS" content="parallel LES model"> <style>
     5<!--
     6@page { size: 21cm 29.7cm }
     7-->
     8</style></head>
     9<body style="direction: ltr;" lang="en-US"><h3 style="line-height: 100%;"><font size="4">3.5.5
     10Compiling and
    1811linking user-defined code<br>
    19 </font></h3>
    20 <p style="line-height: 100%;">Users can add their own (modified) user-interface to a PALM-run by carrying out the following steps:</p><ol><li>Copy the default (empty) user-interface (file<span style="font-family: Courier New,Courier,monospace;"> user_interface.f90</span>) to a directory of your choice, e.g.:<br><br><span style="font-family: Courier New,Courier,monospace;">&nbsp; &nbsp;cd ~/palm/current_version</span><br style="font-family: Courier New,Courier,monospace;"><span style="font-family: Courier New,Courier,monospace;">&nbsp; &nbsp;mkdir -p USER_CODE/example</span><br style="font-family: Courier New,Courier,monospace;"><span style="font-family: Courier New,Courier,monospace;">&nbsp; &nbsp;cp trunk/SOURCE/user_interface.f90&nbsp; USER_CODE/example/user_example.f90</span><br></li><li>Set an additional path in the configuration file<span style="font-family: Courier New,Courier,monospace;"> .mrun.config </span>to allow <span style="font-weight: bold;">mrun </span>to find and include this file:<br><br><span style="font-family: Courier New,Courier,monospace;">&nbsp; &nbsp;%add_source_path&nbsp;&nbsp; $base_directory/USER_CODE/$fname</span><br><br>The default configuration file (<span style="font-family: Courier New,Courier,monospace;">trunk/SCRIPTS/.mrun.config.default</span>) already includes this setting.</li><li>Modify the interface routines according to your needs.</li><li>Start a PALM run by executing<br><br><span style="font-family: Courier New,Courier,monospace;">&nbsp; &nbsp;mrun -d example ...</span><br><br>The file<span style="font-family: Courier New,Courier,monospace;"> user_example.f90 </span>will be automatically compiled within the job and will replace PALM&lsquo;s default user-interface.<br></li></ol>The above method with including<span style="font-family: Courier New,Courier,monospace;"> $fname </span>in
     12</font></h3><p style="line-height: 100%;">Users
     13can add their own (modified) user-interface to a PALM-run by carrying
     14out the following steps:</p><ol><li>Copy the default
     15(empty) user-interface (file<span style="font-family: Courier New,Courier,monospace;">
     16user_interface.f90</span>) to a directory of your choice, e.g.:<br><br><span style="font-family: Courier New,Courier,monospace;">&nbsp;
     17&nbsp;cd ~/palm/current_version</span><br style="font-family: Courier New,Courier,monospace;"><span style="font-family: Courier New,Courier,monospace;">&nbsp;
     18&nbsp;mkdir -p USER_CODE/example</span><br style="font-family: Courier New,Courier,monospace;"><span style="font-family: Courier New,Courier,monospace;">&nbsp;
     19&nbsp;cp trunk/SOURCE/user_interface.f90&nbsp;
     20USER_CODE/example/user_example.f90</span><br></li><li>Set
     21an additional path in the configuration file<span style="font-family: Courier New,Courier,monospace;">
     22.mrun.config </span>to allow <span style="font-weight: bold;">mrun
     23</span>to find and include this file:<br><br><span style="font-family: Courier New,Courier,monospace;">&nbsp;
     24&nbsp;%add_source_path&nbsp;&nbsp;
     25$base_directory/USER_CODE/$fname</span><br><br>The
     26default configuration file (<span style="font-family: Courier New,Courier,monospace;">trunk/SCRIPTS/.mrun.config.default</span>)
     27already includes this setting.</li><li>Modify the interface
     28routines according to your needs.</li><li>Start a PALM run
     29by executing<br><br><span style="font-family: Courier New,Courier,monospace;">&nbsp;
     30&nbsp;mrun -d example ...</span><br><br>The file<span style="font-family: Courier New,Courier,monospace;">
     31user_example.f90 </span>will be automatically compiled within
     32the job and will replace PALM&lsquo;s default user-interface.<br></li></ol>The
     33above method with including<span style="font-family: Courier New,Courier,monospace;"> $fname </span>in
    2134the additional source path allows to use different user-interfaces for
    2235different runs at the same time. Just store the respective
    23 interface-files in subdirectories<span style="font-family: Courier New,Courier,monospace;"> USER_CODE/abcd</span>,<span style="font-family: Courier New,Courier,monospace;"> USER_CODE/cdef</span>, etc. and start <span style="font-weight: bold;">mrun</span> with option &ldquo;<span style="font-family: Courier New,Courier,monospace;">-d abcd</span>&ldquo;, &ldquo;<span style="font-family: Courier New,Courier,monospace;">-d cdef</span>&ldquo;, etc.<br><br><span style="font-weight: bold;">The modified user-interface file cannot be pre-compiled by using mbuild!</span><br><br>While programming user-defined code,
     36interface-files in subdirectories<span style="font-family: Courier New,Courier,monospace;">
     37USER_CODE/abcd</span>,<span style="font-family: Courier New,Courier,monospace;">
     38USER_CODE/cdef</span>, etc. and start <span style="font-weight: bold;">mrun</span> with option
     39&ldquo;<span style="font-family: Courier New,Courier,monospace;">-d
     40abcd</span>&ldquo;, &ldquo;<span style="font-family: Courier New,Courier,monospace;">-d cdef</span>&ldquo;,
     41etc.<br><br><span style="font-weight: bold;">The
     42modified user-interface file cannot be pre-compiled by using mbuild!</span><br><br>While
     43programming user-defined code,
    2444errors are frequently made. Possible ways of error
    2545tracing are described in the next chapter. <br><p style="line-height: 100%;">
    2646&nbsp; </p>
    27 <hr>
    28 <p style="line-height: 100%;"><br>
    29 <font color="#000080"><font color="#000080"><a href="chapter_3.5.3.html"><font color="#000080"><img src="left.gif" name="Grafik1" align="bottom" border="2" height="32" width="32"></font></a><a href="index.html"><font color="#000080"><img src="up.gif" name="Grafik2" align="bottom" border="2" height="32" width="32"></font></a><a href="chapter_3.6.html"><font color="#000080"><img src="right.gif" name="Grafik3" align="bottom" border="2" height="32" width="32"></font></a></font></font></p>
    30 <p style="line-height: 100%;"><i>Last change:&nbsp;</i> 15/04/05 (SR)</p>
     47<hr><p style="line-height: 100%;"><br>
     48<font color="#000080"><font color="#000080"><a href="chapter_3.5.3.html"><font color="#000080"><img src="left.gif" name="Grafik1" align="bottom" border="2" height="32" width="32"></font></a><a href="index.html"><font color="#000080"><img src="up.gif" name="Grafik2" align="bottom" border="2" height="32" width="32"></font></a><a href="chapter_3.6.html"><font color="#000080"><img src="right.gif" name="Grafik3" align="bottom" border="2" height="32" width="32"></font></a></font></font></p><p style="line-height: 100%;"><i>Last change:&nbsp;</i>
     49$Id$</p>
    3150</body></html>
Note: See TracChangeset for help on using the changeset viewer.
                                                                                                                                                                                                                                                                                                                                                                               
  | Impressum | ©Leibniz Universität Hannover |