NAME

romsvdfcreate - Generate a VDF metadata file for a ROMS data set

SYNOPSIS

romsvdfcreate [options] roms_ncdf_files... roms_grid_file vdffile

DESCRIPTION

romsvdfcreate generates a .vdf metafile that defines a VAPOR Data Collection (VDC) suitable for containing ocean simulation output from a ROMS model output. All of the model output NetCDF filenames must be provided on the command line, followed by one NetCDF grid filename, and the desired VAPOR (.vdf) file name. The grid file must include variables that do not change in time, including the depth of the ocean, and the variables defining mappings from the model grid to latitude, latitude, and depth. The grid file may also be included in the collection roms_netcdf_files, if it contains data variables that change in time.

OPTIONS

-vars <varnames>: A colon-delimited list of names of 2D and 3D (spatial) data variables to include in the .vdf file. In general, the list of variables should be a subset of the data variables found in the MOM/POP input files. If this option is not present the default behavior is to generate the list of variables from all of the 2D and 3D (spatial) variables found in any of the MOM/POP netCDF input files.
-level <level>: See vdfcreate.
-comment <string>: See vdfcreate.
-bs <NXxNYxNZ>: See vdfcreate.
-wname <wave_name>: This option is for VDC2 only, see vdfcreate.
-cratios <vector>: This option is for VDC2 only, see vdfcreate.
-help: Print a usage statement and then exit.

EXAMPLES

The command

    romsvdfcreate -vars u:v:temp roms1.nc roms2.nc roms3.nc romsgrid.nc mydata.vdf

will construct a VDF file, mydata.vdf that will contain the u, v, and temp variable names for all time steps found in the ROMS netCDF files roms1.nc, roms2.nc, and roms3.nc. The netCDF file romsgrid.nc will contain time-invariant variables defining the grid.

HISTORY