Read Me

============================================================
WDB - Water and Weather Database System
============================================================

Norwegian Meteorological Institute (met.no)
Box 43 Blindern
0313 OSLO
NORWAY

email: wdb@met.no

WDB is a database system for storage and retrieval of weather and 
water observations and forecasts. It handles both gridded data
(raster) and point data. 

The WDB system consists of a significant number of components,
not all of which are likely to be of interest for every user.



Components
============

wdb
------------

This is the WDB core, consisting of the database itself as well as
various common libraries.

metadata/metno
------------

The WDB code includes a basic set of metadata sufficient for simple data
operations and testing. The metno metadata package sets up the namespace
for met.no metadata (88) in the database and adds data providers, place
definitions, and parameters that are specific to this name space.

loader/loaderBase
------------

This is the common library for loading data into the database. Most
of the WDB loading programs utilize the functions offered by this
library.

loader/bilLoad
------------

This is a loading program that can be used to load BIL files into
WDB. This is not a fully featured implementation.

loader/demLoad
------------

This is a loading program that can be used to load DEM files
(topographical files issued by Statens Kartverk in Norway) into WDB.
DEM files are ASCII files containing sequences of floating point
numbers.

loader/feltLoad
------------

This is a loading program that can be used to load FELT files. FELT
is a proprietary legacy format for encoding forecast data that is 
used at the Norwegian Meteorological Institute.

loader/gribLoad
------------

This is a loading program that can be used to load GRIB files using
the ECMWF GRIB API. 

loader/kvalobsLoad (deprecated)
------------

This is a loading program that can be used to load point data from
the met.no KVALOBS server. Currently non-functional.

loader/moxLoad
------------

This is a loading program that can be used to load MOX data. MOX is
a GML-enabled XML format that can be used to encode Meteorological
and Oceanographic data. See http://mox.met.no for details about MOX. 

loader/topographyLoad (deprecated)
------------

This is a loading program for topography files.

wdb2ts
------------

This is an Apache module that can be set up to return data from WDB
through a REST interface on the internet. WDB2TS can return data as
comma-seperated text or using MOX (a GML-based XML schema).  

wdbAdmin
------------

This is a graphical client to the WDB admin program which can also
be used to add and set metadata in the WDB database.



Installation
============

Please refer to the individual INSTALL files in each component for
generic installation instructions. The top-level Makefile can be
used to compile, install, uninstall, and distcheck multiple
components, using the following commands:

	./autogen.sh [Options]
	./configure [Options]
	make [Command]
	
To compile and install individual components (strongly recommended if
this is your first time working with the WDB system or if the top-level
Makefiles don't work), use the autotools framework in the component 
directory.