2012-10-15 09:57:17 -05:00
|
|
|
\section{Specifying Parameters}
|
2012-02-14 08:52:59 -06:00
|
|
|
\label{sec:inputFiles}
|
2012-02-13 04:11:31 -06:00
|
|
|
|
2012-10-15 09:57:17 -05:00
|
|
|
As already mentioned in the previous section, \eWoms allows to specify
|
|
|
|
a number of parameters at run time. A description of these parameters
|
2012-11-01 10:34:50 -05:00
|
|
|
can usually be obtained by passing the \texttt{--help} parameter to the
|
2012-10-15 09:57:17 -05:00
|
|
|
executable. The values used for these parameters are printed to the
|
|
|
|
terminal during the start-up of the simulation, e.g. the if the \texttt{lens\_immiscible}
|
2012-11-01 10:34:50 -05:00
|
|
|
simulation is run with the parameters \texttt{--end-time=30e3 --foo-param=123}, it will print an output similar to
|
2012-02-13 04:11:31 -06:00
|
|
|
\begin{lstlisting}[style=Bash]
|
2012-10-15 09:57:17 -05:00
|
|
|
###########
|
|
|
|
# Parameters specified at run-time
|
|
|
|
###########
|
|
|
|
EndTime="30e3"
|
|
|
|
###########
|
|
|
|
# Parameters with use compile-time fallback values
|
|
|
|
###########
|
|
|
|
AmgCoarsenTarget="5000"
|
|
|
|
...
|
|
|
|
VtkWriteSaturations="1"
|
|
|
|
VtkWriteTemperature="1"
|
|
|
|
VtkWriteViscosities="0"
|
|
|
|
###########
|
|
|
|
# Parameters unknown to the simulation
|
|
|
|
###########
|
|
|
|
FooParam="123"
|
2012-02-13 04:11:31 -06:00
|
|
|
\end{lstlisting}
|
|
|
|
|
2012-10-15 09:57:17 -05:00
|
|
|
This can be directly copy-and-pasted into a file
|
2012-11-01 10:34:50 -05:00
|
|
|
(e.g. \texttt{myparams.ini}). The simulation can be instructed to use
|
|
|
|
these parameters by passing the \texttt{--parameter-file=myparams.ini}
|
|
|
|
parameter the next time it is run. Of course, this file can also be
|
|
|
|
adapted.
|
2012-02-24 06:42:40 -06:00
|
|
|
|
2012-11-01 10:34:50 -05:00
|
|
|
An additional hint: Always watch out for parameters which are unknown
|
|
|
|
to the simulation, as this is \emph{very} useful for spotting typos.
|
2012-02-13 04:11:31 -06:00
|
|
|
|
2012-10-15 09:57:17 -05:00
|
|
|
%%% Local Variables:
|
|
|
|
%%% mode: latex
|
|
|
|
%%% TeX-master: "ewoms-handbook"
|
|
|
|
%%% End:
|