\chapter{SciParam GUI\label{sciparamgui}}

\section{Feature List}

\begin{basedescript}{\desclabelwidth{7mm}\desclabelstyle{\nextlinelabel}}
\item [Parameter entry fields:]
	for different types of values
    \begin{basedescript}{\desclabelwidth{7mm}\desclabelstyle{\nextlinelabel}}

	\item [float values]
	are numbers, which can can be limited to ranges which specify
	a usual range (see \ref{usualrange}) and/or
	a valid range (see \ref{validrange}).
	Ranges can be specified in scientific notation, e.g. {]}-oo;1.2E5{]}
	for a range from minus infinity upto and including 120000.

	\item [distributed values]
	are like float numbers, but you can optionally have distribution type
	(see \ref{distribution}) like normal, log-normal or uniform.

	\item [integer values]
	can have ranges like float number, too.

	\item [strings]
	can contain any characters.

	\item [choices]
	allow to select a value with radiobuttons or from a drop down list
	(see \ref{choices}).

    \end{basedescript}

\item [Details on values:]
	A special details box (see \ref{detailsbox}) provides helpful
	information on a currently focused entry.

\item [Default values:]

	For each entry a default can be specified, which is visible in the
	details box (see \ref{detailsbox}). A button allows to apply the
	default to the current entry.

\item [Comment:]
	It is possible to enter a comment for the current entry in the
	details box (see \ref{detailsbox}).

\item [Status ``unknown'':]
	For any value it is possible to enter the status ``unknown'' by
	deleting the current value. This avoids concepts where a special
	and potentially misinterpreted number represents an unknown value.

\item [Status ``required'':]
	A small cross (``sign here''; see \ref{required}) informs about
	whether a parameter is necessary in a certain context (e.g. to
	complete a parameter set for a simulation equation).
	Giving a value here is not forced by the GUI, since this is only an
	indicator.

\end{basedescript}

\section{Screenshots}

\subsection{Dialog}

This dialog is created by running {\tt python dialog.py}
from inside the SciParam/UI directory:
\begin{center}
\Fig{\includegraphics[scale=\imagescale]{screenshots/dialog.eps}}{
	SciParam Dialog}{SciParam Dialog}
\end{center}

\clearpage
\subsection{Notebook}

This dialog is created by running {\tt python notebook.py}
from inside the SciParam/UI directory:
\begin{center}
\Fig{\includegraphics[scale=\imagescale]{screenshots/notebook.eps}}{
	SciParam Notebook}{SciParam Notebook}
\end{center}

\clearpage
\subsection{Detailed Information\label{detailsbox}}

A box will show additional details for the currently selected parameter.
Here you see the parameter ``Volume'' with a long description ``Volume of used
samples''. It only allows float values greater or equal zero up to infinity.

There was no distribution active, but now the user selected ``uniform'',
therefore a new dialog shows up which asks for the maximum value.

The user already noted a comment to the value he's typing now, so nobody
should wonder where it came from.

Using the ``Apply Default'' button, you can also set this value to a default
value, which would be 2;20/uniform in this case. This long format of
``value;distribution parameter/distribution type'' can be used in the input
field, too, to save the user from putting his hands away from the keyboard to
the mouse.
\begin{center}
\Fig{\includegraphics[scale=\imagescale]{screenshots/details.eps}}{
	Details Box}{Details Box}
\end{center}

\subsection{Required Parameters\label{required}}

The small cross indicates that this is a required parameter:
\begin{center}
\Fig{\includegraphics[scale=\imagescale]{screenshots/required.eps}}{
	Required Parameter}{Required Parameter}
\end{center}

\subsection{Usual Ranges\label{usualrange}}

If you enter a value which is theoretically possible, but usually wrong (like
an atomic number far higher than any known chemical element's number), the
input field changes its color to yellow as soon as you leave the input field.

If you try to save this value using the ``OK'' button or switch to another
notebook page, a warning dialog asks if you really want to use this value.
The input field will stay yellow to warn you, even if you confirm this value,
but the warning dialog will only appear again if you change the value.
\begin{center}
\Fig{\includegraphics[scale=\imagescale]{screenshots/usualrange.eps}}{
	Outside Usual Range}{Outside Usual Range}
\end{center}

\subsection{Valid Ranges\label{validrange}}

If you enter a value which is outside the valid range (like less than
-273.15°C for a temperature), the input field changes its color to red as
soon as you leave the input field.

If you try to save this value using the ``OK'' button or switch to another
notebook page, an error dialog forces you to either enter a correct value
or discard changes using the ``Cancel'' button.
\begin{center}
\Fig{\includegraphics[scale=\imagescale]{screenshots/validrange.eps}}{
	Outside Valid Range}{Outside Valid Range}
\end{center}

\clearpage
\subsection{Distributed Parameters\label{distribution}}

When choosing a distribution type, a small dialog asks for additional
parameters like standard deviation or maximum value. Illegal values
for these parameters will be rejected:
\begin{center}
\Fig{\includegraphics[scale=\imagescale]{screenshots/distribution.eps}}{
	Distributed Parameter}{Distributed Parameter}
\end{center}

\subsection{Choice Parameters\label{choices}}

If you have a short list of choices, you can select one of them using
radiobuttons. Choices include questions like Yes/No, or selecting one of
few values like 3/5/7 meters.
\begin{center}
\Fig{\includegraphics[scale=\imagescale]{screenshots/choice_short.eps}}{
	Short Choice}{Short Choice}
\end{center}

If you have a long list of choices, selecting one of them is done in a
different way. Otherwise they might not fit inside the input field.
\begin{center}
\Fig{\includegraphics[scale=\imagescale]{screenshots/choice_long.eps}}{
	Long Choice}{Long Choice}
\end{center}

\subsection{Grouped Parameters\label{groups}}

Parameters that belong together can be grouped.
\begin{center}
\Fig{\includegraphics[scale=\imagescale]{screenshots/groups.eps}}{
	Grouped Parameters}{Grouped Parameters}
\end{center}

