hans@938: \subsection{Generating Charts -- Background Information and Configuration}
hans@938: 
hans@945: The artifact-server is able to render different types of charts like 1D
hans@945: (timeseries, vertical- and horizontalprofiles, horizontal-cross-section
hans@945: profiles (a special case of the horizontalprofiles) and histograms) and 2D-diagrams
hans@945: (vertical-cross section profiles). This section describes the
hans@945: possibilities to configure different aspects for interpolating of data and
hans@945: visualising them in charts.
hans@938: 
hans@938: \begin{lstlisting}
hans@938: artifact-database
hans@938: `-- gnv # charts, palettes, interpolation parameters
hans@938:     |-- charttemplate
hans@938:     |-- palettes
hans@938:     |-- horizontal-cross-section-profile
hans@938:     `-- vertical-cross-section
hans@938: \end{lstlisting}
hans@938: 
hans@938: \paragraph*{charttemplate}
hans@945: {\em Function}: The chart template is a global template for setting the
hans@945: visualization of charts globally like font styles, background, title,
hans@945: subtitle, etc. Further information can be found in the configuration
hans@945: file referenced via the attribute {\tt configuration}.
hans@938: 
hans@938: \begin{itemize}
hans@945:     \item {\tt configuration}: path to the configuration XML-file.
hans@938: \end{itemize}
hans@938: 
hans@938: 
hans@938: \paragraph*{palettes}
hans@945: {\em Function}: This section lists the available palettes used for rendering
hans@945: vertical-cross-section charts (2D). Each {\tt palette}-element contains
hans@945: the following attributes:
hans@938: 
hans@938: \begin{itemize}
hans@945:     \item {\tt name}: a descriptive name.
hans@945:     \item {\tt parameter-ids}: identifier used as keys for matching
hans@945:     between data (from the database) and palette. {\bf The {\tt
hans@945:     parameter-ids} have to been in sync with the database parameters
hans@945:     (normally in {\tt MEDIAN.Parameter})}
hans@945:     \item {\tt description}: a description.
hans@945:     \item {\tt file}: reference to the defintion of the palette.
hans@945: \end{itemize}
hans@945: 
hans@945: For defining ranges for a palette, a range is definied by:
hans@945: 
hans@945: \begin{itemize}
hans@945:     \item {\tt index}: Index for accessing the explicit range from the
hans@945:     program logic. 
hans@945:     \item {\tt from}: lower limit of a range.
hans@945:     \item {\tt to}: upper limit of a range
hans@945:     \item {\tt rgb}: Red-Green-Blue (RGB) value for rendering the range
hans@945:     \item {\tt description}: description for rendering the legend. For
hans@945:     special characters use HTML-encoded values like {\tt \&lt;} for $<$
hans@945:     or {\tt \&gt;} for $>$.
hans@938: \end{itemize}
hans@938: 
hans@938: 
hans@938: \paragraph*{horizontal-cross-section-profile}
hans@938: 
hans@945: {\em Function}: Parameterization for the interpolation algorithm for
hans@945: horizontal-cross-section-profile calculating the interpolated value
hans@945: along the distance.
hans@938: 
hans@938: \begin{itemize}
hans@945:     \item {\tt samples}: Number of samples calculated for a
hans@945:     interpolation along the passed geometric line.
hans@938: \end{itemize}
hans@938: 
hans@938: 
hans@938: \paragraph*{vertical-cross-section}
hans@945: {\em Function}: Parameterization for the interpolation algorithm for
hans@945: vertical-cross-sections (2D-charts).
hans@938: 
hans@938: \begin{itemize}
hans@945:     \item {\tt samples}: Parameters for defining the interpolation grid.
hans@945:     {\tt width} for horizontal distances; {\tt height} for the vertical
hans@945:     distance.
hans@945:     \item {\tt ground}: {\tt interpolation} method for calculating the
hans@945:     interpolation from the last measured value against the seafloor.
hans@945:     Available methods are {\tt nearest-neighbor | bilinear | bicubic}.\\
hans@945:     {\tt fill-color}: setting the file color for the seafloor in the
hans@945:     diagram.
hans@938: \end{itemize}