Changeset 221 for trunk/MESOSCALE_DEV/MANUAL/SRC

Timestamp:

Jul 13, 2011, 10:38:37 PM (13 years ago)

Author:

aslmd

Message:

MESOSCALE: user manual. a small bug fix to the previous commit. sorry.

Location:

trunk/MESOSCALE_DEV/MANUAL/SRC

Files:

• preproc.tex (modified) (1 diff)
• user_manual_txt.tex (modified) (1 diff)

trunk/MESOSCALE_DEV/MANUAL/SRC/preproc.tex

@@ -110 +110 @@
 \end{center}
 
-\end{document}
 
-\mk
-\subsubsection{Meteorological data}
+\clearemptydoublepage
 
-\ttt{launch\_gcm}
-
-\mk
-The preprocessing tools generate initial and boundary conditions
-from the \ttt{diagfi.nc} outputs of LMD-MGCM simulations.
-%
-If you would like to run a mesoscale simulation at a given
-season, you need to first run a GCM simulation and output
-the meteorological fields at the considered season.
-%
-For optimal forcing at the boundaries, we advise you
-to write the meteorological fields to the 
-\ttt{diagfi.nc} file at least each two hours.
-%
-Please also make sure that the following fields
-are stored in the NETCDF \ttt{diagfi.nc} file:
-
-\footnotesize
-\codesource{contents_diagfi}
-
-\normalsize
-\begin{finger}
-\item If the fields 
-\ttt{emis}, 
-\ttt{co2ice}, 
-\ttt{q01}, 
-\ttt{q02}, 
-\ttt{tsoil} 
-are missing in the \ttt{diagfi.nc} file, 
-they are replaced by respective default 
-values $0.95$, $0$, $0$, $0$, tsurf.
-\end{finger}
-
-\mk
-\marge An example of input meteorological file 
-\ttt{diagfi.nc} file can be downloaded
-at \url{http://web.lmd.jussieu.fr/~aslmd/LMD_MM_MARS/diagfi.nc.tar.gz}.
-%
-Please deflate the archive and copy the \ttt{diagfi.nc} file
-in \ttt{\$LMDMOD/TMPDIR/GCMINI}.
-%
-Such a file can then be used to define the initial
-and boundary conditions, and we will go 
-through the three preprocessing steps.
-
-\mk
-\subsection{Preprocessing steps} 
-
-\mk
-\subsubsection{Step 1: Converting GCM data}
-
-\mk
-The programs in the \ttt{PREP\_MARS} directory
-convert the data from the NETCDF \ttt{diagfi.nc}
-file into separated binary datafiles for each
-date contained in \ttt{diagfi.nc}, according to
-the formatting needed by the 
-preprocessing programs at step 2.
-%
-These programs can be executed by the following
-commands: 
-\begin{verbatim}
-cd $LMDMOD/LMD_MM_MARS/your_install_dir/PREP\_MARS
-echo 1 | ./create_readmeteo.exe     # drop the "echo 1 |" if you want control
-./readmeteo.exe < readmeteo.def
-\end{verbatim}
-%
-\marge If every went well with the conversion,
-the directory \ttt{\$LMDMOD/TMPDIR/WPSFEED}
-should contain files named \ttt{LMD:}.
-
-\mk
-\subsubsection{2: Interpolation on the regional domain}
-
-\mk
-In the \ttt{WPS} directory, the \ttt{geogrid.exe} program allows 
-you to define the mesoscale simulation domain
-to horizontally interpolate the topography, 
-thermal inertia and albedo fields at the domain
-resolution and to calculate useful fields
-such as topographical slopes.%\pagebreak
-
-\mk
-\marge Please execute the commands:
-%
-\begin{verbatim}
-cd $LMDMOD/LMD_MM_MARS/your_install_dir/WPS
-ln -sf ../../TESTCASE/namelist.wps .   # test case
-./geogrid.exe
-\end{verbatim}
-%
-\marge The result of \ttt{geogrid.exe} 
--- and thus the definition of the mesoscale
-domain -- can be checked in the NETCDF
-file \ttt{geo\_em.d01.nc}.
-%
-A quick check can be performed using the command line
-\begin{verbatim}
-ncview geo_em.d01.nc
-\end{verbatim} 
-\marge if \ttt{ncview} is installed, or the \ttt{IDL}
-script \ttt{out\_geo.pro}
-\begin{verbatim}
-idl
-IDL> out_geo, field1='TOPO'
-IDL> out_geo, field1='TI'
-IDL> SPAWN, 'ghostview geo_em.d01_HGT_M.ps &'
-IDL> SPAWN, 'ghostview geo_em.d01_THERMAL_INERTIA.ps &'
-IDL> exit
-\end{verbatim}
-\marge if the demo version of \ttt{IDL} is installed.
-%
-Of course if your favorite graphical tool supports
-the NETCDF standard, you might use it to check the
-domain definition in \ttt{geo\_em.d01.nc}.
-
-\mk
-\marge If you are unhappy with the results or
-you want to change 
-the location of the mesoscale domain on the planet, 
-the horizontal resolution,
-the number of grid points \ldots,
-please modify the parameter
-file \ttt{namelist.wps} and execute again \ttt{geogrid.exe}.
-%
-Here are the contents of \ttt{namelist.wps}:
-%
-\codesource{namelist.wps_TEST} 
-
-\begin{finger}
-%
-\item No input meteorological data 
-are actually needed to execute \ttt{geogrid.exe}.
-%
-\item More details about the database and
-more options of interpolation could be
-found in the file \ttt{geogrid/GEOGRID.TBL}.
-%
-\item Defining several domains yields
-distinct files 
-\ttt{geo\_em.d01.nc},
-\ttt{geo\_em.d02.nc},
-\ttt{geo\_em.d03.nc}\ldots
-\end{finger}
-
-\mk
-\marge Once the \ttt{geo\_em} file(s) are generated,
-the \ttt{metgrid.exe} program performs
-a similar horizontal interpolation 
-of the meteorological fields to the mesoscale 
-domain as the one performed by \ttt{geogrid.exe} 
-for the surface data.
-%
-Then the program writes the results in
-\ttt{met\_em} files and also collects
-the static fields and domain parameters
-included in the \ttt{geo\_em} file(s)
-%
-Please type the following commands:
-\begin{verbatim}
-cd $LMDMOD/LMD_MM_MARS/your_install_dir/WPS
-./metgrid.exe
-\end{verbatim}
-%
-\marge If every went well,
-the directory \ttt{\$LMDMOD/TMPDIR/WRFFEED}
-should contain the \ttt{met\_em.*} files.
-
-\mk
-\subsubsection{Step 3: Vertical interpolation on mesoscale levels}
-
-\mk
-\marge The last step is to execute \ttt{real.exe}
-to perform the interpolation from the vertical
-levels of the GCM to the vertical levels 
-defined in the mesoscale model.
-%
-This program also prepares the final initial
-state for the simulation in files called
-\ttt{wrfinput} and the boundary conditions
-in files called \ttt{wrfbdy}.
-
-\mk
-\marge To successfully execute \ttt{real.exe}, 
-you need the \ttt{met\_em.*} files
-and the \ttt{namelist.input} file
-to be in the same directory as \ttt{real.exe}.
-%
-Parameters in \ttt{namelist.input} 
-controlling the behavior of the vertical interpolation 
-are those labelled with \ttt{(p3)} in the detailed
-list introduced in the previous chapter.
-
-\mk
-\marge Please type the following commands
-to prepare files for the Arsia Mons test case
-(or your personal test case if you changed
-the parameters in \ttt{namelist.wps}):
-\begin{verbatim}
-cd $LMDMOD/TESTCASE
-ln -sf $LMDMOD/WRFFEED/met_em* .
-./real.exe
-\end{verbatim}
-
-\mk
-\marge The final message of the \ttt{real.exe}
-should claim the success of the processes and you
-are now ready to launch the integrations
-of the LMD Martian Mesoscale Model again
-with the \ttt{wrf.exe} command as in section
-\ref{sc:arsia}.
-
-\begin{finger}
-\item When you modify either 
-\ttt{namelist.wps} or \ttt{namelist.input},
-make sure that the common parameters
-are exactly similar in both files
-(especially when running nested simulations)
-otherwise either \ttt{real.exe} or \ttt{wrf.exe}
-command will exit with an error message.
-\end{finger}
-%\pagebreak

trunk/MESOSCALE_DEV/MANUAL/SRC/user_manual_txt.tex

@@ +1 @@
+
+
+\mk
+\subsubsection{Meteorological data}
+
+\ttt{launch\_gcm}
+
+\mk
+The preprocessing tools generate initial and boundary conditions
+from the \ttt{diagfi.nc} outputs of LMD-MGCM simulations.
+%
+If you would like to run a mesoscale simulation at a given
+season, you need to first run a GCM simulation and output
+the meteorological fields at the considered season.
+%
+For optimal forcing at the boundaries, we advise you
+to write the meteorological fields to the 
+\ttt{diagfi.nc} file at least each two hours.
+%
+Please also make sure that the following fields
+are stored in the NETCDF \ttt{diagfi.nc} file:
+
+\footnotesize
+\codesource{contents_diagfi}
+
+\normalsize
+\begin{finger}
+\item If the fields 
+\ttt{emis}, 
+\ttt{co2ice}, 
+\ttt{q01}, 
+\ttt{q02}, 
+\ttt{tsoil} 
+are missing in the \ttt{diagfi.nc} file, 
+they are replaced by respective default 
+values $0.95$, $0$, $0$, $0$, tsurf.
+\end{finger}
+
+\mk
+\marge An example of input meteorological file 
+\ttt{diagfi.nc} file can be downloaded
+at \url{http://web.lmd.jussieu.fr/~aslmd/LMD_MM_MARS/diagfi.nc.tar.gz}.
+%
+Please deflate the archive and copy the \ttt{diagfi.nc} file
+in \ttt{\$LMDMOD/TMPDIR/GCMINI}.
+%
+Such a file can then be used to define the initial
+and boundary conditions, and we will go 
+through the three preprocessing steps.
+
+\mk
+\subsection{Preprocessing steps} 
+
+\mk
+\subsubsection{Step 1: Converting GCM data}
+
+\mk
+The programs in the \ttt{PREP\_MARS} directory
+convert the data from the NETCDF \ttt{diagfi.nc}
+file into separated binary datafiles for each
+date contained in \ttt{diagfi.nc}, according to
+the formatting needed by the 
+preprocessing programs at step 2.
+%
+These programs can be executed by the following
+commands: 
+\begin{verbatim}
+cd $LMDMOD/LMD_MM_MARS/your_install_dir/PREP\_MARS
+echo 1 | ./create_readmeteo.exe     # drop the "echo 1 |" if you want control
+./readmeteo.exe < readmeteo.def
+\end{verbatim}
+%
+\marge If every went well with the conversion,
+the directory \ttt{\$LMDMOD/TMPDIR/WPSFEED}
+should contain files named \ttt{LMD:}.
+
+\mk
+\subsubsection{2: Interpolation on the regional domain}
+
+\mk
+In the \ttt{WPS} directory, the \ttt{geogrid.exe} program allows 
+you to define the mesoscale simulation domain
+to horizontally interpolate the topography, 
+thermal inertia and albedo fields at the domain
+resolution and to calculate useful fields
+such as topographical slopes.%\pagebreak
+
+\mk
+\marge Please execute the commands:
+%
+\begin{verbatim}
+cd $LMDMOD/LMD_MM_MARS/your_install_dir/WPS
+ln -sf ../../TESTCASE/namelist.wps .   # test case
+./geogrid.exe
+\end{verbatim}
+%
+\marge The result of \ttt{geogrid.exe} 
+-- and thus the definition of the mesoscale
+domain -- can be checked in the NETCDF
+file \ttt{geo\_em.d01.nc}.
+%
+A quick check can be performed using the command line
+\begin{verbatim}
+ncview geo_em.d01.nc
+\end{verbatim} 
+\marge if \ttt{ncview} is installed, or the \ttt{IDL}
+script \ttt{out\_geo.pro}
+\begin{verbatim}
+idl
+IDL> out_geo, field1='TOPO'
+IDL> out_geo, field1='TI'
+IDL> SPAWN, 'ghostview geo_em.d01_HGT_M.ps &'
+IDL> SPAWN, 'ghostview geo_em.d01_THERMAL_INERTIA.ps &'
+IDL> exit
+\end{verbatim}
+\marge if the demo version of \ttt{IDL} is installed.
+%
+Of course if your favorite graphical tool supports
+the NETCDF standard, you might use it to check the
+domain definition in \ttt{geo\_em.d01.nc}.
+
+\mk
+\marge If you are unhappy with the results or
+you want to change 
+the location of the mesoscale domain on the planet, 
+the horizontal resolution,
+the number of grid points \ldots,
+please modify the parameter
+file \ttt{namelist.wps} and execute again \ttt{geogrid.exe}.
+%
+Here are the contents of \ttt{namelist.wps}:
+%
+\codesource{namelist.wps_TEST} 
+
+\begin{finger}
+%
+\item No input meteorological data 
+are actually needed to execute \ttt{geogrid.exe}.
+%
+\item More details about the database and
+more options of interpolation could be
+found in the file \ttt{geogrid/GEOGRID.TBL}.
+%
+\item Defining several domains yields
+distinct files 
+\ttt{geo\_em.d01.nc},
+\ttt{geo\_em.d02.nc},
+\ttt{geo\_em.d03.nc}\ldots
+\end{finger}
+
+\mk
+\marge Once the \ttt{geo\_em} file(s) are generated,
+the \ttt{metgrid.exe} program performs
+a similar horizontal interpolation 
+of the meteorological fields to the mesoscale 
+domain as the one performed by \ttt{geogrid.exe} 
+for the surface data.
+%
+Then the program writes the results in
+\ttt{met\_em} files and also collects
+the static fields and domain parameters
+included in the \ttt{geo\_em} file(s)
+%
+Please type the following commands:
+\begin{verbatim}
+cd $LMDMOD/LMD_MM_MARS/your_install_dir/WPS
+./metgrid.exe
+\end{verbatim}
+%
+\marge If every went well,
+the directory \ttt{\$LMDMOD/TMPDIR/WRFFEED}
+should contain the \ttt{met\_em.*} files.
+
+\mk
+\subsubsection{Step 3: Vertical interpolation on mesoscale levels}
+
+\mk
+\marge The last step is to execute \ttt{real.exe}
+to perform the interpolation from the vertical
+levels of the GCM to the vertical levels 
+defined in the mesoscale model.
+%
+This program also prepares the final initial
+state for the simulation in files called
+\ttt{wrfinput} and the boundary conditions
+in files called \ttt{wrfbdy}.
+
+\mk
+\marge To successfully execute \ttt{real.exe}, 
+you need the \ttt{met\_em.*} files
+and the \ttt{namelist.input} file
+to be in the same directory as \ttt{real.exe}.
+%
+Parameters in \ttt{namelist.input} 
+controlling the behavior of the vertical interpolation 
+are those labelled with \ttt{(p3)} in the detailed
+list introduced in the previous chapter.
+
+\mk
+\marge Please type the following commands
+to prepare files for the Arsia Mons test case
+(or your personal test case if you changed
+the parameters in \ttt{namelist.wps}):
+\begin{verbatim}
+cd $LMDMOD/TESTCASE
+ln -sf $LMDMOD/WRFFEED/met_em* .
+./real.exe
+\end{verbatim}
+
+\mk
+\marge The final message of the \ttt{real.exe}
+should claim the success of the processes and you
+are now ready to launch the integrations
+of the LMD Martian Mesoscale Model again
+with the \ttt{wrf.exe} command as in section
+\ref{sc:arsia}.
+
+\begin{finger}
+\item When you modify either 
+\ttt{namelist.wps} or \ttt{namelist.input},
+make sure that the common parameters
+are exactly similar in both files
+(especially when running nested simulations)
+otherwise either \ttt{real.exe} or \ttt{wrf.exe}
+command will exit with an error message.
+\end{finger}
+%\pagebreak
+
+