Concise documentation of the program "ccotoldbn"
------------------------------------------------

The purpose of the program "ccotoldbn" is to convert the structured grid
files as used by D-Water Quality (Delft3D-WAQ) to shape files that can
more easily be used within Delft-FEWS. This is especially useful for the
case of domain decompostion with Delft3D-FLOW. The multiple domains are
combined by the program "agrhyd" into a single grid, but the display
functionality of Delft-FEWS may not show it correctly, as that
makes certain assumptions about the geometry that are not necessarily
true for these composite grids.

With shape files, however, Delft-FEWS is able to correctly present the
results on the composite grid.

The program takes two arguments:
- The first is the _name_ of the grid files without the extensions.
  There are in fact two files, the .lga and the .cco files. Both are
  required for the conversion.

  For instance: the grid files are called "grid.lga" and "grid.cco"
  The first argument to "ccotoldbn" would then be "grid" (drop the
  extension)

- The second is the _name_ of the shape file to be written, again
  without an extension. This results in three files. For example:
  specifying "newgrid" as the second argument results in the files
  "newgrid.shp", "newgrid.shx" and "newgrid.dbf" to be written.

  The dbf file contains the link between the polygons in the shape file
  and the grid cell numbers in the water quality model. The name of the
  column is "number". This column name is needed to link the output
  results to the polygons.

For example:

  ccotoldbn gridin gridout

reads the Delft3D grid files gridin.lga and gridin.cco and produces the
shape file gridout.shp plus companion files gridout.shx and gridout.dbf.