codastree

Last updated Fri Nov 19 13:00:34 1999

Create a subdirectory tree for a CODAS database

1. USAGE

codastree [options] [path/]dbname

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.

3. 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.

4. 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

5. SEE ALSO

adcptree

6. AUTHOR

Pierre Jaccard, Geophysical Institute, University of Bergen, 1999