function knot(action);
%KNOT   Tube surrounding a three-dimensional knot.
%   KNOT computes the parametric representation of tube-like
%   surfaces and displays the tube with SURF.
%
%   See also SURF
 
%   Rouben Rostamian, March 1991.
%   Modified from Titan MATLAB to MATLAB V4.0, C. Moler, Sept. 91.
%   Adapted for Demo by Ned Gulley, 6-21-93; jae Roh, 10-15-96
%   Copyright 1984-2000 The MathWorks, Inc. 
%   $Revision: 5.12 $  $Date: 2000/06/01 03:46:29 $

% Possible actions:
% initialize
% info

if nargin<1,
    action='initialize';
end;

if strcmp(action,'initialize'),
    figNumber=figure( ...
        'Name','Colorful Knot', ...
        'NumberTitle','off', ...
        'Visible','off');
    axes( ...
        'Units','normalized', ...
        'Position',[0.05 0.05 0.70 0.90], ...
        'NextPlot','add', ...
        'XLim',[-6 6],'YLim',[-6 6],'ZLim',[-6 6], ...
        'Box','on', ...
        'XTick',[],'YTick',[],'ZTick',[]);

    %===================================
    % Information for all buttons
    labelColor=[0.8 0.8 0.8];
    yInitPos=0.90;
    xPos=0.80;
    btnLen=0.15;
    btnWid=0.10;
    % Spacing between the button and the next command's label
    spacing=0.05;
    
    %====================================
    % The CONSOLE frame
    frmBorder=0.02;
    yPos=0.05-frmBorder;
    frmPos=[xPos-frmBorder yPos btnLen+2*frmBorder 0.9+2*frmBorder];
    uicontrol( ...
        'Style','frame', ...
        'Units','normalized', ...
        'Position',frmPos, ...
        'BackgroundColor',[0.50 0.50 0.50]);

    %====================================
    % The SPINMAP button
    btnNumber=1;
    yPos=0.90-(btnNumber-1)*(btnWid+spacing);
    labelStr='Spinmap';
    callbackStr='spinmap';

    % Generic popup button information
    btnPos=[xPos yPos-spacing btnLen btnWid];
    spinHndl=uicontrol( ...
        'Style','pushbutton', ...
        'Units','normalized', ...
        'Position',btnPos, ...
        'String',labelStr, ...
        'Callback',callbackStr);
    if (get(0, 'screendepth')>8)
      set(spinHndl, 'Visible', 'off');
    end
    %====================================
    % The INFO button
    labelStr='Info';
    callbackStr='knot(''info'')';
    uicontrol( ...
        'Style','push', ...
        'Units','normalized', ...
        'Position',[xPos 0.20 btnLen 0.10], ...
        'String',labelStr, ...
        'Callback',callbackStr);

    %====================================
    % The CLOSE button
    labelStr='Close';
    callbackStr='close(gcf)';
    uicontrol( ...
        'Style','push', ...
        'Units','normalized', ...
        'Position',[xPos 0.05 btnLen 0.10], ...
        'String',labelStr, ...
        'Callback',callbackStr);

    %====================================
    % Now draw the knot.
    % KNOT Tube surrounding a three-dimensional knot.
    % KNOT computes the parametric representation of tube-like
    % surfaces and displays the tube with SURF.
    % Rouben Rostamian, March 1991.

    % THE FOLLOWING PARAMETERS CAN BE CHANGED:
    % Number of grid points in each (circular) section of the tube. 
    m = 20;         
    % Number of sections along the tube.
    n = 60;         
    % Radius of the tube.
    R = 0.75;        
    % Symmetry index.  Try q=floor(n/3) (symmetric) or q=floor(n/4)
    q = floor(n/3); 

    % Do not change this!
    t = (0:n)/n;

    % SPECIFY THE GENERATING FUNCTION HERE:
    % The generating function f0 must be 1-periodic.
    % f1 and f2 are the first and second derivatives of f0.
    a = 2; b = 3; c = 1.5;
    % a = 2; b = 5; c = 1.5;
    % actual values: q1=2; q2=4;
    q1=2;q2=4;
    f0 = sin(q1*pi*t) + a*sin(q2*pi*t) - ...
         b*cos(4*pi*t)/2 + c*sin(6*pi*t); 
    f1 = (q1*pi)*cos(q1*pi*t) + a*(q2*pi)*cos(q2*pi*t) + ...
         b*(4*pi)*sin(4*pi*t)/2 + c*(6*pi)*cos(6*pi*t);
    f2 = -(q1*pi)^2*sin(q1*pi*t) - a*(q2*pi)^2*sin(q2*pi*t) + ...
         b*(4*pi)^2*cos(4*pi*t)/2 - c*(6*pi)^2*sin(6*pi*t);

    % DO NOT CHANGE ANYTHING BELOW THIS LINE.

    % Extend f periodically to 2 period-intervals:
    f0 = [ f0(1:n) f0(1:n) ];
    f1 = [ f1(1:n) f1(1:n) ];
    f2 = [ f2(1:n) f2(1:n) ];

    % [x10;x20;x30] is the parametric representation of 
    % the center-line of the tube:
    x10 = f0(1:n+1);   
    x20 = f0(q+1:q+n+1);
    x30 = f0(2*q+1:2*q+n+1);

    % [x11;x21;x31] is velocity (same as tangent) vector:
    x11 = f1(1:n+1);
    x21 = f1(q+1:q+n+1);
    x31 = f1(2*q+1:2*q+n+1);

    % [x12;x22;x32] is acceleration vector:
    x12 = f2(1:n+1);
    x22 = f2(q+1:q+n+1);
    x32 = f2(2*q+1:2*q+n+1);

    speed = sqrt(x11.^2 + x21.^2 + x31.^2);

    % This is the dot-product of the velocity and acceleration vectors:
    velacc = x11.*x12 + x21.*x22 + x31.*x32;

    % Here is the normal vector:
    nrml1 = speed.^2 .* x12 - velacc.*x11;
    nrml2 = speed.^2 .* x22 - velacc.*x21;
    nrml3 = speed.^2 .* x32 - velacc.*x31;
    normallength = sqrt(nrml1.^2 + nrml2.^2 + nrml3.^2);

    % And here is the normalized normal vector:
    unitnormal1 = nrml1 ./ normallength;
    unitnormal2 = nrml2 ./ normallength;
    unitnormal3 = nrml3 ./ normallength;

    % And the binormal vector ( B = T x N )
    binormal1 = (x21.*unitnormal3 - x31.*unitnormal2) ./ speed;
    binormal2 = (x31.*unitnormal1 - x11.*unitnormal3) ./ speed;
    binormal3 = (x11.*unitnormal2 - x21.*unitnormal1) ./ speed;

    % s is the coordinate along the circular cross-sections of the tube:
    s = (0:m)';
    s = (2*pi/m)*s;

    % Finally, the parametric surface.  
    % Each of x1, x2, x3 is an (m+1)x(n+1) matrix.
    % Rows represent coordinates along the tube.  Columns represent coordinates
    % in each (circular) cross-section of the tube.

    xa1 = ones(m+1,1)*x10;
    xb1 = (cos(s)*unitnormal1 + sin(s)*binormal1);
    xa2 = ones(m+1,1)*x20;
    xb2 = (cos(s)*unitnormal2 + sin(s)*binormal2);
    xa3 = ones(m+1,1)*x30;
    xb3 = (cos(s)*unitnormal3 + sin(s)*binormal3);
    color = ones(m+1,1)*((0:n)*2/n-1);

    x1 = xa1 + R*xb1;
    x2 = xa2 + R*xb2;
    x3 = xa3 + R*xb3;

    surf(x1,x2,x3,color);
    shading interp;
    light
    lighting phong

    % Reset the arrow and the nextplot information for this window.
    set(figNumber, ...
        'Visible','on');

elseif strcmp(action,'info');
    helpwin(mfilename);

end;    % if strcmp(action, ...

