Ignore:
Timestamp:
Nov 11, 2008 9:09:24 AM (13 years ago)
Author:
raasch
Message:

manual updated for changes in the user interface

File:
1 edited

Legend:

Unmodified
Added
Removed
  • palm/trunk/DOC/app/chapter_3.5.5.html

    r62 r212  
    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"><title>PALM
    4 chapter 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>
     3<meta http-equiv="CONTENT-TYPE" content="text/html; charset=windows-1252"><title>PALM chapter 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>
    54<!--
    65@page { size: 21cm 29.7cm }
     
    1211</font></h3><p style="line-height: 100%;">Users
    1312can add their own (modified) user-interface to a PALM-run by carrying
    14 out the following steps:</p><ol><li>Copy the default
    15 (empty) user-interface (file<span style="font-family: Courier New,Courier,monospace;">
    16 user_interface.f90</span>) to a directory of your choice, e.g.:<br><br><span style="font-family: Courier New,Courier,monospace;">&nbsp;
     13out the following steps:</p><ol><li>Copy the appropriate default
     14(empty) user-interface&nbsp;files<span style="font-family: Courier New,Courier,monospace;">
     15user_***.f90</span> to a directory of your choice, e.g.:<br><br><span style="font-family: Courier New,Courier,monospace;">&nbsp;
    1716&nbsp;cd ~/palm/current_version</span><br style="font-family: Courier New,Courier,monospace;"><span style="font-family: Courier New,Courier,monospace;">&nbsp;
    1817&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;
    20 USER_CODE/example/user_example.f90</span><br></li><li>Set
     18&nbsp;cp trunk/SOURCE/user_***.f90&nbsp;
     19USER_CODE/example<br><br><span style="font-family: Times New Roman,Times,serif; font-weight: bold;">Attention: do not change the filenames!</span><br></span><br></li><li>Set
    2120an additional path in the configuration file<span style="font-family: Courier New,Courier,monospace;">
    2221.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;
     22</span>to find and include these files:<br><br><span style="font-family: Courier New,Courier,monospace;">&nbsp;
    2423&nbsp;%add_source_path&nbsp;&nbsp;
    2524$base_directory/USER_CODE/$fname</span><br><br>The
    2625default configuration file (<span style="font-family: Courier New,Courier,monospace;">trunk/SCRIPTS/.mrun.config.default</span>)
    27 already includes this setting.</li><li>Modify the interface
    28 routines according to your needs.</li><li>Start a PALM run
     26already includes this setting.<br></li><li>Modify the interface
     27routines according to your needs.<br></li><li>Start a PALM run
    2928by 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;">
    31 user_example.f90 </span>will be automatically compiled within
    32 the job and will replace PALM&lsquo;s default user-interface.<br></li></ol>The
     29&nbsp;mrun -d example ...</span><br><br>The files<span style="font-family: Courier New,Courier,monospace;">
     30user_***.f90 </span>will be automatically compiled within
     31the job and will replace the respective PALM&lsquo;s default user-interface routines.<br></li></ol>The
    3332above method with including<span style="font-family: Courier New,Courier,monospace;"> $fname </span>in
    3433the additional source path allows to use different user-interfaces for
     
    3938&ldquo;<span style="font-family: Courier New,Courier,monospace;">-d
    4039abcd</span>&ldquo;, &ldquo;<span style="font-family: Courier New,Courier,monospace;">-d cdef</span>&ldquo;,
    41 etc.<br><br><span style="font-weight: bold;">The
    42 modified user-interface file cannot be pre-compiled by using mbuild!</span><br><br>While
     40etc.<br><br>If the user wants to add additional routines, he/she can a) put them into the default user-interface file <span style="font-family: Courier New,Courier,monospace;">user_additional_routines.f90</span>
     41or b) can create new files in the additional source directory. These
     42files must have names different from the default PALM source code
     43files. In case of b), the user must also copy the default makefile into
     44the additional source directory:<br><br><span style="font-family: Courier New,Courier,monospace;">&nbsp; &nbsp;cp trunk/SOURCE/Makefile&nbsp;
     45USER_CODE/example</span><br><br>The makefile must be modified appropriately followinf the "make"-rules in order to allow the new files to be compiled.<br><br><span style="font-weight: bold;">The
     46modified user-interface files cannot be pre-compiled by using mbuild!</span><br><br>While
    4347programming user-defined code,
    4448errors are frequently made. Possible ways of error
Note: See TracChangeset for help on using the changeset viewer.