source: aedes_readfid.m @ 85

Last change on this file since 85 was 85, checked in by tjniskan, 10 years ago
  • Fixed a small bug (that was introduced in the last commit) in

reading vnmrj EPI files

  • Finally remembered to add the new Aedes logo and the help about

dialog should now work...

AM aedes_logo.png
M aedes_readfid.m
M aedes_revision.m

File size: 50.9 KB
Line 
1function [DATA,msg_out] = aedes_readfid(filename,varargin)
2% AEDES_READFID - Read VNMR (Varian) FID-files
3%   
4%
5% Synopsis:
6%        [DATA,msg]=aedes_readfid(filename,'PropertyName1',value1,'PropertyName2',value2,...)
7%        [DATA,msg]=aedes_readfid(filename,'header')
8%        [DATA,msg]=aedes_readfid(filename,output_filename)
9%
10% Description:
11%        The function reads VNMR (Varian) FID-file and return a structure
12%        DATA with fields DataFormat, HDR, FTDATA, KSPACE, PROCPAR, and
13%        PHASETABLE. The fields of the DATA structure are constructed as
14%        follows:
15%       
16%        DATA
17%          |-> DataFormat         (string identifier for data format 'vnmr')
18%          |-> HDR
19%                |-> FileHeader   (data file header)
20%                |-> BlockHeaders (data block headers, not stored by default)
21%                |-> fname        (file name)
22%                |-> fpath        (file path)
23%                |-> Param        (parameter values used by AEDES_READFID to read the data)
24%          |-> FTDATA             (real fourier transformed image data)
25%          |-> KSPACE             (complex k-space, empty by default)
26%          |-> PROCPAR            (parameters from procpar file)
27%          |-> PHASETABLE         (phasetable)
28%
29%        The DATA structure is returned as empty (without HDR, FTDATA,
30%        KSPACE, and PROCPAR fields) if an error has occurred during
31%        reading. The error message is returned in the second output
32%        argument msg. If AEDES_READFID is called with only one output argument
33%        (i.e. without MSG), the error message is echoed to the workspace.
34%       
35%        The first input argument is either a string containing full path to
36%        the FID-file or the header structure HDR. Only the data file header
37%        can be read by giving a string 'header' as the second input
38%        argument.
39%
40%        By default the k-space is not returned, i.e. the field KSPACE is
41%        empty. The returned data can be adjusted by using the 'return'
42%        property and values 1, 2, or 3 (see below for more information).
43%
44%        The supported property-value pairs in AEDES_READFID (property strings
45%        are not case sensitive):
46%
47%        Property:        Value:                Description:
48%        *********        ******                ************
49%        'Return'      :  [ {1} | 2 | 3 | 4 ]   % 1=return only ftdata (default)
50%                                               % 2=return only k-space
51%                                               % 3=return both ftdata & kspace
52%                                               % 4=return raw kspace
53%
54%        'FastRead'    :  [{'off'} | 'on' ]     % Enables an experimental
55%                                               % method for very fast reading
56%                                               % of fid-files. This not as
57%                                               % robust as the older
58%                                               % method and can consume a lot
59%                                               % of memory.
60%
61%        'OutputFile'  :  filename              % Writes the slices into
62%                                               % NIfTI-format files
63%                                               % using the given filename.
64%
65%        'DCcorrection':  [ {'off'} | 'on' ]    % 'on'=use DC correction
66%                                               % 'off'=don't use DC correction
67%                                               % (default)
68%
69%        'Procpar'     :  (procpar-structure)   % Input procpar
70%                                               % structure. If this
71%                                               % property is not set the
72%                                               % procpar structure
73%                                               % will be read using
74%                                               % AEDES_READPROCPAR
75%
76%        'ZeroPadding' :  ['off'|'on'|{'auto'}] % 'off' = force
77%                                               % zeropadding off
78%                                               % 'on' = force
79%                                               % zeropadding on (force
80%                                               % images to be square)
81%                                               % 'auto' = autoselect
82%                                               % using relative FOV
83%                                               % dimensions (default)
84%
85%        'PhaseTable'  : (custom phase table)   % User-specified
86%                                               % line order for
87%                                               % k-space. The phase table
88%                                               % is obtained from the file
89%                                               % specified in
90%                                               % procpar.petable if
91%                                               % necessary.
92%
93%        'sorting'      : [ 'off' | {'on'} ]    % 'off' =disable k-space
94%                                               % sorting, i.e. ignore the
95%                                               % phase table and/or arrays.
96%                                               % 'on' =sort k-space using
97%                                               % phase table and/or array
98%                                               % information if necessary
99%                                               % (default)
100%
101%        'wbar'        : [ {'on'} | 'off' ]     % 'on'  = show waitbar
102%                                               % 'off' = don't show waitbar
103%
104%        'FlipKspace'  : [ {'off'} | 'LR' |
105%                             'UD' | 'LRUD' ]   % 'off' = don't flip (default)
106%                                               % 'LR' = left/right
107%                                               % 'UD' = up/down
108%                                               % 'LRUD' = left/right and
109%                                               % up/down
110%
111%        'FlipInd'     : [ {'all'} | 'alt' |
112%                          (custom vector)  ]   % 'all' = flip all slices
113%                                               % (default)
114%                                               % 'alt' = flip every
115%                                               % second slice
116%                                               % (custom vector) = A
117%                                               % custom vector containing
118%                                               % indices to the flipped slices
119%
120%        'Precision'   : ['single'|{'double'}]  % Precision of the
121%                                               % outputted data.
122%                                               % 'single' = 32-bit float
123%                                               % 'double' = 64-bit float
124%
125%        'OrientImages': [ {'on'} | 'off' ]     % Orient FTDATA after
126%                                               % reading the data using
127%                                               % PROCPAR.orient property.
128%
129%        'RemoveEPIphaseIm' : ['on'|{'off'}]    % Remove the phase image
130%                                               % from EPI data. This
131%                                               % option only affects EPI
132%                                               % images.
133%
134% Examples:
135%        [DATA,msg]=aedes_readfid(filename)             % Read image data from 'filename'
136%        [DATA,msg]=aedes_readfid(filename,'header')    % Read only data file header
137%
138%        [DATA,msg]=aedes_readfid(filename,'return',1)  % Return only image data (default)
139%        [DATA,msg]=aedes_readfid(filename,'return',2)  % Return only k-space
140%        [DATA,msg]=aedes_readfid(filename,'return',3)  % Return both image data and k-space
141%       
142%        % Read first data file header and then image data and k-space
143%        [DATA,msg]=aedes_readfid(filename,'header')
144%        [DATA,msg]=aedes_readfid(DATA.HDR,'return',3)
145%
146%        % Read VNMR-data with default options and save slices in NIfTI
147%        % format
148%        DATA=aedes_readfid('example.fid','saved_slices.nii');
149%
150%        % If you want to use non-default options and also write
151%        % NIfTI-files, use the property/value formalism, for example
152%        DATA=aedes_readfid('example.fid','ZeroPadding','off',...
153%                     'OutputFile','saved_slices.nii');
154%
155% See also:
156%        AEDES_READFIDPREFS, AEDES_READPROCPAR, AEDES_READPHASETABLE,
157%        AEDES_DATA_READ, AEDES_WRITE_NIFTI, AEDES
158
159% This function is a part of Aedes - A graphical tool for analyzing
160% medical images
161%
162% Copyright (C) 2006 Juha-Pekka Niskanen <Juha-Pekka.Niskanen@uku.fi>
163%
164% Department of Physics, Department of Neurobiology
165% University of Kuopio, FINLAND
166%
167% This program may be used under the terms of the GNU General Public
168% License version 2.0 as published by the Free Software Foundation
169% and appearing in the file LICENSE.TXT included in the packaging of
170% this program.
171%
172% This program is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
173% WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
174
175
176
177
178if nargout==2
179  Dat.ShowErrors = false;
180  msg_out='';
181else
182  Dat.ShowErrors = true;
183end
184
185%% ---------------------
186% Defaults
187Dat.ReturnKSpace  = false;
188Dat.ReturnFTData  = true;
189Dat.DCcorrection  = false;
190Dat.ZeroPadding = 2;
191Dat.Sorting = true;
192Dat.UsePhaseTable = true;
193Dat.FastDataRead = true;
194Dat.precision = 'single';
195
196
197%% Other defaults
198Dat.ShowWaitbar   = true;
199procpar=[];
200Dat.phasetable=[];
201Dat.FlipKspace = 0;
202Dat.FlipInd = 'all';
203Dat.OutputFile = false;
204Dat.ReturnRawKspace = false;
205Dat.ReorientEPI = false;
206Dat.RemoveEPIphaseIm = false;
207Dat.OrientImages = true;
208
209%% -------------------------------------------------------------------
210
211
212%% Set data format label
213DATA.DataFormat = 'vnmr';
214
215%% Parse input arguments
216if nargin==0 || isempty(filename)
217 
218  %% Get default directory
219  try
220    defaultdir = getpref('Aedes','GetDataFileDir');
221  catch
222    defaultdir = [pwd,filesep];
223  end
224 
225  %% If no input arguments are given, ask for a file
226  [f_name, f_path, f_index] = uigetfile( ...
227       {'fid;FID','Varian FID-files (fid)'; ...
228        '*.*', 'All Files (*.*)'}, ...
229        'Select VNMR (Varian) FID file',defaultdir);
230  if ( all(f_name==0) || all(f_path==0) ) % Cancel is pressed
231    DATA=[];
232    msg_out='Canceled';
233    return
234  end
235  ReadHdr = true;
236  ReadData = true;
237  filename=[f_path,f_name];
238 
239  %% Set default directory to preferences
240  setpref('Aedes','GetDataFileDir',f_path)
241 
242end
243
244if nargin==1
245  if isstruct(filename)
246    hdr = filename;
247    filename = [hdr.fpath,hdr.fname];
248    ReadHdr = false;
249    ReadData = true;
250% $$$     ReturnKSpace = false;
251% $$$     ReturnFTData = true;
252   
253  elseif ischar(filename)
254    ReadHdr = true;
255    ReadData = true;
256% $$$     ReturnKSpace = false;
257% $$$     ReturnFTData = true;
258  end
259elseif nargin==2
260  if strcmpi(varargin{1},'header')
261    ReadHdr = true;
262    ReadData = false;
263% $$$     ReturnKSpace = false;
264  elseif ischar(varargin{1})
265    ReadHdr = true;
266    ReadData = true;
267    Dat.OutputFile = varargin{1};
268  else
269    if ~Dat.ShowErrors
270      DATA=[];
271      msg_out=sprintf('Invalid second input argument "%s".',varargin{1});
272      return
273    else
274      error('Invalid second input argument "%s".',varargin{1})
275    end
276  end
277else
278  if isstruct(filename)
279    hdr = filename;
280    filename = [hdr.fpath,hdr.fname];
281    ReadHdr = false;
282    ReadData = true;
283  elseif isempty(filename)
284    [f_name, f_path, f_index] = uigetfile( ...
285        {'fid;FID','Varian FID-files (fid)'; ...
286         '*.*', 'All Files (*.*)'}, ...
287        'Select VNMR (Varian) FID file');
288    if ( all(f_name==0) || all(f_path==0) ) % Cancel is pressed
289      DATA=[];
290      msg_out='Canceled';
291      return
292    end
293    ReadHdr = true;
294    ReadData = true;
295    filename=[f_path,f_name];
296  else
297    ReadHdr = true;
298    ReadData = true;
299  end
300 
301  for ii=1:2:length(varargin)
302    switch lower(varargin{ii})
303     case 'return'
304      if length(varargin)<2
305        DATA=[];
306        if ~Dat.ShowErrors
307          msg_out='"Return" value not specified!';
308        else
309          error('"Return" value not specified!')
310        end
311        return
312      else
313        if varargin{ii+1}==1
314          Dat.ReturnKSpace = false;
315          Dat.ReturnFTData = true;
316        elseif varargin{ii+1}==2
317          Dat.ReturnKSpace = true;
318          Dat.ReturnFTData = false;
319        elseif varargin{ii+1}==3
320          Dat.ReturnKSpace = true;
321          Dat.ReturnFTData = true;
322                elseif varargin{ii+1}==4
323                  Dat.ReturnRawKspace = true;
324                  Dat.ReturnKSpace = true;
325          Dat.ReturnFTData = false;
326        end
327      end
328     
329     case {'dc','dccorrection','dccorr'}
330      if strcmpi(varargin{ii+1},'on')
331        Dat.DCcorrection = true;
332      else
333        Dat.DCcorrection = false;
334      end
335     
336     case 'procpar'
337      procpar=varargin{ii+1};
338     
339     case 'zeropadding'
340      if ischar(varargin{ii+1})
341        if strcmpi(varargin{ii+1},'on')
342          Dat.ZeroPadding = 1; % on
343        elseif strcmpi(varargin{ii+1},'off')
344          Dat.ZeroPadding = 0; % off
345        else
346          Dat.ZeroPadding = 2; % auto
347        end
348      else
349        % Undocumented
350        Dat.ZeroPadding = 3; % Custom
351        Dat.CustomZeroPadding = varargin{ii+1};
352      end
353     
354     case 'phasetable'
355      Dat.phasetable = varargin{ii+1};
356     
357     case 'sorting'
358          if strcmpi(varargin{ii+1},'on')
359        Dat.UsePhaseTable = true;
360        Dat.Sorting = true;
361      else
362        Dat.UsePhaseTable = false;
363        Dat.Sorting = false;
364          end
365     
366         case 'fastread'
367           if strcmpi(varargin{ii+1},'on')
368                 Dat.FastDataRead = true;
369           else
370                 Dat.FastDataRead = false;
371           end
372           
373     case 'wbar'
374      if strcmpi(varargin{ii+1},'on')
375        Dat.ShowWaitbar = 1;
376      else
377        Dat.ShowWaitbar = 0;
378          end
379         
380         case 'precision'
381           if strcmpi(varargin{ii+1},'single')
382                 Dat.precision = 'single';
383           end
384               
385          case 'flipkspace'
386       
387        flipkspace = varargin{ii+1};
388        if strcmpi(flipkspace,'off')
389          Dat.FlipKspace=0;
390        elseif strcmpi(flipkspace,'LR')
391          Dat.FlipKspace=1;
392        elseif strcmpi(flipkspace,'UD')
393          Dat.FlipKspace=2;
394        elseif strcmpi(flipkspace,'LRUD')
395          Dat.FlipKspace=3;
396        else
397          DATA=[];
398          if ~Dat.ShowErrors
399            msg_out = 'Bad value for property FlipKspace!';
400          else
401            error('Bad value for property FlipKspace!')
402          end
403          return
404        end
405       
406      case 'flipind'
407        Dat.FlipInd = varargin{ii+1};
408       
409      case 'outputfile'
410        Dat.OutputFile = varargin{ii+1};
411       
412      case 'reorientepi'
413        if strcmpi(varargin{ii+1},'on')
414          Dat.ReorientEPI = true;
415        end
416       
417      case 'removeepiphaseim'
418        if strcmpi(varargin{ii+1},'on')
419          Dat.RemoveEPIphaseIm = true;
420        end
421      case 'orientimages'
422        if strcmpi(varargin{ii+1},'off')
423          Dat.OrientImages = false;
424        end
425     otherwise
426      DATA=[];
427      if ~Dat.ShowErrors
428        msg_out = ['Unknown property "' varargin{ii} '"'];
429      else
430        error(['Unknown property "' varargin{ii} '"'])
431      end
432      return
433    end
434  end
435end
436
437% Parse filename
438[fpath,fname,fext]=fileparts(filename);
439if ~strcmpi(fname,'fid')
440  if isempty(fname)
441    fpath = [fpath,filesep];
442  else
443        if isempty(fpath)
444          fpath = [pwd,filesep,fname,fext,filesep];
445        else
446          fpath = [fpath,filesep,fname,fext,filesep];
447        end
448  end
449  fname = 'fid';
450else
451  fpath = [fpath,filesep];
452end
453
454%% Read procpar if not given as input argument
455if isempty(procpar) || nargin~=2
456  [procpar,proc_msg]=aedes_readprocpar([fpath,'procpar']);
457  if isempty(procpar)
458    DATA=[];
459    if ~Dat.ShowErrors
460      msg_out=proc_msg;
461    else
462      error(proc_msg)
463    end
464    return
465  end
466end
467
468%% Read phasetable if necessary
469if isfield(procpar,'petable') && isempty(Dat.phasetable) && ...
470    ~isempty(procpar.petable{1}) && ~strcmpi(procpar.petable{1},'n') && ...
471    Dat.Sorting
472  % Look in preferences for tablib-directory
473  try
474    tabpath = getpref('Aedes','TabLibDir');
475  catch
476    % If the table path was not found in preferences, try to use aedes
477    % directory
478    tmp_path = which('aedes');
479    if ~isempty(tmp_path)
480      aedes_path=fileparts(tmp_path);
481      tabpath = [aedes_path,filesep,'tablib',filesep];
482    else
483      % If all else fails, look in the current directory
484      tabpath = [pwd,filesep,'tablib',filesep];
485    end
486  end
487  [phasetable,msg] = aedes_readphasetable([tabpath,procpar.petable{1}]);
488 
489  % If petable cannot be found, check if it is in procpar...
490  if isempty(phasetable) && isfield(procpar,'pe_table')
491    phasetable = {'t1',procpar.pe_table(:)};
492  end
493 
494  % If the sequence is a fast spin echo, try to construct the phasetable
495  if isempty(phasetable) && isfield(procpar,'petable') && ...
496      strncmpi(procpar.petable{1},'fse',3)
497    phasetable = {'t1',l_CreateFsemsPhaseTable(procpar)};
498  end
499 
500  %% Abort and throw error if phasetable cannot be read and the FID-file
501  % has not been sorted
502  if isempty(phasetable) && ~isfield(procpar,'flash_converted')
503    DATA=[];
504    if ~Dat.ShowErrors
505      msg_out={['Could not find the required phase table "' ...
506                procpar.petable{1} '" in the following folders'],...
507               ['"' tabpath '".']};
508    else
509      error('Could not find the required phase table "%s" in %s',...
510            procpar.petable{1},tabpath)
511    end
512    return
513  elseif ( isempty(phasetable) && isfield(procpar,'flash_converted') ) || ...
514      ~Dat.UsePhaseTable
515    %% If the FID-file has been sorted, the reading can continue but
516    % throw a warning.
517    fprintf(1,'Warning: aedes_readfid: Could not find phasetable "%s" in "%s"!\n',procpar.petable{1},tabpath)
518    Dat.phasetable=[];
519  else
520    Dat.phasetable = phasetable{1,2};
521  end
522end
523
524% Convert phasetable indices to MATLAB indices
525if ~isempty(Dat.phasetable)
526  Dat.phasetable=Dat.phasetable+(-min(min(Dat.phasetable))+1);
527else
528  Dat.UsePhaseTable = false;
529end
530
531%% Open FID-file
532[file_fid,msg]=fopen([fpath,fname],'r','ieee-be');
533if file_fid < 0
534  DATA=[];
535  if ~Dat.ShowErrors
536    msg_out=['Could not open file "' filename '" for reading.'];
537  else
538    error('Could not open file "%s" for reading.',filename)
539  end
540  return
541end
542
543% Read only header
544if ReadHdr && ~ReadData
545  [hdr,msg_out]=l_ReadDataFileHeader(file_fid);
546  if ~isempty(msg_out)
547    DATA=[];
548    fclose(file_fid);
549    if Dat.ShowErrors
550      error(msg_out)
551    end
552    return
553  else
554    DATA.HDR.FileHeader = hdr.FileHeader;
555    DATA.FTDATA=[];
556    DATA.KSPACE=[];
557    DATA.PROCPAR=[];
558    DATA.PHASETABLE=[];
559  end
560elseif ~ReadHdr && ReadData % Header structure given as input argument
561                            % Read only data.
562  [hdr,data,kspace,msg_out]=l_ReadBlockData(file_fid,hdr,Dat,procpar);
563  if ~isempty(msg_out)
564    DATA=[];
565    fclose(file_fid);
566    if Dat.ShowErrors
567      error(msg_out)
568    end
569    return
570  else
571    DATA.HDR.FileHeader=hdr.FileHeader;
572    DATA.HDR.BlockHeaders = hdr.BlockHeaders;
573    DATA.FTDATA=data;
574    DATA.KSPACE=kspace;
575    DATA.PROCPAR=procpar;
576    DATA.PHASETABLE=Dat.phasetable;
577  end
578elseif ReadHdr && ReadData  % Read headers and data
579  [hdr,msg_out]=l_ReadDataFileHeader(file_fid);
580  [hdr,data,kspace,msg_out]=l_ReadBlockData(file_fid,hdr,Dat,procpar);
581  if ~isempty(msg_out)
582    DATA=[];
583    fclose(file_fid);
584    if Dat.ShowErrors
585      error(msg_out)
586    end
587    return
588  else
589    DATA.HDR.FileHeader=hdr.FileHeader;
590    DATA.HDR.BlockHeaders = hdr.BlockHeaders;
591    DATA.FTDATA=data;
592    DATA.KSPACE=kspace;
593    DATA.PROCPAR=procpar;
594    DATA.PHASETABLE=Dat.phasetable;
595  end
596end
597
598% Set file name and path to the HDR structure
599DATA.HDR.fname=fname;
600DATA.HDR.fpath=fpath;
601
602% Set parameter values
603DATA.HDR.Param.ReturnKSpace = Dat.ReturnKSpace;
604DATA.HDR.Param.ReturnFTData = Dat.ReturnFTData;
605if Dat.ZeroPadding==0
606  DATA.HDR.Param.ZeroPadding = 'off';
607elseif Dat.ZeroPadding==1
608  DATA.HDR.Param.ZeroPadding = 'on';
609else
610  DATA.HDR.Param.ZeroPadding = 'auto';
611end
612if ~Dat.DCcorrection
613  DATA.HDR.Param.DCcorrection = 'off';
614else
615  DATA.HDR.Param.DCcorrection = 'on';
616end
617if Dat.Sorting==0
618  DATA.HDR.Param.Sorting = 'off';
619else
620  DATA.HDR.Param.Sorting = 'on';
621end
622if Dat.FlipKspace==0
623  DATA.HDR.Param.FlipKspace = 'off';
624elseif Dat.FlipKspace==1
625  DATA.HDR.Param.FlipKspace = 'LR';
626elseif Dat.FlipKspace==2
627  DATA.HDR.Param.FlipKspace = 'UD';
628elseif Dat.FlipKspace==3
629  DATA.HDR.Param.FlipKspace = 'LRUD';
630end
631DATA.HDR.Param.FlipInd = Dat.FlipInd;
632
633
634% Close file
635fclose(file_fid);
636
637%% Write slices to NIfTI files
638if ischar(Dat.OutputFile)
639  if isempty(Dat.OutputFile)
640    [fp,fn,fe]=fileparts(DATA.HDR.fpath(1:end-1));
641    fprefix=fn;
642    niipath = [pwd,filesep];
643  else
644    [fp,fn,fe]=fileparts(Dat.OutputFile);
645    if strcmpi(fe,'.nii')
646      fprefix=fn;
647    else
648      fprefix=[fn,fe];
649    end
650    if isempty(fp)
651      niipath = [pwd,filesep];
652    else
653      niipath = [fp,filesep];
654    end
655  end
656 
657  % Create file names
658  filenames={};
659  for ii=1:size(DATA.FTDATA,3)
660    filenames{ii}=sprintf('%s%03d%s',[fprefix,'_'],ii,'.nii');
661  end
662  nFiles = length(filenames);
663   
664  h=aedes_wbar(0,sprintf('Saving slice 1/%d in NIfTI format...',nFiles));
665  for ii=1:nFiles
666    aedes_wbar(ii/nFiles,h,sprintf('Saving slice %d/%d in NIfTI format...',ii, ...
667                             nFiles))
668    [done,msg]=aedes_write_nifti(DATA.FTDATA(:,:,ii),...
669                           [niipath,filenames{ii}],'DataType','single',...
670                           'FileType',2);
671  end
672  delete(h)
673 
674  if ~done
675    warning('Error occurred while writing NIfTI-files. Could not write file(s)!')
676  end
677 
678end
679return
680
681%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
682% Read Data File (Main) Header
683%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
684function [hdr,msg_out]=l_ReadDataFileHeader(file_fid)
685
686msg_out='';
687%% Read Data File Header
688try
689  FH.nblocks = fread(file_fid,1,'long');   % Number of blocks in file
690  FH.ntraces = fread(file_fid,1,'long');   % Number of traces per block
691  FH.np = fread(file_fid,1,'long');        % Number of elements per trace
692  FH.ebytes = fread(file_fid,1,'long');    % Number of bytes per element
693  FH.tbytes = fread(file_fid,1,'long');    % Number of bytes per trace
694  FH.bbytes = fread(file_fid,1,'long');    % Number of bytes per block
695  FH.vers_id = fread(file_fid,1,'short');  % Software version, file_id status bits
696  FH.status = fread(file_fid,1,'short');   % Status of whole file
697  FH.nbheaders = fread(file_fid,1,'long'); % Number of block headers per block
698 
699  hdr.FileHeader = FH;
700 
701  %% Parse status bits
702  hdr.FileHeader.status=[];
703  tmp_str = {'S_DATA',...          % 0 = no data, 1 = data
704             'S_SPEC',...          % 0 = FID, 1 = spectrum
705             'S_32',...            % 0 = 16 bit, 1 = 32 bit integer
706             'S_FLOAT',...         % 0 = integer, 1 = floating point
707             'S_COMPLEX',...       % 0 = real, 1 = complex
708             'S_HYPERCOMPLEX',...  % 1 = hypercomplex
709             '',...                % Unused bit
710             'S_ACQPAR',...        % 0 = not Acqpar, 1 = Acqpar
711             'S_SECND',...         % 0 = first FT, 1 = second FT
712             'S_TRANSF',...        % 0 = regular, 1 = transposed
713             '',...                % Unused bit
714             'S_NP',...            % 1 = np dimension is active
715             'S_NF',...            % 1 = nf dimension is active
716             'S_NI',...            % 1 = ni dimension is active
717             'S_NI2',...           % 1 = ni2 dimension is active
718             ''...                 % Unused bit
719            };
720  status_bits = fliplr(double(dec2bin(FH.status,16))==49);
721  for ii=1:length(tmp_str)
722    if ~isempty(tmp_str{ii})
723      hdr.FileHeader.status.(tmp_str{ii}) = status_bits(ii);
724    end
725  end
726catch
727  hdr=[];
728  msg_out=['Error occurred while reading file header from "' filename '".'];
729  return
730end
731
732
733%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
734% Read Block Headers and Data
735%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
736function [hdr,data,kspace,msg_out]=l_ReadBlockData(file_fid,hdr,Dat,procpar)
737
738hdr.BlockHeaders = [];
739%hdr.HypercmplxBHeaders = [];
740data=[];
741kspace=[];
742count = [];
743msg_out='';
744
745if isfield(procpar,'seqcon')
746  seqcon=procpar.seqcon{1};
747else
748  seqcon='nnnnn';
749end
750
751%% Determine acquisition type from seqcon parameter
752if all(seqcon=='n')          % 1D spectroscopy
753  AcqType=1;
754elseif all(seqcon(4:5)=='n') % 2D imaging
755  AcqType=2;
756elseif seqcon(5)=='n'        % 3D imaging
757  AcqType=3;
758else                         % 4D imaging
759  AcqType=4;
760end
761
762%% Double-check that AcqType is not 1D spectral
763if isfield(procpar,'nv') && procpar.nv==0
764  AcqType=1;
765end
766
767%% Use some heuristical approach to "triple-check" that the data is not
768%  1D spectral
769if ~isempty(strfind(procpar.seqfil{1},'STEAM')) || ...
770      ~isempty(strfind(procpar.seqfil{1},'steam')) || ...
771      ~isempty(strfind(procpar.seqfil{1},'LASER')) || ...
772      ~isempty(strfind(procpar.seqfil{1},'laser')) || ...
773      ~isempty(strfind(procpar.seqfil{1},'PRESS')) || ...
774      ~isempty(strfind(procpar.seqfil{1},'press')) || ...
775      ~isempty(strfind(procpar.seqfil{1},'1PULSE')) || ...
776      ~isempty(strfind(procpar.seqfil{1},'1pulse')) || ...
777      ~isempty(strfind(procpar.seqfil{1},'2PULSE')) || ...
778      ~isempty(strfind(procpar.seqfil{1},'2pulse'))
779  AcqType=1;
780end
781
782UsePhaseTable=Dat.UsePhaseTable;
783
784
785%% If the data has been converted with flashc, the seqcon parameter needs
786% to be changed
787if isfield(procpar,'flash_converted')
788  if isfield(procpar,'ni') && procpar.ni>1
789    seqcon(3)='s';
790  elseif ((seqcon(2)=='c') && (seqcon(3)=='c'))
791    seqcon(2)='s';
792  end
793  UsePhaseTable=false; % Do not try to order data if flashc has been run
794end
795
796%% Set number of transients
797if ~isfield(procpar,'nt')
798  nt=1;
799else
800  nt=procpar.nt;
801end
802
803%% Determine if the arrayed acquisition was used
804if isfield(procpar,'array') && ~isempty(procpar.array{1})
805 
806  if length(procpar.array)==1 && ~iscell(procpar.array{1}) && ...
807      strcmp(procpar.array{1},'pad') && all(procpar.pad==0)
808    % Skip the array parsing if the array is a dummy "pad"-array...
809    isAcqArrayed = false;
810    ArrayLength = 1;
811  else
812    isAcqArrayed = true;
813    ArrayLength = [];
814   
815    % Determine array length
816    for ii=1:length(procpar.array)
817      if iscell(procpar.array{ii})
818        ArrayLength(ii) = length(procpar.(procpar.array{ii}{1}));
819      else
820        ArrayLength(ii) = length(procpar.(procpar.array{ii}));
821      end
822    end
823    ArrayLength = prod(ArrayLength);
824  end
825else
826  isAcqArrayed = false;
827  ArrayLength = 1;
828end
829
830%% Determine if the data is EPI data
831if ( isfield(procpar,'readres') && isfield(procpar,'phaseres') ) || ...
832    ( isfield(procpar,'apptype') && strcmp(procpar.apptype{1},'imEPI') )
833  Dat.isEPIdata = true;
834else
835  Dat.isEPIdata = false;
836end
837
838BlockHeadStatusLabels = {'S_DATA',...       % 0 = no data, 1 = data
839                    'S_SPEC',...          % 0 = FID, 1 = spectrum
840                    'S_32',...            % 0 = 16 bit, 1 = 32 bit integer
841                    'S_FLOAT',...         % 0 = integer, 1 = floating point
842                    'S_COMPLEX',...       % 0 = real, 1 = complex
843                    'S_HYPERCOMPLEX',...  % 1 = hypercomplex
844                    '',...                % Unused bit
845                    'MORE_BLOCKS',...     % 0 = absent, 1 = present
846                    'NP_CMPLX',...        % 0 = real, 1 = complex
847                    'NF_CMPLX',...        % 0 = real, 1 = complex
848                    'NI_CMPLX',...        % 0 = real, 1 = complex
849                    'NI2_CMPLX',...       % 0 = real, 1 = complex
850                    '',...                % Unused bit
851                    '',...                % Unused bit
852                    '',...                % Unuesd bit
853                    ''...                 % Unused bit
854                   };
855
856BlockHeadModeLabels = {'NP_PHMODE',...   % 1 = ph mode
857                    'NP_AVMODE',...    % 1 = av mode
858                    'NP_PWRMODE',...   % 1 = pwr mode
859                    '',...             % Unused bit
860                    'NF_PHMODE',...    % 1 = ph mode
861                    'NF_AVMODE',...    % 1 = av mode
862                    'NF_PWRMODE',...   % 1 = pwr mode
863                    '',...             % Unused bit
864                    'NI_PHMODE',...    % 1 = ph mode
865                    'NI_AVMODE',...    % 1 = av mode
866                    'NI_PWRMODE',...   % 1 = pwr mode
867                    '',...             % Unused bit
868                    'NI2_PHMODE',...   % 1 = ph mode
869                    'NI2_AVMODE',...   % 1 = av mode
870                    'NI2_PWRMODE',...  % 1 = pwr mode
871                    ''...              % Unused bit
872                   };
873
874
875% The nbheaders -field is not correct in some cases. Thus, this field
876% cannot be trusted and the real nbheaders has to be calculated from the
877% byte counts.
878tmp_bytes=hdr.FileHeader.bbytes-hdr.FileHeader.tbytes*hdr.FileHeader.ntraces;
879header_bytes=28;
880if rem(tmp_bytes,header_bytes)~=0
881  msg_out = 'Block header byte count does not match with file header';
882  return
883else
884  nbheaders = tmp_bytes/28;
885end
886%nbheaders = hdr.FileHeader.nbheaders;
887
888%% Allocate space for k-space
889% kspace=zeros(hdr.FileHeader.np/2,...
890%              hdr.FileHeader.ntraces,hdr.FileHeader.nblocks);
891
892if ~Dat.FastDataRead
893  if any(AcqType==[1 2])
894    switch seqcon(2:3)
895      case {'cc','sc'}
896        kspace = zeros(hdr.FileHeader.np/2,...
897          hdr.FileHeader.ntraces,...
898          hdr.FileHeader.nblocks,Dat.precision);
899      otherwise
900        kspace = zeros(hdr.FileHeader.np/2,...
901          hdr.FileHeader.nblocks,...
902          hdr.FileHeader.ntraces,Dat.precision);
903    end
904  else
905    kspace = zeros(hdr.FileHeader.np/2,...
906      hdr.FileHeader.ntraces,...
907      hdr.FileHeader.nblocks,Dat.precision);
908  end
909else
910  kspace = [];
911end
912
913%% - The older robust (but also slower) way for reading the data.
914%% When the blocksize is relatively small, this is also quite fast.
915if ~Dat.FastDataRead
916
917  % Initialize waitbar
918  if Dat.ShowWaitbar
919        wb_h = aedes_wbar(0/hdr.FileHeader.nblocks,...
920          {['Reading ',num2str(AcqType),'D VNMR data (seqcon: "' seqcon '")'],...
921          ['(Processing data block ' ...
922          num2str(0) '/' num2str(hdr.FileHeader.nblocks) ')']});
923  end
924
925  %% Read data and block headers
926  for ii=1:hdr.FileHeader.nblocks
927        %% Update waitbar
928        if Dat.ShowWaitbar
929          aedes_wbar(ii/hdr.FileHeader.nblocks,...
930                wb_h,...
931                {['Reading ',num2str(AcqType),'D VNMR data (seqcon: "' seqcon '")'],...
932                ['(Processing data block ' ...
933                num2str(ii) '/' num2str(hdr.FileHeader.nblocks) ')']})
934        end
935
936        %% Read block header and hypercomplex header
937        for kk=1:nbheaders
938          %% Read block header
939          if kk==1
940                hdr.BlockHeaders.scale = fread(file_fid,1,'short');  % Scaling factor
941                tmp_status = fread(file_fid,1,'short'); % Status of data in block
942                hdr.BlockHeaders.status = [];
943                hdr.BlockHeaders.index = fread(file_fid,1,'short');  % Block index
944                tmp_mode = fread(file_fid,1,'short');   % Mode of data in block
945                hdr.BlockHeaders.mode = [];
946                hdr.BlockHeaders.ctcount = fread(file_fid,1,'long'); % ct value for FID
947                hdr.BlockHeaders.lpval = fread(file_fid,1,'float');  % f2 (2D-f1) left phase in phasefile
948                hdr.BlockHeaders.rpval = fread(file_fid,1,'float');  % f2 (2D-f1) right phase in phasefile
949                hdr.BlockHeaders.lvl = fread(file_fid,1,'float');    % level drift correction
950                hdr.BlockHeaders.tlt = fread(file_fid,1,'float');    % tilt drift correction
951
952                %% Parse status and mode bits
953                status_bits = fliplr(double(dec2bin(tmp_status,16))==49);
954                mode_bits = fliplr(double(dec2bin(tmp_mode,16))==49);
955                for tt=1:length(BlockHeadStatusLabels)
956                  if ~isempty(BlockHeadStatusLabels{tt})
957                        hdr.BlockHeaders.status.(BlockHeadStatusLabels{tt}) = status_bits(tt);
958                  end
959                  if ~isempty(BlockHeadModeLabels{tt})
960                        hdr.BlockHeaders.mode.(BlockHeadModeLabels{tt}) = mode_bits(tt);
961                  end
962                end
963
964
965          else %% Read hypercomplex header
966                fread(file_fid,1,'short'); % Spare
967                hdr.BlockHeaders.HCHstatus = fread(file_fid,1,'short');
968                fread(file_fid,1,'short'); % Spare
969                fread(file_fid,1,'short'); % Spare
970                fread(file_fid,1,'long'); % Spare
971                hdr.BlockHeaders.HCHlpval1 = fread(file_fid,1,'float');
972                hdr.BlockHeaders.HCHrpval1 = fread(file_fid,1,'float');
973                fread(file_fid,1,'float'); % Spare
974                fread(file_fid,1,'float'); % Spare
975          end
976        end
977       
978        %% Check block index to be sure about the data type
979        if hdr.BlockHeaders.index~=ii
980          fprintf(1,'Warning: Index mismatch in "%s" block %d\n',fopen(file_fid),ii);
981         
982          % Use information from the file header instead of the BlockHeader if
983          % there is a mismatch in blockheader index...
984          useFileHeader = true;
985        else
986          useFileHeader = false;
987        end
988       
989        %% Determine data precision
990        if useFileHeader
991          if hdr.FileHeader.status.S_FLOAT==1
992                prec_str = ['single=>',Dat.precision];
993          elseif hdr.FileHeader.status.S_32==1 ...
994                  && hdr.FileHeader.status.S_FLOAT==0
995                prec_str = ['int32=>',Dat.precision];
996          elseif hdr.FileHeader.status.S_32==0 ...
997                  && hdr.FileHeader.status.S_FLOAT==0
998                prec_str = ['int16=>',Dat.precision];
999          end
1000         
1001        else
1002          if hdr.BlockHeaders.status.S_FLOAT==1
1003                prec_str = ['single=>',Dat.precision];
1004          elseif hdr.BlockHeaders.status.S_32==1 ...
1005                  && hdr.BlockHeaders.status.S_FLOAT==0
1006                prec_str = ['int32=>',Dat.precision];
1007          elseif hdr.BlockHeaders.status.S_32==0 ...
1008                  && hdr.BlockHeaders.status.S_FLOAT==0
1009                prec_str = ['int16=>',Dat.precision];
1010          end
1011        end
1012
1013        % Read k-space
1014        tmp=fread(file_fid,...
1015          [hdr.FileHeader.np,hdr.FileHeader.ntraces],...
1016          prec_str);
1017
1018
1019        % Store complex block and perform DC correction
1020        if ~Dat.DCcorrection || ( nt(1)>1 )
1021          complex_block = complex(tmp(1:2:end,:),tmp(2:2:end,:));
1022        else
1023          complex_block = complex(tmp(1:2:end,:)-hdr.BlockHeaders.lvl,...
1024                tmp(2:2:end,:)-hdr.BlockHeaders.tlt);
1025        end
1026
1027
1028        %% Store and order k-space values
1029        if any(AcqType==[1 2])
1030          switch seqcon(2:3)
1031                case {'cc','sc'}
1032                  kspace(:,:,ii) = complex_block;
1033                otherwise
1034                  kspace(:,ii,:) = complex_block;
1035          end
1036        else
1037          kspace(:,:,ii) = complex_block;
1038        end
1039
1040        % Do not save blockheaders by default. When reading data files with a lot of
1041        % blocks (e.g. over 1000) the processing of the DATA structure can be
1042        % slowed down considerably. If you for some reason want to save also the
1043        % block headers in the DATA structure comment out the code line below.
1044        hdr.BlockHeaders = [];
1045  end % for ii=1:hdr.
1046
1047  if Dat.ShowWaitbar
1048        delete(wb_h)
1049  end
1050 
1051else
1052  %% -------------------------------------------------------------------
1053  %% Fast Method for reading data. This may fail with some datas and can
1054  %% also require a relatively large amount of memory. This
1055  %% method should be used for EPI datas that contain a large number
1056  %% of block headers...
1057 
1058  % Initialize waitbar
1059  if Dat.ShowWaitbar
1060        wb_h = aedes_calc_wait(['Reading ',num2str(AcqType),...
1061          'D VNMR data (seqcon: "' seqcon '")']);
1062  end
1063 
1064  % The first block header is read and it is assumed that the values in
1065  % the other block headers don't change. 
1066  hdr.BlockHeaders.scale = fread(file_fid,1,'short');  % Scaling factor
1067  tmp_status = fread(file_fid,1,'short'); % Status of data in block
1068  hdr.BlockHeaders.status = [];
1069  hdr.BlockHeaders.index = fread(file_fid,1,'short');  % Block index
1070  tmp_mode = fread(file_fid,1,'short');   % Mode of data in block
1071  hdr.BlockHeaders.mode = [];
1072  hdr.BlockHeaders.ctcount = fread(file_fid,1,'long'); % ct value for FID
1073  hdr.BlockHeaders.lpval = fread(file_fid,1,'float');  % f2 (2D-f1) left phase in phasefile
1074  hdr.BlockHeaders.rpval = fread(file_fid,1,'float');  % f2 (2D-f1) right phase in phasefile
1075  hdr.BlockHeaders.lvl = fread(file_fid,1,'float');    % level drift correction
1076  hdr.BlockHeaders.tlt = fread(file_fid,1,'float');    % tilt drift correction
1077 
1078  %% Parse status and mode bits
1079  status_bits = fliplr(double(dec2bin(tmp_status,16))==49);
1080  mode_bits = fliplr(double(dec2bin(tmp_mode,16))==49);
1081  for tt=1:length(BlockHeadStatusLabels)
1082    if ~isempty(BlockHeadStatusLabels{tt})
1083      hdr.BlockHeaders.status.(BlockHeadStatusLabels{tt}) = status_bits(tt);
1084    end
1085    if ~isempty(BlockHeadModeLabels{tt})
1086      hdr.BlockHeaders.mode.(BlockHeadModeLabels{tt}) = mode_bits(tt);
1087    end
1088  end
1089 
1090  %% Determine data precision
1091  if hdr.BlockHeaders.status.S_FLOAT==1
1092    prec_str = ['single=>',Dat.precision];
1093    prec = 4; % Precision in bytes
1094  elseif hdr.BlockHeaders.status.S_32==1 ...
1095      && hdr.BlockHeaders.status.S_FLOAT==0
1096    prec_str = ['int32=>',Dat.precision];
1097    prec = 4;
1098  elseif hdr.BlockHeaders.status.S_32==0 ...
1099      && hdr.BlockHeaders.status.S_FLOAT==0
1100    prec_str = ['int16=>',Dat.precision];
1101    prec = 2;
1102  end
1103 
1104  % Seek the file back to the beginning of the first block header
1105  fseek(file_fid,-28,0);
1106 
1107  % Determine the number of values that will result from block header(s)
1108  nVals = (nbheaders*28)/prec;
1109 
1110  % Read the whole data including block headers etc...
1111  kspace = fread(file_fid,inf,prec_str);
1112  kspace=reshape(kspace,nVals+hdr.FileHeader.np*hdr.FileHeader.ntraces,[]);
1113 
1114  % Remove block headers from the data
1115  kspace=kspace(nVals+1:end,:);
1116 
1117  % Transform to complex values
1118  kspace = reshape(kspace,hdr.FileHeader.np,...
1119        hdr.FileHeader.ntraces,hdr.FileHeader.nblocks);
1120 
1121  % Do DC-correction if necessary
1122  if ~Dat.DCcorrection || ( nt(1)>1 )
1123    kspace=complex(kspace(1:2:end,:,:),kspace(2:2:end,:,:));
1124  else
1125    kspace=complex(kspace(1:2:end,:,:)-hdr.BlockHeaders.lvl,...
1126      kspace(2:2:end,:,:)-hdr.BlockHeaders.tlt);
1127  end
1128 
1129  %% Store and order k-space values
1130  if any(AcqType==[1 2])
1131    switch seqcon(2:3)
1132      case {'cc','sc'}
1133        %kspace(:,:,ii) = complex_block;
1134      otherwise
1135        %kspace(:,ii,:) = complex_block;
1136        kspace = permute(kspace,[1 3 2]);
1137    end
1138  else
1139    %kspace(:,:,ii) = complex_block;
1140  end
1141 
1142  if Dat.ShowWaitbar
1143        delete(wb_h)
1144  end
1145 
1146end
1147
1148
1149% Remove singleton dimensions from kspace
1150kspace = squeeze(kspace);
1151
1152% Check if raw kspace should be returned
1153if Dat.ReturnRawKspace
1154  %% Delete waitbar
1155  if Dat.ShowWaitbar && ishandle(wb_h)
1156        delete(wb_h)
1157  end
1158  return
1159end
1160
1161%% Support for fat/water measurements ----------------------
1162if isfield(procpar,'seqfil') && strcmpi(procpar.seqfil,'ge3d_csi2')
1163 
1164  % Split kspace into fat and water (in 4th dimesion)
1165  kspace=reshape(permute(reshape(kspace,256,2,[]),[1 3 4 2]),256,128,[],2);
1166 
1167  % Fourier transform data
1168  if any(Dat.ZeroPadding==[1 2])
1169    data_sz = [procpar.np/2,procpar.nf,procpar.nv2,2];
1170    data = zeros(data_sz,class(kspace));
1171    data(:,:,:,1) = abs(fftshift(fftn(kspace(:,:,:,1),data_sz(1:3))));
1172    data(:,:,:,2) = abs(fftshift(fftn(kspace(:,:,:,2),data_sz(1:3))));
1173  else
1174    data = zeros(size(kspace),class(kspace));
1175    data(:,:,:,1) = abs(fftshift(fftn(kspace(:,:,:,1))));
1176    data(:,:,:,2) = abs(fftshift(fftn(kspace(:,:,:,2))));
1177  end
1178 
1179  % Delete kspace if not returned
1180  if ~Dat.ReturnKSpace
1181    kspace=[];
1182  end
1183 
1184  return
1185end
1186
1187%% Support for RASER sequence ---------------------------
1188if isfield(procpar,'teType')
1189 
1190  if strcmpi(procpar.sing_sh,'y') && strcmpi(procpar.teType,'c')
1191       
1192    % Separate reference scans from the data
1193    if isfield(procpar,'refscan') && strcmp(procpar.refscan,'y')
1194      kspace=permute(reshape(kspace,procpar.np/2,procpar.ne/2,2,[]),[1 2 4 3]);
1195      noise = kspace(:,:,:,1);
1196      kspace = kspace(:,:,:,2);
1197      % DC-correction
1198      dc_level = squeeze(mean(mean(noise)));
1199      for ii=1:size(kspace,3)
1200        kspace(:,:,ii)=kspace(:,:,ii)-dc_level(ii);
1201      end
1202    end
1203   
1204    if strcmpi(procpar.readType,'s')
1205      sw = procpar.sw;
1206      dwell = cumsum(ones(1,size(kspace,1))*(1/sw));
1207    else
1208      error('This feature has not been implemented yet!!!')
1209    end
1210    dwell = dwell*1000;
1211    %kspace = permute(kspace,[2 1 3]);
1212   
1213   
1214   
1215    % Phase correction
1216    dims = size(kspace);
1217    nI = size(kspace,3);
1218    nv = size(kspace,4);
1219    ne = size(kspace,2);
1220    np = size(kspace,1);
1221    g = 42.58;
1222    G = procpar.gvox2;
1223    Ds = procpar.vox2/100;
1224    pos2 = procpar.pos2/10;
1225    fudge = 0;
1226    fudge2 = 1;
1227   
1228    tt_dwell=repmat(dwell(:),1,ne);
1229    tt_ne = repmat((1:ne),length(dwell),1);
1230    tt_np = repmat((1:np)',1,ne);
1231   
1232    i=sqrt(-1);
1233    phi = (-2.*pi.*g.*G.*Ds.*tt_dwell.*(tt_ne./ne - 1/2 - pos2/Ds))+fudge.*tt_np;
1234    phi = repmat(phi,[1,1,size(kspace,3)]);
1235    kspace = abs(kspace).*exp(i*(angle(kspace)+phi));
1236   
1237    % Flip every other column
1238    sz(1)=size(kspace,1);
1239    sz(2)=size(kspace,2);
1240    sz(3)=size(kspace,3);
1241    sz(4)=size(kspace,4);
1242    kspace=reshape(kspace,sz(1),prod(sz(2:4)));
1243    kspace(:,1:2:end) = flipud(kspace(:,1:2:end));
1244    kspace = reshape(kspace,sz);
1245   
1246    %kspace = reshape(permute(kspace,[2 1 3]),sz(2),[],1);
1247    %kspace(:,1:2:end) = flipud(kspace(:,1:2:end));
1248    %kspace=permute(reshape(kspace,sz(2),[],sz(3)),[2 1 3]);
1249   
1250  else
1251    data = [];
1252    error('RASER sequence of this type has not been implemeted yet!')
1253  end
1254 
1255  % Reshape into 4D matrix
1256  kspace = reshape(kspace,size(kspace,1),size(kspace,2),[],size(kspace,3));
1257 
1258  % Reorient if requested
1259  if Dat.OrientImages
1260    kspace = flipdim(kspace,2);
1261  end
1262 
1263  data = abs(fftshift(fft(fftshift(fft(kspace,[],3),3),[],1),1));
1264 
1265  % Delete kspace if not returned
1266  if ~Dat.ReturnKSpace
1267    kspace=[];
1268  end
1269 
1270  return
1271 
1272end
1273
1274%% ------------------------------------------------------
1275
1276%% Flip images for certain measurements
1277if Dat.FlipKspace~=0
1278  if ischar(Dat.FlipInd)
1279    if strcmpi(Dat.FlipInd,'all')
1280      flipind = 1:size(kspace,3);
1281    elseif strcmpi(Dat.FlipInd,'alt')
1282      flipind = 2:2:size(kspace,3);
1283    end
1284  else
1285    flipind = Dat.FlipInd;
1286  end
1287 
1288  for ii=flipind
1289    if Dat.FlipKspace==1
1290      kspace(:,:,ii)=fliplr(kspace(:,:,ii));
1291    elseif Dat.FlipKspace==2
1292      kspace(:,:,ii)=flipud(kspace(:,:,ii));
1293    else
1294      kspace(:,:,ii)=flipud(fliplr(kspace(:,:,ii)));
1295    end
1296  end
1297end
1298
1299% Handle arrayed and RARE sequences
1300if isAcqArrayed && AcqType~=1 && Dat.Sorting && ~Dat.isEPIdata
1301  %if ~strcmpi(seqcon(2:3),'cc') && ( isempty(Dat.phasetable) | ...
1302  %        isfield(procpar,'flash_converted') )
1303  if (( isempty(Dat.phasetable) && ~strcmpi(seqcon(2:3),'sc') ) && ...
1304      ~(strcmpi(seqcon(2:3),'cc') && ArrayLength==size(kspace,3))) || ...
1305      isfield(procpar,'flash_converted')
1306                                 
1307    % Sort uncompressed arrayed data
1308    ks_order = 1:procpar.nv*ArrayLength;
1309    tmp = 0:procpar.nv:(procpar.ne-1)*procpar.nv;
1310    tmp=repmat(tmp,procpar.nv*ArrayLength,1);
1311    ks_order = reshape(ks_order,ArrayLength,procpar.nv).';
1312    ks_order = ks_order(:);
1313    ks_order = repmat(ks_order,1,procpar.ne);
1314    ks_order = ks_order+tmp;
1315    ks_order = ks_order.';
1316   
1317    if procpar.ns==1
1318      kspace=kspace(:,ks_order);
1319    else
1320      kspace = kspace(:,ks_order,:);
1321    end
1322   
1323    % Reshape into 3D matrix
1324    kspace=reshape(kspace,[size(kspace,1) procpar.nv ArrayLength* ...
1325                        procpar.ns]);
1326  else
1327    %% Sort RARE type data
1328    if UsePhaseTable && ~isempty(Dat.phasetable)
1329      Dat.phasetable = Dat.phasetable';
1330      kspace(:,Dat.phasetable(:),:) = kspace;
1331    end
1332  end
1333elseif Dat.isEPIdata
1334  %% Support for EPI-measurements
1335 
1336 
1337  % EPI data is measured with old VNMR
1338  if isfield(procpar,'readres') && isfield(procpar,'phaseres')
1339   
1340    % Number of slices
1341    tmp_ns=length(procpar.pss);
1342   
1343    if isfield(procpar,'navecho') && strcmpi(procpar.navecho{1},'y')
1344      tmp_nv = procpar.nv-procpar.nseg;
1345    else
1346      tmp_nv = procpar.nv;
1347    end
1348    kspace = reshape(kspace,[size(kspace,1) ...
1349      size(kspace,2)/tmp_nv tmp_nv]);
1350    kspace = permute(kspace,[1 3 2]);
1351   
1352    % Reshape to 4D matrix
1353    kspace = reshape(kspace,[size(kspace,1) size(kspace,2) ...
1354      tmp_ns size(kspace,3)/tmp_ns]);
1355   
1356   
1357  elseif isfield(procpar,'apptype') && strcmp(procpar.apptype{1},'imEPI')
1358    % If EPI data is measured with new VNMRj system
1359   
1360    % Number of slices
1361    ns = length(procpar.pss);
1362   
1363    % Reshape kspace to 4D matrix
1364    kspace = reshape(kspace,procpar.np/2,procpar.nv,...
1365      ns,[]);
1366   
1367    % Flip even kspace lines
1368    if ~Dat.FastDataRead
1369      for tt=2:2:size(kspace,2)
1370        kspace(:,tt,:,:) = flipdim(kspace(:,tt,:,:),1);
1371      end
1372    else
1373      kspace(:,2:2:end,:,:) = flipdim(kspace(:,2:2:end,:,:),1);
1374    end
1375   
1376   
1377    % Sort centric measurements
1378    if isfield(procpar,'ky_order') && strcmpi(procpar.ky_order,'c')
1379      kspace(:,Dat.phasetable(:),:,:)=kspace;
1380    end
1381    %kspace = flipdim(kspace,1);
1382   
1383    % Get the reference image(s)
1384    ref_im = kspace(:,:,:,1);
1385   
1386    % Do phase correction.
1387    phase_e = exp(-sqrt(-1)*angle(fft(ref_im,[],1)));
1388    for kk=2:size(kspace,4)
1389      kspace(:,:,:,kk) = ifft(fft(kspace(:,:,:,kk),[],1).*phase_e,[],1);
1390    end
1391  end
1392 
1393else
1394  % This section contains various "chewing gum and ironwire" type
1395  % patches that hopefully work...
1396 
1397  if strcmp(seqcon,'nncnn')
1398    kspace = permute(kspace,[1 3 2]);
1399  elseif strcmp(seqcon,'nccnn') && length(size(kspace))==2 && ...
1400      procpar.ns>=1 && AcqType~=1
1401    if ~isempty(Dat.phasetable)
1402      kssz = size(kspace);
1403      phsz = size(Dat.phasetable);
1404      kspace=permute(reshape(kspace,procpar.np/2,...
1405        phsz(2),...
1406        kssz(2)/phsz(2)),[1 3 2]);
1407      kspace = permute(reshape(kspace,...
1408        procpar.np/2,procpar.ns,kssz(2)/procpar.ns),[1 3 2]);
1409      if Dat.Sorting
1410        kspace(:,Dat.phasetable(:),:)=kspace;
1411      end
1412    else
1413      kspace = reshape(kspace,...
1414        [procpar.np/2 procpar.ns ...
1415        size(kspace,2)/procpar.ns]);
1416      kspace=permute(kspace,[1 3 2]);
1417    end
1418   
1419  elseif strcmp(seqcon,'nscsn') && length(size(kspace))==3 && ...
1420          AcqType~=1
1421        %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1422        % Support for 3D fast spin-echo
1423        %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1424        if ~isempty(Dat.phasetable)
1425          for ii=1:size(kspace,3)
1426                tmp = kspace(:,:,ii);
1427                kssz = size(tmp);
1428                phsz = size(Dat.phasetable);
1429                tmp=permute(reshape(tmp,procpar.np/2,...
1430                  phsz(2),...
1431                  kssz(2)/phsz(2)),[1 3 2]);
1432                tmp = permute(reshape(tmp,...
1433                  procpar.np/2,procpar.ns,kssz(2)/procpar.ns),[1 3 2]);
1434                if Dat.Sorting
1435                  tmp(:,Dat.phasetable(:),:)=tmp;
1436                end
1437                kspace(:,:,ii)=tmp;
1438          end
1439        end
1440       
1441       
1442  elseif AcqType~=1 && isfield(procpar,'nv')
1443    if length(size(kspace))==2 && ...
1444              ( size(kspace,1)~=(procpar.np/2) || size(kspace,2)~=procpar.nv )
1445      %% Reshape the kspace to the appropriate size
1446      kspace=reshape(kspace,[procpar.np/2 procpar.nv size(kspace,2)/ ...
1447                          procpar.nv]);
1448    end
1449  end
1450 
1451 
1452  %%% Support for Teemu's ASE3D-data
1453  %if strcmpi(seqcon,'ncccn')
1454  %  %% Reshape the kspace to the appropriate size
1455  %  kspace=reshape(kspace,[procpar.np/2 procpar.nv size(kspace,2)/procpar.nv]);
1456  %end
1457end
1458
1459
1460% Return image/spectral data --------------------------------
1461if Dat.ReturnFTData
1462  %% Fourier transform spectral data
1463  if AcqType==1
1464        wb_h = aedes_wbar(0,'Fourier transforming spectral data');
1465    %data=zeros(size(kspace),'single');
1466        data=kspace;
1467    sz=size(kspace,2)*size(kspace,3);
1468    count=1;
1469    for kk=1:size(kspace,3)
1470      for ii=1:size(kspace,2)
1471        %% Update waitbar
1472        if Dat.ShowWaitbar
1473          aedes_wbar(count/sz,...
1474               wb_h,...
1475               {'Fourier transforming spectral data',...
1476                ['(Processing spectrum ' num2str(count) '/' num2str(sz) ')']})
1477                end
1478        data(:,ii,kk) = abs(fftshift(fft(data(:,ii,kk))));
1479        count=count+1;
1480      end
1481    end
1482 
1483  %% Fourier transform image data
1484  else
1485   
1486    %% Zeropadding auto
1487    if Dat.ZeroPadding==2
1488     
1489      if Dat.isEPIdata && isfield(procpar,'readres') && isfield(procpar,'phaseres')
1490       
1491        %% Determine the image size for EPI data for procpar "readres"
1492        %% and "phaseres" fields
1493        data_sz = [procpar.readres procpar.phaseres];
1494        if isequal(data_sz,[size(kspace,1),size(kspace,2)])
1495          DoZeroPadding=false;
1496        else
1497          DoZeroPadding=true;
1498        end
1499        data_sz = [procpar.readres ...
1500          procpar.phaseres size(kspace,3) size(kspace,4)];
1501      else
1502       
1503        %% Check if zeropadding is necessary.
1504        ks_sz_sorted = sort([size(kspace,1),size(kspace,2)]);
1505        fov_sz_sorted = sort([procpar.lro,procpar.lpe]);
1506        sliceRelativeDim = ks_sz_sorted(2)/ks_sz_sorted(1);
1507        FOVrelativeDim = fov_sz_sorted(2)/fov_sz_sorted(1);
1508        if FOVrelativeDim~=sliceRelativeDim
1509          ind=find([size(kspace,1),size(kspace,2)]==ks_sz_sorted(1));
1510          data_sz = size(kspace);
1511          data_sz(ind) = round((fov_sz_sorted(1)/fov_sz_sorted(2))*ks_sz_sorted(2));
1512          DoZeroPadding=true;
1513        else
1514          data_sz = size(kspace);
1515          DoZeroPadding=false;
1516        end
1517      end
1518     
1519      %% Force zeropadding on. Force images to be square.
1520    elseif Dat.ZeroPadding==1
1521      ks_sz_max = max(size(kspace,1),size(kspace,2));
1522      data_sz = size(kspace);
1523      data_sz(1:2)=ks_sz_max;
1524      DoZeroPadding=true;
1525     
1526      %% Force zeropadding off
1527    else
1528      data_sz = size(kspace);
1529      DoZeroPadding=false;
1530    end
1531   
1532    %% Fourier transform 2D and EPI image data
1533    if AcqType==2 || Dat.isEPIdata
1534      sz=size(kspace,3);
1535     
1536      if DoZeroPadding
1537        data=zeros(data_sz,class(kspace));
1538        data(1:size(kspace,1),1:size(kspace,2),:,:)=kspace;
1539      else
1540        data=kspace;
1541      end
1542      if ~Dat.ReturnKSpace
1543        kspace = [];
1544      end
1545      if Dat.ShowWaitbar
1546        [wb_h,txh]=aedes_calc_wait('Fourier transforming image data...');
1547      end
1548     
1549      %data=permute(fftshift(fftshift(abs(fft(permute(fft(data),[2 1 3 4]))),1),2),[2 1 3 4]);
1550      if ~Dat.FastDataRead
1551        for tt=1:size(data,4)
1552          data(:,:,:,tt)=fftshift(fftshift(abs(fft(fft(data(:,:,:,tt),[],1),[],2)),1),2);
1553        end
1554      else
1555        data=fftshift(fftshift(abs(fft(fft(data,[],1),[],2)),1),2);
1556      end
1557    else
1558      %% Fourier transform 3D image data
1559      if Dat.ShowWaitbar
1560        [wb_h,txh]=aedes_calc_wait('Fourier transforming 3D image data...');
1561      end
1562     
1563      if DoZeroPadding
1564        % Check zeropadding in the 3rd dimension if zeropadding is set to
1565        % "auto"
1566        if Dat.ZeroPadding==2
1567          if isfield(procpar,'lpe2') && isfield(procpar,'lpe')
1568            data_sz(3) = max(1,round((procpar.lpe2/procpar.lpe)*data_sz(2)*ArrayLength));
1569          end
1570        end
1571        data=zeros(data_sz,class(kspace));
1572        data = abs(fftshift(fftn(kspace,data_sz)));
1573      else
1574        data=zeros(data_sz,class(kspace));
1575        data = abs(fftshift(fftn(kspace)));
1576      end
1577    end
1578   
1579    % Remove reference image if requested
1580    if Dat.isEPIdata && Dat.RemoveEPIphaseIm
1581      data = data(:,:,:,2:end);
1582    end
1583   
1584    % Reorient images and remove the reference image if requested
1585    if Dat.OrientImages && ~isempty(procpar) && ...
1586        isfield(procpar,'orient') && any(AcqType==[2 3 4])
1587      orient = procpar.orient{1};
1588      if any(strcmpi(orient,{'xyz','trans90','cor90','sag90'}))
1589        data = flipdim(aedes_rot3d(data,1,3),2);
1590      elseif strcmpi(orient,'oblique')
1591        data = flipdim(flipdim(data,1),2);
1592      else
1593        data = flipdim(flipdim(data,1),2);
1594      end
1595    end
1596   
1597   
1598   
1599% $$$   %% Fourier transform 4D image data
1600% $$$   elseif AcqType==4
1601% $$$     data = abs(fftshift(fftshift(fft2(kspace),2),1));
1602  end
1603end
1604
1605%% Delete waitbar
1606if Dat.ShowWaitbar && ishandle(wb_h)
1607  delete(wb_h)
1608end
1609
1610% Delete kspace if not returned
1611if ~Dat.ReturnKSpace
1612  kspace=[];
1613end
1614
1615%========================================================
1616% A function for creating phasetables for fse and fsems
1617%========================================================
1618function phasetable=l_CreateFsemsPhaseTable(procpar)
1619
1620phasetable = [];
1621if ~isfield(procpar,'etl') || ~isfield(procpar,'kzero')
1622  return
1623end
1624etl = procpar.etl;
1625kzero = procpar.kzero;
1626nv = procpar.nv;
1627
1628t = (-nv/2+1):(nv/2);
1629t = t(:);
1630tt = flipud(t);
1631tt = tt(:);
1632
1633phasetable = [reshape(t(1:nv/2),[],etl);...
1634  flipud(reshape(tt(1:nv/2),[],etl))];
1635phasetable = circshift(fliplr(phasetable),[0 kzero-1]);
1636
1637
1638%% - EOF - %%
1639return
Note: See TracBrowser for help on using the repository browser.

Powered by Trac 1.0.9.Copyright © Juha-Pekka Niskanen 2008