+
−% Construct a matrix object with multiple AOs built from input values.
+
−%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
−%
+
−% FUNCTION:    fromValues
+
−%
+
−% DESCRIPTION: Construct a matrix object with multiple AOs built from input
+
−%              values.
+
−%
+
−% CALL:        matrix = matrix.fromValues(obj, pli)
+
−%
+
−% VERSION:     $Id: fromValues.m,v 1.4 2011/03/24 19:53:52 ingo Exp $
+
−%
+
−%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
−function obj = fromValues(obj, pli, callerIsMethod)
+
−  
+
−  import utils.const.*
+
−  utils.helper.msg(msg.PROC2, 'Constructing an matrix object with multiple AOs built from input values.');
+
−  
+
−  % get AO info
+
−  ii = matrix.getInfo('matrix', 'From Values');
+
−  
+
−  pl = combine(pli, ii.plists);
+
−  values = pl.find('values');
+
−  yunits = pl.find('yunits');
+
−  names  = pl.find('names');
+
−  
+
−  % Some plausibility checks
+
−  if ~isnumeric(values)
+
−    error('### The values must be from the type double');
+
−  end
+
−  nvals = numel(values);
+
−  
+
−  if ischar(yunits)
+
−    yunits = cellstr(yunits);
+
−  end
+
−  if numel(yunits) > 1 && numel(yunits) ~= nvals
+
−    error('### The number of yunits must be the same as the numer of values %d <-> %d', numel(yunits), nvals);
+
−  end
+
−  if numel(yunits) == 1
+
−    % Replicate the single unit for all AOs
+
−    yunits = repmat(yunits, 1, nvals);
+
−  end
+
−  
+
−  if ischar(names)
+
−    names = cellstr(names);
+
−  end
+
−  if numel(names) > 1 && numel(names) ~= nvals
+
−    error('### The number of names must be the same as the numer of values %d <-> %d', numel(names), nvals);
+
−  end
+
−  if numel(names) == 1
+
−    % Replicate the single name for all AOs
+
−    names = repmat(names, 1, nvals);
+
−  end
+
−  
+
−  for nn = 1:numel(values)
+
−    
+
−    % Create the AO
+
−    a = ao(values(nn));
+
−    
+
−    % Set the name
+
−    if ~isempty(names)
+
−      a.setName(names{nn});
+
−    end
+
−  
+
−    % Set the y-units
+
−    if ~isempty(yunits)
+
−      a.setYunits(yunits{nn});
+
−    end
+
−  
+
−    obj.objs = [obj.objs a];
+
−    
+
−  end
+
−  
+
−  % Reshape the inside objects
+
−  obj.objs = reshape(obj.objs, size(values));
+
−  
+
−  % Add history
+
−  if callerIsMethod
+
−    % do nothing
+
−  else
+
−    obj.addHistory(ii, pl, [], []);
+
−  end
+
−  
+
−  warning('off', utils.const.warnings.METHOD_NOT_FOUND);
+
−  % remove parameters we already used
+
−  pl_set = copy(pl,1);
+
−  obj.setProperties(pl_set);
+
−  warning('on', utils.const.warnings.METHOD_NOT_FOUND);
+
−end