NCSAVE save data to NetCDF4 file

create or append to data file

parent folder (file directory) must already exist

Contents

Inputs

function ncsave(filename, varname, A, varargin)
% 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

p = inputParser;
addParameter(p, 'dims', {});
addParameter(p, 'type', '');
addParameter(p, 'compressLevel', 0, @(x) mustBeInteger(x) && mustBeNonnegative(x));
parse(p, varargin{:});

opts = p.Results;

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

Published with MATLAB® R2025a