Changeset 219


Ignore:
Timestamp:
Jul 13, 2011, 2:56:44 AM (13 years ago)
Author:
aslmd
Message:

MESOSCALE: user manual. added chapter about simulation paramaters.

Location:
trunk/MESOSCALE_DEV/MANUAL/SRC
Files:
5 added
4 edited

Legend:

Unmodified
Added
Removed

  • trunk/MESOSCALE_DEV/MANUAL/SRC/compile_exec.tex

    r218 r219  
    1 \chapter{Compiling the model and running a test case}
     1\chapter{Compiling the model and running a test case}\label{compile}
    22
    33\vk
    … …  
    88
    99\sk
    10 \subsection{Necessary steps to run a simulation}
     10\subsection{Necessary steps to run a simulation}\label{steps}
    1111
    1212\sk

  • trunk/MESOSCALE_DEV/MANUAL/SRC/keep

    r218 r219  
     1
     2%%%
     3
    14\begin{finger}
    25\item The model presently supports 3 nests, but more nests
    … …  
    1215
    1316
     17
     18\mk
     19\marge In case you run simulations with \ttt{max\_dom}
     20nested domains, you have to set \ttt{max\_dom} parameters
     21wherever there is a ``," in the above list.
     22%
     23Here is an example of the resulting syntax of the
     24\ttt{time\_control}, \ttt{domains} and \ttt{bdy\_control}
     25categories in \ttt{namelist.input}:
     26%
     27\codesource{OMG_namelist.input}
     28
     29
     30
     31\item If you run a simulation with, say, $3$ domains,
     32please ensure that you defined three files
     33\ttt{callphys.def}, \ttt{callphys\_d2.def} and \ttt{callphys\_d3.def}.
     34
     35
     36
     37\mk
     38\begin{finger}
     39\item Note that in the given example
     40the convective adjustment,
     41the gravity wave parameterization,
     42and the NLTE schemes are turned off, as is
     43usually the case in typical Martian tropospheric
     44mesoscale simulations.
     45\item \ttt{iradia} sets the frequency
     46(in dynamical timesteps) at which
     47the radiative computations are performed.
     48\item
     49
     50

  • trunk/MESOSCALE_DEV/MANUAL/SRC/user_manual.tex

    r218 r219  
    9090\include{installation}
    9191\include{compile_exec}
     92\include{parameters}
    9293%\include{user_manual_txt}
    9394
    9495\backmatter
     96
     97\appendix
     98\chapter{Martian calendars}\label{calendar}
     99
     100\sk
     101\small
     102\codesource{calendar}
     103\normalsize
     104
    95105\footnotesize{
    96106\bibliographystyle{these}

  • trunk/MESOSCALE_DEV/MANUAL/SRC/user_manual_txt.tex

    r218 r219  
    11
    2 
    3 
    4 \mk
    5 \chapter{Setting the simulation parameters}
    6 
    7 \mk
    8 In this chapter, we describe how to set the various parameters
    9 defining a given simulation.
    10 %
    11 As could be inferred from the content of the \ttt{TESTCASE} directory,
    12 two parameter files are needed to run the model:
    13 \begin{enumerate}
    14 \item The parameters related to the dynamical part of the model can be set
    15 in the file \ttt{namelist.input} according to the ARW-WRF namelist formatting.
    16 \item The parameters related to the physical part of the model can be set
    17 in the file \ttt{callphys.def} according to the LMD-MGCM formatting.
    18 \end{enumerate}
    19 
    20 \mk
    21 \section{Dynamical settings}
    22 
    23 \mk
    24 \ttt{namelist.input} controls the behavior of the dynamical core
    25 in the LMD Martian Mesoscale Model.
    26 %
    27 Compared to the file the ARW-WRF users are familiar with\footnote{
    28 %%%
    29 A description of this file can be found in \ttt{SRC/WRFV2/run/README.namelist}.
    30 %%%
    31 }, the \ttt{namelist.input} in the LMD Martian Mesoscale Model
    32 is much shorter.
    33 %
    34 The only mandatory parameters in this file
    35 are information on time control\footnote{
    36 %%%
    37 More information on the adopted Martian calendar:
    38 \url{http://www-mars.lmd.jussieu.fr/mars/time/solar_longitude.html}
    39 %%%
    40 } and domain definition.
    41 
    42 \mk
    43 \marge The minimal version of the \ttt{namelist.input}
    44 file corresponds to standard simulations with the model.
    45 %
    46 It is however possible to modify optional parameters
    47 if needed, as is the case in the \ttt{namelist.input}
    48 associated to the Arsia Mons test case
    49 (e.g. the parameter \ttt{non\_hydrostatic} is set to false
    50 to assume hydrostatic equilibrium, whereas standard
    51 simulations are non-hydrostatic).
    52 
    53 \mk
    54 \marge A detailed description of the \ttt{namelist.input} file is given below\footnote{
    55 %%%
    56 You may find the corresponding file in \ttt{SIMU/namelist.input\_full}.
    57 %%%
    58 }.
    59 %
    60 Comments on each of the parameters are provided,
    61 with the following labels:
    62 \begin{citemize}
    63 \item \ttt{(*)} denotes parameters not to be modified,
    64 \item \ttt{(r)} indicates parameters which modification implies a new recompilation of the model,
    65 \item \ttt{(n)} describes parameters involved when nested domains are defined,
    66 \item \ttt{(p1)}, \ttt{(p2)}, \ttt{(p3)} mention parameters which modification implies a new processing
    67 of initial and boundary conditions (see next chapter),
    68 \item \ttt{(*d)} denotes dynamical parameters which modification implies
    69 non-standard simulations -- please read \ttt{SRC/WRFV2/run/README.namelist}
    70 and use with caution.
    71 \end{citemize}
    72 %
    73 If omitted, the optional parameters would be set to their default
    74 values indicated below.\pagebreak
    75 
    76 \centers{\ttt{-- file: namelist.input\_full --}}\codesource{namelist.input_full}\centers{\ttt{-- end file: namelist.input\_full --}}
    77 
    78 \begin{finger}
    79 \item Please pay attention to rigorous syntax while
    80 editing your personal \ttt{namelist.input} file
    81 to avoid reading error.
    82 \item To modify the default values (or even add
    83 personal parameters) in the \ttt{namelist.input} file,
    84 edit the \ttt{SRC/WRFV2/Registry/Registry.EM} file.
    85 %
    86 You will then have to recompile the model with \ttt{makemeso} ;
    87 answer \ttt{y} to the last question.
    88 \end{finger}
    89 
    90 \mk
    91 \marge In case you run simulations with \ttt{max\_dom}
    92 nested domains, you have to set \ttt{max\_dom} parameters
    93 wherever there is a ``," in the above list.
    94 %
    95 Here is an example of the resulting syntax of the
    96 \ttt{time\_control}, \ttt{domains} and \ttt{bdy\_control}
    97 categories in \ttt{namelist.input}:
    98 %
    99 \codesource{OMG_namelist.input}
    100 
    101 \section{Physical settings}
    102 
    103 \mk
    104 \ttt{callphys.def} controls the behavior of the physical parameterizations
    105 in the LMD Martian\linebreak Mesoscale Model.
    106 %
    107 The organization of this file is exactly similar
    108 to the corresponding file in the LMD Martian GCM, which
    109 user manual can be found at
    110 \url{http://web.lmd.jussieu.fr/~forget/datagcm/user_manual.pdf}.
    111 
    112 \mk
    113 \marge Please find in what follows the contents of \ttt{callphys.def}:
    114 %
    115 \centers{\ttt{-- file: callphys.def --}}\codesource{callphys.def}\centers{\ttt{-- end file: callphys.def --}}
    116 
    117 \mk
    118 \begin{finger}
    119 \item Note that in the given example
    120 the convective adjustment,
    121 the gravity wave parameterization,
    122 and the NLTE schemes are turned off, as is
    123 usually the case in typical Martian tropospheric
    124 mesoscale simulations.
    125 \item \ttt{iradia} sets the frequency
    126 (in dynamical timesteps) at which
    127 the radiative computations are performed.
    128 \item Modifying \ttt{callphys.def} only implies
    129 to recompile the model if the number of tracers is different.
    130 \item If you run a simulation with, say, $3$ domains,
    131 please ensure that you defined three files
    132 \ttt{callphys.def}, \ttt{callphys\_d2.def} and \ttt{callphys\_d3.def}.
    133 \end{finger}
    1342
    1353\mk
    … …  
    411279
    412280\mk
     281\section{Running your own GCM simulations}
     282
     283\begin{remarque}
     284To be completed
     285\end{remarque}
     286
     287\mk
    413288The programs in the \ttt{PREP\_MARS} directory
    414289convert the data from the NETCDF \ttt{diagfi.nc}
    … …  
    583458
    584459
    585 \chapter{Starting simulations from scratch}
    586 
    587 \mk
    588 \section{Running your own GCM simulations}
     460\chapter{Starting simulations from scratch: a summary}
     461
     462\mk
     463\section{Complete simulations with \ttt{runmeso}}
     464
     465you'll notice you need to change namelist according to model compilation
     466in order to minimize errors and help the user.
    589467
    590468\begin{remarque}
    … …  
    592470\end{remarque}
    593471
    594 \mk
    595 \section{Complete simulations with \ttt{runmeso}}
    596 
    597 \begin{remarque}
    598 To be completed
    599 \end{remarque}
     472
     473\chapter{Advanced use}
     474
     475\section{Grid nesting}\label{nests}
     476
     477\section{Tracers}
     478
     479\section{New physics}
     480
     481
    600482
    601483
Note: See TracChangeset for help on using the changeset viewer.