leahlee0731 / nctoolbox

NCTOOLBOX A Matlab toolbox for working with common data model datasets

NCTOOLBOX

Download the latest release: You can download the latest stable release at by clicking here.

Docs are also available in Chinese (Thanks to @tfoerye): Nctoolbox 使用说明中文版.pdf

Brief summary:

nctoolbox is a Matlab toolbox that provides read-only access to common data model datasets. Under the hood, nctoolbox uses NetCDF-Java as the data access layer. This allows nctoolbox to access NetCDF, OPeNDAP, HDF5, GRIB, GRIB2, HDF4 and many (15+) other file formats and services using the same API. It works with Matlab 2008a and later.

Prequisites

Matlab R2008a+. You can verify the version of Matlab by typing:

version

Java 6+. You can verify the version of Java used by Matlab by typing:

version('-java'). 

The version returned should start with 'Java 1.6'. If it starts with 'Java 1.5' you can try updating the Matlab JVM: http://www.mathworks.com/support/solutions/en/data/1-1812J/ or use the older nctoolbox-20091112 version of this toolbox.

Setup

In Matlab, change to the nctoolbox directory. For example,

cd ~/Documents/MATLAB/nctoolbox

Run the setup_nctoolbox.m function

setup_nctoolbox

This sets up nctoolbox for the current Matlab session only. You will need to add the follwing lines to your startup.m file if you would like nctoolbox automatically when you start Matlab:

% Edit '/Path/to/nctoolbox' to correct nctoolbox directory
addpath('/Path/To/nctoolbox')
setup_nctoolbox

Demos

• Demos that display basic functionality are in the 'demos' subdirectory. These demos can fail if the machines serving the remote data access URLs are unavailable. A gallery of these demos is visible on github.
• Contributed demos that display additional or specialized functionality are in the demos/contrib directory. Some of these depend on accessing remote sites for data that can be less reliable than the data URLs in the 'demos' directory.

Documentation

• We are migrating the documentation from the GoogleCode nctoolbox documentation to the Github nctoolbox documentation.
• Descriptions of the nctoolbox classes are available as NctoolboxClasses.
• This repository includes a number of useful utility functions.
• The wiki includes documentation on using ncdataset and using ncgeodataset.
• Several of the demos are rendered in the demos gallery.

Citing

If you use nctoolbox for your research please kindly consider adding a reference for it to your work/paper/etc. The formal citation for this project varies depending on your publisher, but it will be something like:

B. Schlining, R. Signell, A. Crosby, nctoolbox (2009), Github repository, 
    https://github.com/nctoolbox/nctoolbox