function jnii=loadjnifti(filename, varargin)
%
% jnii=loadjnifti(inputfile)
% or
% jnii=loadjnifti(inputfile, 'Param1',value1, 'Param2',value2,...)
%
% Load a standard NIFTI-1/2 file or text or binary JNIfTI file with
% format defined in JNIfTI specification: https://github.com/fangq/jnifti
%
% author: Qianqian Fang (q.fang <at> neu.edu)
%
% input:
% inputfile: the output file name to the JNIfTI or NIFTI-1/2 file
% *.bnii for binary JNIfTI file
% *.jnii for text JNIfTI file
% *.nii for NIFTI-1/2 files
% options: (optional) if loading from a .bnii file, please see the options for
% loadubjson.m (part of JSONLab); if loading from a .jnii, please see the
% supported options for loadjson.m (part of JSONLab).
%
% output:
% jnii: a structure (array) or cell (array). The data structure can
% be completely generic or auxilary data without any JNIfTI
% constructs. However, if a JNIfTI object is included, it shall
% contain the below subfields (can appear within any depth of the
% structure)
% jnii.NIFTIHeader - a structure containing the 1-to-1 mapped NIFTI-1/2 header
% jnii.NIFTIData - the main image data array
% jnii.NIFTIExtension - a cell array contaiing the extension data buffers
%
% example:
% jnii=jnifticreate(uint8(magic(10)),'Name','10x10 magic matrix');
% savejnifti(jnii, 'magic10.jnii')
% newjnii=loadjnifti('magic10.jnii');
%
% this file is part of JNIfTI specification: https://github.com/fangq/jnifti
%
% License: Apache 2.0, see https://github.com/fangq/jnifti for details
%
if(nargin<1)
error('you must provide data and output file name');
end
if(~exist('savejson','file'))
error('you must first install JSONLab from http://github.com/fangq/jsonlab/');
end
if(regexp(filename,'\.nii$'))
jnii=nii2jnii(filename,'jnii');
elseif(regexp(filename,'\.jnii$'))
jnii=loadjson(filename,varargin{:});
elseif(regexp(filename,'\.bnii$'))
jnii=loadubjson(filename,varargin{:});
else
error('file suffix must be .jnii for text JNIfTI, .bnii for binary JNIfTI or .nii for NIFTI-1/2 files');
end
