/*----------------------------------------------------------------------

  1.  NAME

  loaddnmi - Load data from a DNMI file into a CODAS database

  2.  USAGE

  loaddnmi control_file

  3.  DESCRIPTION

  This utility was written for loading 2-D tide data from a numerical
  model into a CODAS database. These data were made available by the
  Norwegian Meteorological Institute (Det Norske Meteorologiske
  Institutt) where the name loaddnmi.

  Currently, only data files containing 2-D tide data is supported.  The
  required producer definition file defining the database is
  DNMI_2DT.def.

  4.  PARAMETERS

  The following parameters have to be defined in the control file:

     dbname: database_name
        Name of database, eventually prefixed with the path to its
        location, if not in the current directory. Remember that the
        base name if a database should not exceed five characters.

     prd_file: file
        Name and path of producer definition file defining the CODAS
        database.

  5.  OPTIONS

  The following options are implemented:

     OPTIONS:
        This key word can be used to improve the clarity of the control
        file and specify the beginning of options. It has no effect.

     longitude_180
        Specify this for converting longitude values between -180 and
        +180 degree before using them.

     grid_points= float
        In the case where data stored in the binary files refer to a
        polar stereographic map projection grid, the number of grid
        points from the Equator to the North Pole along the center
        meridian must be known for converting data back into
        geographical positions. Because files do not always have this
        parameter saved together with the data, this parameter must be
        provided separately.

     time_range: range
        The time range in the usual format, i.e.

          YYYY/MM/DD hh:mm:ss to YYYY/MM/DD hh:mm:ss

     specifying which part of the data to load into the database.  Note
     that this option must be specified.

     position_range: range
        Position range specifying the area of selected data to load into
        the database. The format is the following:

          lat1 lon1 to lat2 lon2

     where latitudes and longitudes can be specified in the following
     formats:

          {d}dd mm' ss.ss" S

          {d}dd mm.mmmm' S

          {d}dd.dddddd S

          S{d}dd.dddddd

     where the optional leading digit d is for longitudes, the sign S is
     one of NSy+- for latitudes and EWX+- for longitudes. Hemisphere
     signs XY refer to bad positions and +- are used for the form where
     the sign S is placed in front of data.  Note that this option must
     be specified.

     end
        This keyword is mandatory and terminates the list of selected
        options.

  6.  LIST OF FILES

  Finally, the control file is terminated by the list of DNMI files to
  parse.

  7.  OUTPUT FILES

  The only files generated by this utility are the database files.

  8.  AUTHOR

  Pierre Jaccard, Geophysical Institute, University of Bergen, 1999



----------------------------------------------------------------------*/