MexEPS for MATLAB

MexEPS is a mex-file interface between EPIC System and MATLAB which enables MATLAB users to access EPIC System data file and many other netCDF file conventions, such as those produced by Ferret, WHOI, etc. efficiently within the MATLAB.

Here is one of the examples which uses MexEPS function to generate a potential temperature contour plot from EPIC CTD data files.

MexEPS supports the following data formats:

• NetCDF data file (read/write/edit)
• Classic EPIC data file (read/write)
• Generic formatted ASCII data file (read only)

The function includes VARIABLE manipulation routines, AXIS manipulation routines, ATTRIBUTE manipulation routines and TIME manipulation routines. Many styles of time axes are supported and time manipulation routines ease the use of that axis in MATLAB. TIME enters MATLAB on read as YYMMDDhhmmss.fff and can be converted to "units since any-basetime". The time axis written out to netCDF file follows the netCDF conventions.

User should refer to EPIC Systme Library User's Guide for details about data files. On-line MexEPS Matlab help is also available.

Another Mex-function provided with this package is ASCII2MAT, which reads a formatted ASCII file into MATLAB as a matrix.

MexEPS programs and examples are available from PMEL's anonymous ftp: ftp://ftp.epic.noaa.gov/eps/mexeps/.

• README --Contains general information about MexEPS.
• src/ --Contains srouce code of mexeps.c and ascii2mat.c. To compile MEXEPS you must also have EPIC System library and NetCDF library built on your system.
• help-m/ --Contains Matlab help script for MexEPS function.
• examples/ --Contains data files and Matlab script programs use MexEPS function to read and write data files.
• epic.key --EPIC key code files. This file is required if you are using MexEPS to read and write EPIC System Data files.
• mexeps-help.tar.gz--Compressed tar file of help-m/.
• example/ --examples files.

You should set following environment variables for these directories after install all *.mexARCH (where ARCH is `4' for Sun4 and `sol' for Solaris), *.m files, and epic.key file:

• MATLABPATH
  directory contains *.mexARCH and *.m (where ARCH is `4' for Sun4 and `sol' for Solaris); and directory contains examples.
• EPS_EPICKEY directory contains epic.key file.

---

Other interesting Matlab tools and interfaces:

• SEA-MAT: Matlab Tools for Oceanographic Analysis
• MEXCDF: The Matlab/NetCDF Interface
• M_Map: A mapping package for Matlab