Ncarray Toolkit - ncArray

V = ncArray(filename, varname)

V = ncArray(filename, varname, propertyname, propertyvalue, …)

Create a ncArray that can be accessed as a normal array.

Inputs

filename - filename to read

varname - variable name to read from file

propertyname, propertyvalue - property name and value pairs.

Outputs

V - a ncArray of the read file.

For read access filename can be compressed if it has the extensions ".gz" or ".bz2". It use the function cache_decompress to cache to decompressed files.

Data is loaded by ncread and saved by ncwrite. Values equal to _FillValue are thus replaced by NaN and the scaling (add_offset and scale_factor) is applied during loading and saving.

Example

Loading the variable (assuming V is 3 dimensional):

 x = V(1,1,1);   % load element 1,1,1
 x = V(:,:,:);   % load the complete array
 x = V();  x = full(V)  % loads also the complete array
 

Saving data in the netcdf file:

 V(1,1,1) = x;   % save x in element 1,1,1
 V(:,:,:) = x;
 

Attributes

 units = V.units; % get attribute called "units"
 V.units = 'degree C'; % set attributes;
 

Note: use the ’.()’ notation if the attribute has a leading underscore (due to a limitation in the matlab parser):

 V.('_someStrangeAttribute') = 123;
 

See also: cache_decompress, ncCatArray. Web: http://modb.oce.ulg.ac.be/mediawiki/index.php/ncArray