% SETYUNITS Set the property 'yunits'.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DESCRIPTION: Set the property 'yunits'.
%
% CALL:              obj.setYunits('units');
%              obj = obj.setYunits('units'); create copy of the object
%
% INPUTS:      obj   - must be a single ltpda_data (cdata, data2D, data3D) object.
%              units - unit object or a valid string which can be transformed
%                      into a unit object.
%
% VERSION:     $Id: setYunits.m,v 1.5 2011/09/02 11:05:24 ingo Exp $
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

function varargout = setYunits(varargin)

  obj = varargin{1};
  val = varargin{2};

  % decide whether we modify the object, or create a new one.
  obj = copy(obj, nargout);

  % set 'yunits'
  if isempty(val)
    obj.yunits = unit();
  elseif ischar(val)
    obj.yunits = unit(val);
  elseif iscell(val)
    obj.yunits = val{1};
  else
    obj.yunits = val;
  end

  varargout{1} = obj;
end

