dive4elements/gnv-client: doc/config-manual/generating

annotate doc/config-manual/generating_maps.tex @ 1139:3a28fef65500

dummy merge for repo head

author	Thomas Arendsen Hein <thomas@intevation.de>
date	Fri, 28 Sep 2012 12:15:16 +0200
parents	975bb59bb136
children

rev	line source
938 2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	1 \subsection{Generating Maps-- Background Information and Configuration}
2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	2
946 dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	3 The artifact-server is able to process geographic data and provide them
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	4 for a WMS service rendering maps via a HTTP-based interface. The
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	5 following process chains are covered. For generating horizontal-cross sections,
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	6 the following steps have to be processed:
938 2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	7
946 dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	8 \begin{enumerate}
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	9 %% FIXME: When do we clip? Sequence will influence the interpolation
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	10 \item Selecting the data from datawarehouse
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	11 \item Clipping the datasets along the passed polygon
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	12 \item Calculating interpolation in the plane
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	13 \item Generating contour lines
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	14 \item Matching processed parameter data to the corresponding style
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	15 \item Rendering requested map
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	16 \end{enumerate}
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	17
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	18 For generating maps from object-based datamodels like CONTIS, NAUTHIS
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	19 and Marine Features, just the following steps are needed:
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	20
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	21 \begin{enumerate}
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	22 \item Selecting the data from datawarehouse
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	23 \item Clipping the datasets along the passed polygon
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	24 \item Matching processed object data to the corresponding style
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	25 \item Rendering requested map
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	26 \end{enumerate}
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	27
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	28 In order to understand the configuration facilities for generating maps
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	29 in more detail, the internal
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	30 interaction of the artifact-server and the mapserver is described below
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	31 for the use case when a user parameterizes a horizontal-cross-section
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	32 profile and visualizes it as a map (without regarding the caching
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	33 facilities)
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	34
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	35 \begin{enumerate}
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	36 \item After finishing the parameterization, the artifact-server
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	37 requests the data from the database-backend and processes the data
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	38 (see above).
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	39
948 975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	40 \item By requesting a map in the GNV-WebClient, the artifact-server writes
975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	41 a ESRI shapefile with (clipped) geometries, attribute data, projection
975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	42 information and a special file storing meta information (\texttt{meta.xml})
975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	43 for this artifact in the a corresponding directory in the
947 9a28846dfb9c Final QS for V1.0 Hans Plum <hans.plum@intevation.de> parents: 946 diff changeset	44 \texttt{shapefile-directory}.
946 dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	45
948 975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	46 \item After that the so called \texttt{map-generator} is triggered. The
975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	47 map-generator searches the \texttt{shape-directory} and its subfolders with
975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	48 all existing \texttt{meta.xml} files and generates a central configuration
975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	49 file for the mapserver at \texttt{ map-generator/mapfile@path}. Each
975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	50 shapefile will be published as a WMS layer. \\
975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	51 The generated mapfile is constructed out of a base template from \texttt{
975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	52 map-generator/templates/maptemplate} and a parameter-/layer-specific part
975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	53 generated from \texttt{map-generator/templates/path}. The selection of the
975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	54 correct file-based templates is extracted out of the
975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	55 \texttt{meta.xml}-file.
946 dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	56
948 975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	57 \item The matching between the generated geograpic data and the
975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	58 corresponding style files is been done by the artifact-server, constructing
946 dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	59 filenames of maptemplates out of parameter-information. For
947 9a28846dfb9c Final QS for V1.0 Hans Plum <hans.plum@intevation.de> parents: 946 diff changeset	60 horizontal-cross-sections the schema looks like this \texttt{
948 975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	61 horizontalcrosssection\_\$NAME-OF-PARAMETER}; for layer-orientated FIS like
975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	62 e.g. NAUTHIS and CONTIS like this \texttt{
946 dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	63 layer\_\$ID\_MAPSERVICE\_\$ID\_LAYER} e.g.
947 9a28846dfb9c Final QS for V1.0 Hans Plum <hans.plum@intevation.de> parents: 946 diff changeset	64 \texttt{layer\_BSH\_IMS\_CONTIS\_Resources\_2}.
946 dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	65 %% FIXME@TE: Marine Feature? Name of WMS?
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	66 In order to set at least title, geometry-type and path to the
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	67 corresponding shapefile dynamically a templating language, called
947 9a28846dfb9c Final QS for V1.0 Hans Plum <hans.plum@intevation.de> parents: 946 diff changeset	68 \texttt{velocity} is used.
946 dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	69
947 9a28846dfb9c Final QS for V1.0 Hans Plum <hans.plum@intevation.de> parents: 946 diff changeset	70 \item The corresponding subfolder of an artifact in \texttt{
946 dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	71 shape-directory} with their shapefiles
947 9a28846dfb9c Final QS for V1.0 Hans Plum <hans.plum@intevation.de> parents: 946 diff changeset	72 and \texttt{meta.xml}-document will be deleted after the time of
9a28846dfb9c Final QS for V1.0 Hans Plum <hans.plum@intevation.de> parents: 946 diff changeset	73 expiry. By triggering the \texttt{map-generator} the next time, the
946 dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	74 geographic data and the central configuration of the mapserver will
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	75 be updated.
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	76
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	77 \end{enumerate}
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	78
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	79 The coupling of the artifact-server and mapserver is free of
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	80 maintenance. The artifact-server as master cares about deleting and
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	81 updating the configuration of the mapserver.
938 2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	82
2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	83 \begin{lstlisting}
2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	84 artifact-database
2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	85 \|-- gnv # charts, palettes, interpolation parameters
2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	86 \| \|-- map-generator
2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	87 \| \|-- shapefile-directory
2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	88 \| `-- horizontal-cross-section
2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	89 \|-- mapserver
2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	90 `-- velocity
2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	91 \end{lstlisting}
2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	92
946 dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	93 \paragraph*{mapserver}
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	94 {\em Function}: URL of the mapserver where request can be send to. The
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	95 URL will be used for displaying the location e.g. in the GNV-WebClient and in
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	96 the {\tt meta.xml}-file.
938 2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	97
2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	98 \begin{itemize}
946 dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	99 \item {\tt server}: URL of the mapserver where request can send to.
938 2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	100 \end{itemize}
2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	101
946 dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	102 \paragraph*{velocity}
948 975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	103 {\em Function}: Templating language used in the maptemplates at
975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	104 \texttt{map-generator/templates/path} for accessing the parameters from
947 9a28846dfb9c Final QS for V1.0 Hans Plum <hans.plum@intevation.de> parents: 946 diff changeset	105 dynamically generated \texttt{meta.xml}-configuration of artifacts.
938 2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	106
2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	107 \begin{itemize}
948 975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	108 \item {\tt logfile}: Setting the path to write log files. \\
975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	109 Preconfigured to \texttt{/var/log/artifacts/velocity.log}.
975bb59bb136 Adapted config-manual according to admin-manual Hans Plum <hans.plum@intevation.de> parents: 947 diff changeset	110 {\bf Just
946 dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	111 absolute pathes are allowed here!}
938 2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	112 \end{itemize}
2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	113
946 dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	114 \paragraph*{map-generator}
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	115 {\em Function}: Mechanism for generating configuration for the {\tt
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	116 mapserver} dynamically. For background information about the interaction
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	117 between artifact-server and mapserver, see above.
938 2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	118
2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	119 \begin{itemize}
946 dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	120 \item {\tt mapfile}: path to the mapfile accessed by the WMS wrapper
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	121 {\tt gnv-wms}
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	122 \item {\tt templates}: \\ {\tt path} to the directory where
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	123 parameter-specific mapconfiguartions (as *.vm) are stored.
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	124 \\ {\tt
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	125 maptemplate} containing the WMS instance-specific configurations and
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	126 metadata, like overall boundingbox, spatial reference systems and
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	127 contact data.
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	128 \end{itemize}
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	129
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	130 \paragraph*{shapefile-directory}
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	131 {\em Function}: Pointer where shapefiles for map-generation are stored
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	132
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	133 \begin{itemize}
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	134 \item {\tt path}: path to the directory where shapefiles are stored
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	135 and accessed by {\tt mapserver}
938 2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	136 \end{itemize}
2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	137
946 dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	138 \paragraph*{horizontal-cross-section}
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	139 {\em Function}: Parameterization for the interpolation algorithm for
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	140 horizontal-cross-sections (maps).
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	141
938 2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	142
2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	143 \begin{itemize}
946 dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	144 \item {\tt sample}: The attribute {\tt number} sets the number of
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	145 steps for the interpolation grid.
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	146 \item {\tt ground}: {\tt interpolation} method for calculating the
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	147 interpolation from the last measured value in meshes against the seafloor.
dd6102eae823 Added content for generating maps Hans Plum <hans.plum@intevation.de> parents: 938 diff changeset	148 Available methods are {\tt nearest-neighbor \| bilinear \| bicubic}.
938 2d84fc30ab58 Added more chapters in config-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	149 \end{itemize}

Mercurial > dive4elements > gnv-client

annotate doc/config-manual/generating_maps.tex @ 1139:3a28fef65500