source: palm/trunk/DOC/app/chapter_3.5.2.html @ 1453

Last change on this file since 1453 was 212, checked in by raasch, 16 years ago

manual updated for changes in the user interface

  • Property svn:keywords set to Id
File size: 4.5 KB
RevLine 
[5]1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2<html><head>
[212]3<meta http-equiv="CONTENT-TYPE" content="text/html; charset=windows-1252"><title>PALM chapter 3.5.2</title> <meta name="GENERATOR" content="StarOffice 7 (Win32)"> <meta name="AUTHOR" content="Siegfried Raasch"> <meta name="CREATED" content="20040802;13321506"> <meta name="CHANGED" content="20041112;14455666"> <meta name="KEYWORDS" content="parallel LES model"> <style>
[62]4<!--
5@page { size: 21cm 29.7cm }
6-->
7</style></head>
8<body style="direction: ltr;" lang="en-US"><h3 style="line-height: 100%;">&nbsp;3.5.2 Definition of
9user-defined
[5]10parameters</h3>
[62]11<p style="line-height: 100%;">As for the model in general,
12also the
[5]13user-defined code will have to be steered by parameters. For each
14run the model should to be able to read in current values of these
15parameters. The declaration of user-defined parameters takes place in
16the user-defined module <tt><font style="font-size: 10pt;" size="2">user</font></tt>
[212]17(file <tt><font style="font-size: 10pt;" size="2">user_module.f90</font></tt>).
[5]18This module must be declared in all relevant user-defined routines via
19a USE statement, in order to make the parameters available. </p>
[62]20<p style="line-height: 100%;">The user can assign values
21to the
[5]22user-defined parameters within the NAMELIST group <tt><font style="font-size: 11pt;" size="2">&amp;userpar
[62]23<font size="3"><font face="Thorndale, serif">in
24the local file</font></font>
[5]25<a href="chapter_3.4.html#PARIN">PARIN</a></font></tt>.
26This NAMELIST group must be located after the initialization
27parameters and run parameters (<tt><font style="font-size: 10pt;" size="2">&amp;inipar</font></tt><font style="font-size: 10pt;" size="2">,
28</font><tt><font style="font-size: 10pt;" size="2">&amp;d3par</font></tt>)
29(see <a href="chapter_4.0.html">chapter
[62]304.0</a>). Before values of the user-defined parameters can be
31assigned,
[5]32the parameters must be declared within the appropriate NAMELIST
33statement in the user-defined subroutine <tt><font style="font-size: 10pt;" size="2">user_parin</font></tt>.
34</p>
[62]35<p style="line-height: 100%;">The following example
36illustrates the
[5]37procedure. The example assumes that the user declares a
38LOGICAL variable named <tt><font style="font-size: 10pt;" size="2">abcd</font></tt>
39for steering the user-defined code. This variable
40must be declared in the module <tt>user</tt>: </p>
[62]41<ul> <p style="line-height: 100%;"><tt><font style="font-size: 10pt;" size="2">LOGICAL:: abcd =
42.FALSE.</font></tt></p>
43</ul><p style="line-height: 100%;">Pay attention
44that in this example a
[5]45default value (.FALSE.) is assigned to the variable and it will keep
46this value if nothing else is assigned within the file <tt>PARIN</tt>.
[62]47In <tt><font style="font-size: 10pt;" size="2">user_parin</font>
48<font face="Thorndale, serif">the</font></tt>
[5]49NAMELIST must be extended by the name of the new variable: </p>
[62]50<ul> <p style="line-height: 100%;"><tt><font style="font-size: 10pt;" size="2">NAMELIST /userpar/
51&nbsp;abcd, data_output_user, region.</font></tt></p>
52</ul><p style="line-height: 100%;">In the parameter
53file PARIN a value can
[5]54be assigned: </p>
[62]55<ul> <p style="line-height: 100%;">. <br>
56. <br> <tt><font style="font-size: 10pt;" size="2">&amp;userpar abcd = .T.,</font></tt><font style="font-size: 10pt;" size="2"> ...</font></p>
57</ul><p style="line-height: 100%;">User defined
58parameters in the file PARIN
[5]59are
60considered as run parameters, i.e. they must be specified again for
61each restart run.</p>
[62]62<p style="line-height: 100%;">In each case the user should
63carry out
[5]64a control output of the parameter values, so
65that their values during the respective model run are really known. For
66this
67purpose the user-defined subroutine <tt><font style="font-size: 10pt;" size="2">user_header</font></tt>
68which writes into the files <a href="chapter_3.4.html#HEADER">HEADER</a>
69and <a href="chapter_3.4.html#RUN_CONTROL">RUN_CONTROL</a>
70is available. <br>
71&nbsp; </p>
[62]72<hr><p style="line-height: 100%;"><br>
[5]73&nbsp;<font color="#000080"><font color="#000080"><a href="chapter_3.5.1.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.5.3.html"><font color="#000080"><img src="right.gif" name="Grafik3" align="bottom" border="2" height="32" width="32"></font></a><br>
[62]74</font></font></p><p style="line-height: 100%;"><span style="font-style: italic;">Last
75change:</span> $Id: chapter_3.5.2.html 212 2008-11-11 09:09:24Z heinze $<font color="#000080"><font color="#000080"><br>
76</font></font></p></body></html>
Note: See TracBrowser for help on using the repository browser.