     [file version.texi not included]
     [file macros.texi not included]

Introduction
************

The Octave NetCDF toolkit is a set of NetCDF routines for GNU Octave

Installing and loading
**********************

The toolkit must be installed and then loaded to be used.

It can be installed in GNU Octave directly from the website, or can be installed in an off-line mode via a downloaded tarball.

The toolkit has a dependency on the netcdf library (https://www.unidata.ucar.edu/software/netcdf/), so it must be installed in order to successfully install the toolkit.

The toolkit must be then be loaded once per each GNU Octave session in order to use its functionality.

Online Direct install
=====================

With an internet connection available, the package can be installed from octave-forge using the following command within GNU Octave:

     pkg install -forge netcdf

The latest released version of the toolkit will be downloaded and installed.

Off-line install
================

With the toolkit package already downloaded, and in the current directory when running GNU Octave, the package can be installed using the following command within GNU Octave:

     pkg install netcdf-VERSION.tar.gz

Loading
=======

Regardless of the method of installing the toolkit, in order to use its functions, the toolkit must be loaded using the pkg load command:

     pkg load netcdf

The toolkit must be loaded on each GNU Octave session.

Basic Usage Overview
********************

The toolkit provides high and level functionality for reading and writing NetCDF format files.

High level functionality
========================

The toolkit provides the following high level functions:

  * nccreate

  * ncdisp

  * ncinfo

  * ncreadatt

  * ncread

  * ncwriteatt

  * ncwrite

  * ncwriteschema

Low level functionality
=======================

The package aims to implement the netcdf interface of MATLAB in GNU Octave, however GNU Octave does not support the import function.

Functions can be used in netcdf_functionname format, or an emulated import can be done using the import_netcdf script so that functions can be used in netcdf.functionname format.

Function Reference
******************

The functions currently available in the toolkit are described below;

     [file functions.texi not included]

     [file gpl.texi not included]