  1.  NAME

  codastree - Create a subdirectory tree for a CODAS database

  2.  USAGE

  codastree [options] [path/]dbname

  3.  DESCRIPTION

  This utility is a generalization of adcptree. The list of directories
  to create and files to copy is easier to maintain, as this Perl script
  finds them automatically. It is not limited to an ADCP database tree,
  but to any kind of implemented databases. It also support user
  specific database tree.

  Argument dbname specifies the name for the database directory tree,
  with eventually a path if it should not be created in the current
  directory. Below this directory, a CODAS database tree will be created
  for each specified databases (see option -t).  If none is specified,
  all implemented types will be used.

  User specific database trees must be located in directory ~/.codas.
  This one can contain as many CODAS database directory trees for
  different projects. Within each project subdirectory, directory dbtree
  can have as many database types, even some that are not supported by
  the CODAS distribution.

  This utility makes a copy of all directories into the specified
  database directory dbname, and copies all files encountered.  Symbolic
  links are supported, however, circular links.

  4.  OPTIONS

  The following options are implemented:

     -p project
        Specify a project name for creating and copying user specific
        database trees. With this option, the database trees from the
        CODAS distribution are not copied (see also option -P).

     -t type,type,...
        Comma separated list of database types to create. No spaces are
        allowed within the list, even of quoted. If missing, all
        currently implemented database types will be generated.

     -u Only update the database trees. If files are already existing in
        the destination directory, these are not overwritten by those
        from the source directories.

     -D directory
        Path to the CODAS distribution. If this option overrides the
        value of environment variable CODASHOME.

     -P project
        As option -p. However, database trees from the CODAS
        distribution are copied before copying user specific ones.

  5.  EXAMPLES

  To create database trees for CTD, ADCP and SSR data into a main CODAS
  database tree called 9820, use

  ______________________________________________________________________
            codastree -t adcp,ctd,ssr 9820

  ______________________________________________________________________

  Assuming that these data require a lot of special parameters in con-
  trol files which do not change from cruise to cruise carried out in
  the same area, use

  ______________________________________________________________________
            codastree -t adcp,ctd,ssr -P veins 9820

  ______________________________________________________________________

  Now in directory ~/.codas/veins/dbtree, make an image of the subdirec-
  tories and files you want to have each time you want to process data
  from this project. These files will override those from the CODAS dis-
  tribution. Using option -p instead would not copy the latter files.

  Assuming now that one needs to create a database for other data.  This
  can be done by making an image of the directories and files to copy
  below one of the specific project subdirectories, i.e. in

  ______________________________________________________________________
            ~/.codas/project_name/dbtree/new_dbtype

  ______________________________________________________________________

  6.  SEE ALSO

  adcptree

  7.  AUTHOR

  Pierre Jaccard, Geophysical Institute, University of Bergen, 1999

