read_v3c

(./IO_Functions/read_v3c.m)

Function Synopsis

[data,nnv]=read_v3c(fname);

Help text

READ_V3C read a FEM output file of .v3c filetype.
   READ_V3C is part of a suite of OPNML I/O functions  
   to read specific filetypes pertaining to FEM model  
   input and output.   These functions allow the user to
   get these data files into MATLAB without copying the
   files and removing the header info by hand.

   READ_V3C reads the FEM filetype .v3c, as detailed in
   "Data File Standards for the Gulf of Maine Project"
   from the Numerical Methods Laboratory at Dartmouth
   College.  (This document is located in the OPNML
   notebook under External Documents.)  There are eight
   columns, the first of which is the node number.  The
   remaining columns are floating point.  

   Input :   If fname is omitted, READ_V3C enables a file browser
             with which the user can specify the .v3c file.

             Otherwise, fname is the name of the .v3c file, relative 
             or absolute (fullpath), including the suffix '.v3c'.
             This input is a string so it must be enclosed in single 
             quotes. The header lines are discarded.
  Output :   The data part is returned in the variable data. 

             Call READ_V3C as:
             >> [data,nnv]=read_v3c(fname);

             If READ_V3C cannot locate the file, it exits, returning 
             a -1 instead of the data matrix.

   NOTES :   The v3c filetype contains 3-D data; i.e., complex-valued
             velocity data at each vertical node per horizontal node.
             The v3c format has phase in degrees while related .vel
             file has phase in radians.

 Call as: [data,nnv]=read_v3c(fname);

 Written by : Brian O. Blanton