NCSAVE save data to NetCDF4 file

create or append to data file

parent folder (file directory) must already exist

Inputs

Inputs

filename: data filename
varname: variable name to save
A: data to write
opts.dims: name and size of dimensions
opts.type: class of variable e.g. int32, single

function ncsave(filename, varname, A, opts)
arguments
  filename (1,1) string
  varname (1,1) string
  A {mustBeNonempty}
  opts.dims cell = {}
  opts.type (1,1) string = ""
  opts.compressLevel (1,1) double {mustBeInteger,mustBeNonnegative} = 0
end

if isnumeric(A)
  mustBeReal(A)
end

% coerce if needed
A = coerce_ds(A, opts.type);

if isscalar(A)
  sizeA = 1;
else
  if isempty(opts.dims)
    error("For non-scalar NetCDF variables, the dimenions must be defined as a cell array")
  end
  for i = 2:2:length(opts.dims)
    sizeA(i/2) = opts.dims{i}; %#ok<AGROW>
  end
end

try
  ncsave_exist(filename, varname, A, sizeA)
catch e
  switch e.identifier
    case {'MATLAB:imagesci:netcdf:unableToOpenFileforRead', 'MATLAB:imagesci:netcdf:unknownLocation'}
      ncsave_new(filename, varname, A, sizeA, opts.dims, opts.compressLevel)
    otherwise, rethrow(e)
  end
end

end

NCSAVE save data to NetCDF4 file

Contents

Inputs