source: trunk/MESOSCALE_DEV/MANUAL/SRC/guide.tex @ 245

\chapter{A quick guide to running a complete mesoscale simulation}\label{complete}

\vk
In this chapter, we assume that the user has followed all the installation/compilation steps in the previous chapters. Probably it was a bit of an effort to do so; now the reward is that complete mesoscale simulations, i.e. all steps referred to in section~\ref{steps}, can be run. This chapter is thus meant to be a permanent reference for users once all tasks described in the previous chapters have been successfully achieved.

\mk
\section{A summary of the complete set of commands to run a mesoscale simulation}

\sk
It is assumed here that the user is working in a directory named \ttt{/a\_place/MY\_SIMU} mounted on a disk with enough free space to host the \ttt{wrfout} output files. 

\sk
\paragraph{Prerequisites} Prepare parameter files (copy templates or pre-existing files); Edit those files; Use \ttt{\$MMM/SIMU/calendar} (or see appendix) to choose simulation dates and fill the namelists; Pay attention to correspondances between \ttt{namelist.input} and \ttt{namelist.wps}; See~\ref{zeparam} and~\ref{wps} for further details.
\begin{verbatim}
cd /a_place/MY_SIMU
cp $MMM/SIMU/namelist.input_minim namelist.input  
cp $MMM/SIMU/callphys.def .
cp $MMM/SRC/WPS/wps_mars/namelist.wps_TEST namelist.wps
[edit those three files and set your parameters]
\end{verbatim}

\sk
\paragraph{Step 0} Compile the model. See~\ref{sc:makemeso} for further details.
\begin{verbatim}
cd $MMM
makemeso
[answers to the questions must be compliant with information in namelist.input]
[check in your_compdir that executables real.exe and wrf.exe are here]
cd /a_place/MY_SIMU
ln -sf $MMM/your_compdir/wrf_suffix_reflecting_your_choices.exe wrf.exe
ln -sf $MMM/your_compdir/real_suffix_reflecting_your_choices.exe real.exe
\end{verbatim}

\sk
\paragraph{Step 1} Run the LMD Global Circulation Model (GCM) to provide initial and boundary conditions for the mesoscale model. See~\ref{gcmini} for further details.
\begin{verbatim}
cd $MESO/LMDZ.MARS/myGCM
launch_gcm
[answer: sol number corresponding to chosen dates (use $MMM/SIMU/calendar)]
[wait for GCM simulation to end]
cd $MMM/your_compdir/PREP_MARS
[check that the link input_diagfi.nc points toward the GCM output diagfi.nc]
compile_and_exec
[check that WPSFEED contains data files which prefix is LMD:]
\end{verbatim}

\sk
\paragraph{Step 2} Create the mesoscale limited-area domain of simulation. Run preprocessing programs to horizontally interpolate GCM meteorological fields and static data (topography, soil properties) to the chosen simulation domain. See~\ref{wps} for further details.
\begin{verbatim}
cd $MMM/your_compdir/WPS
geogrid.exe
[check that geo_em* netCDF files are created in the current directory]
mkdir WRFFEED/current
metgrid.exe
[check that met_em* netCDF files are created in the WRFFEED/current directory]
\end{verbatim}

\sk
\paragraph{Step 3} Run preprocessing programs to vertically interpolate GCM meteorological fields and generate the initial and boundary conditions directly used by the mesoscale model. See~\ref{real.exe} for further details.
\begin{verbatim}
cd /a_place/MY_SIMU
ln -sf $MMM/your\_compdir/WPS/WRFFEED/current/met_em* .
real.exe
[check that wrfinput* wrfbdy* netCDF files are created]
\end{verbatim}

\sk
\paragraph{Step 4} Run the LMD Martian Mesoscale Model. See~\ref{sc:arsia} for further details.
\begin{verbatim}
cd /a_place/MY_SIMU
wrf.exe [or use a MPI instance for parallel computations]
[check that wrfout* netCDF files are created and filled by simulation results]
[once wrf.exe is running met_em* links can be deleted]
\end{verbatim}

\mk
\section{The \ttt{runmeso} script}

%\mk
%\section{Complete simulations with \ttt{runmeso}}
%
%you'll notice you need to change namelist according to model compilation
%in order to minimize errors and help the user.
%
%\begin{remarque}
%To be completed
%\end{remarque}
%
%parler de xeyes

\mk
\section{Examples of parameter files}