yoffset.m

JLAB is a set of Matlab functions I have written or co-written over the past fifteen years for the p

function[]=yoffset(i1,i2)
%YOFFSET  Offsets lines in the y-direction after plotting.
%	    	    	    
%   YOFFSET allows data to be manipulated after it has been plotted,
%   by operating on the data stored in the figure itself.  This is
%   intended to be used only with 2-D line plots (not symbol plots,
%   contour plots, etc.). YOFFSET also allow multiple axes to be
%   manipulated simultaneously.
%
%   YOFFSET offsets all lines in the current axes a specified amount.
%		
%   YOFFSET(N) or YOFFSET N, where N is a *real* number, offsets each
%   column of the Y-data by an amount N from the previous column.  N
%   must be a number, not a variable whose value is a number.
%
%   YOFFSET(N) or YOFFSET N, where N is an *imaginary* number, offsets
%   each column of the Y-data by an amount imag(N)*DY from the
%   previous column, where DY is the Y-axis length of the original
%   (i.e. unoffset) plot.
%
%   YOFFSET(M,N) or YOFFSET M N, applies the same offsets to each of
%   M groups of lines, i.e. for complex-valued data Z use UVPLOT(Z) 
%   followed by YOFFSET 2 N.
%
%   YOFFSET with no arguments returns the data to its original
%   (unoffset) orientation [as do YOFFSET(0) and YOFFSET(0i)].
%   
%   YOFFSET LOCK and YOFFSET UNLOCK lock and unlock all Y-data in the
%   current figure. When LOCK is on, calls to YOFFSET are applied to
%   each subplot individually.
%
%   See also XOFFSET, LINERING, LINESTYLE
%   __________________________________________________________________
%   This is part of JLAB --- type 'help jlab' for more information
%   (C) 2002, 2004 J.M. Lilly --- type 'help jlab_license' for details  


if strcmp(i1,'--t')
    return
end

bcontinue=1;
if nargin==1;
  N=10000;  %Very large number of lines
end
if nargin==2
  N=i1;
  i1=i2;
  if ischar(N)
    N=str2num(N);
  end 
end

if nargin>0
   if ischar(i1)
      if isempty(str2num(i1))
           i1=deblank(i1);
           i1=fliplr(deblank(fliplr(i1)));	
           if strcmp(i1,'lock')
               if isappdata(gca,'lastyoffset')
                    lastoff=getappdata(gca,'lastyoffset');
                    setappdata(gcf,'yoffsetlock',1)
                    yoffsetloop(0,N);
                    yoffsetloop(lastoff,N); 
               else
                    setappdata(gcf,'yoffsetlock',1)
               end		 
               bcontinue=0;
           end
           if strcmp(i1,'unlock')
               setappdata(gcf,'yoffsetlock',0)
               bcontinue=0;
           end
      end
   end
end

if bcontinue	
   if nargin>0
      delta=i1;
   else 
      delta=0;
   end

   h=linehandles;
   if plotmodified(h)
   %If the plot has been changed, the old "lastyoffset" may no
   %longer be correct.  If so, we set it to zero
       setappdata(gca,'lastyoffset',0)		 
   end
   yoffsetloop(delta,N);
end



function[]=yoffsetloop(delta,N)

h=gca;
if isappdata(gcf,'yoffsetlock')
   if getappdata(gcf,'yoffsetlock')
      h=axeshandles(gcf);	
   end 
end

for i=1:length(h)
    axes(h(i))
    if isappdata(gca,'lastyoffset')
       lastdelta=getappdata(gca,'lastyoffset');
       yoffsetapply(-1*lastdelta,N);
       setappdata(gca,'lastyoffset',0)
    end
    yoffsetapply(delta,N);
end

axes(h(1))

function[]=yoffsetapply(delta,N)
h=linehandles;
     
if ischar(delta),delta=str2num(delta);,end
yy=get(h,{'ydata'});

if length(delta)==1 && ~isreal(delta)
   ax=axis;
   dy=ax(4)-ax(3);
   delta=dy.*imag(delta)/100;
end

if length(delta)==1
   for i=1:length(yy)
       yy{i}=yy{i}+delta*(mod(i-1,round(length(yy)/N)));
   end
elseif length(delta)==length(h)
   for i=1:length(yy)
       yy{i}=yy{i}+delta(i);
   end
else
   error(['Number of line handles does not equal offset array length'])
end

set(h,{'ydata'},yy);
setappdata(gca,'lastyoffset',delta)		
setappdata(gca,'lasthandles',h)		

function[b]=plotmodified(h)
b=0;  
if isappdata(gca,'lasthandles')
  b=1;
  h2=getappdata(gca,'lasthandles');
  if length(h2)==length(h)
      if all(h2==h)
          b=0;
      end
  end
end