% Construct a matrix object from ltpda_uoh objects.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% FUNCTION:    fromInput
%
% DESCRIPTION: Construct a matrix object from ltpda_uoh objects.
%
% CALL:        matrix = matrix.fromInput(inobjs)
%
% VERSION:     $Id: fromInput.m,v 1.10 2011/12/05 07:40:23 hewitson Exp $
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
function obj = fromInput(obj, pli, callerIsMethod)
  
  VERSION = '$Id: fromInput.m,v 1.10 2011/12/05 07:40:23 hewitson Exp $';
  
  import utils.const.*
  
  if callerIsMethod
    % do nothing
  else
    % get AO info
    ii = matrix.getInfo('matrix', 'From Input');
    
    % Set the method version string in the minfo object
    ii.setMversion([VERSION '-->' ii.mversion]);
  end
  
  % Combine input plist with default values
  if callerIsMethod
    pl        = pli;
  else
    % Combine input plist with default values
    % TODO: the parse step should be removed and included somehow into plist/applyDefaults
    pl = applyDefaults(ii.plists, pli);
  end  
  
  shape = pl.find('shape');
  objs  = pl.find('objs');
  
  if iscell(objs)
    [inobjs, ao_invars, rest] = utils.helper.collect_objects(objs(:), '');
    if ~isempty(rest)
      warning('LTPDA:MATRIX', '### The matrix constructor collects only all %s-objects but there are some %s-objects left.', class(inobjs), class(rest{1}));
    end
  else
    inobjs = objs;
  end
  
  if ~isempty(shape)
    obj.objs = reshape(inobjs, shape);
  else
    obj.objs = inobjs;
  end
  
  
  if callerIsMethod
    % do less
  else
    pl.pset('shape', size(obj.objs));
    % Remove the input objects from the plist because we add the histories of
    % the input objects to the matrix object.
    pl.remove('objs');
    
    inhists = [];
    if ~isempty(inobjs)
      inhists = [inobjs(:).hist];
    end
    obj.addHistory(matrix.getInfo('matrix', 'None'), pl, [], inhists);

    % Set any remaining object properties which exist in the default plist
    obj.setObjectProperties(pl);
  end
  
end