% SETXUNITS Set the property 'xunits'.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DESCRIPTION: Set the property 'xunits'.
%
% CALL:              obj.setXunits('units');
%              obj = obj.setXunits('units'); create copy of the object
%
% INPUTS:      obj   - must be a single data2D object.
%              units - unit object or a valid string which can be transformed
%                      into a unit object.
%
% VERSION:     $Id: setXunits.m,v 1.10 2011/07/12 13:35:02 mauro Exp $
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

function varargout = setXunits(varargin)

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

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

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

  varargout{1} = obj;
end