blosc2decode.m

function varargout = blosc2decode(varargin)
%
% output = blosc2decode(input,codec)
% output = blosc2decode(input)
%    or
% output = blosc2decode(input,info)
%
% Decompressing an blosc2-compressed byte-stream to recover the original data
% This function depends on the ZMat toolbox (http://github.com/NeuroJSON/zmat)
%
% authors:Qianqian Fang (q.fang <at> neu.edu)
%
% input:
%      input: a string, int8/uint8 vector or numerical array to store blosc2-compressed data
%      codec: if the 2nd input is a string, it is treated as a compression method that
%           blosc2 supports, it can be one of:
%            'blosc2blosclz', 'blosc2lz4', 'blosc2lz4hc', 'blosc2zlib' and 'blosc2zstd'
%           if no codec is specified, 'blosc2blosclz' method is assumed
%      info (optional): a struct produced by the zmat/blosc2encode function during
%            compression; if not given, the inputs/outputs will be treated as a
%            1-D vector
%
% output:
%      output: the decompressed byte stream stored in a uint8 vector; if info is
%            given, output will restore the original data's type and dimensions
%
% examples:
%      [bytes, info]=blosc2encode(eye(10));
%      orig=blosc2decode(bytes,info);
%
% license:
%     BSD or GPL version 3, see LICENSE_{BSD,GPLv3}.txt files for details
%
% -- this function is part of JSONLab toolbox (http://iso2mesh.sf.net/cgi-bin/index.cgi?jsonlab)
%

if (nargin == 0)
    error('you must provide at least 1 input');
end
if (exist('zmat', 'file') == 2 || exist('zmat', 'file') == 3)
    if (nargin >= 2 && ischar(varargin{2}))
        [varargout{1:nargout}] = zmat(varargin{1}, 0, varargin{2:end});
    elseif (nargin > 1)
        [varargout{1:nargout}] = zmat(varargin{1}, varargin{2:end});
    else
        [varargout{1:nargout}] = zmat(varargin{1}, 0, 'blosc2blosclz', varargin{2:end});
    end
else
    error('you must install ZMat toolbox to use this feature: http://github.com/NeuroJSON/zmat');
end