codastree(1)

NAME
codastree - Create a subdirectory tree for a CODAS database

USAGE
codastree [options] [path/]dbname

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.

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.

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 control 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 subdirectories and files you want to have each time you want to process data from this project. These files will override those from the CODAS distribution. 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

SEE ALSO
adcptree

AUTHOR
Pierre Jaccard, Geophysical Institute, University of Bergen, 1999