You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

111 lines
3.5 KiB

%SerialLink.fdyn Integrate forward dynamics
%
% [T,Q,QD] = R.fdyn(T1, TORQFUN) integrates the dynamics of the robot over
% the time interval 0 to T and returns vectors of time TI, joint position Q
% and joint velocity QD. The initial joint position and velocity are zero.
% The torque applied to the joints is computed by the user function TORQFUN:
%
% [TI,Q,QD] = R.fdyn(T, TORQFUN, Q0, QD0) as above but allows the initial
% joint position and velocity to be specified.
%
% The control torque is computed by a user defined function
%
% TAU = TORQFUN(T, Q, QD, ARG1, ARG2, ...)
%
% where Q and QD are the manipulator joint coordinate and velocity state
% respectively, and T is the current time.
%
% [T,Q,QD] = R.fdyn(T1, TORQFUN, Q0, QD0, ARG1, ARG2, ...) allows optional
% arguments to be passed through to the user function.
%
% Note::
% - This function performs poorly with non-linear joint friction, such as
% Coulomb friction. The R.nofriction() method can be used to set this
% friction to zero.
% - If TORQFUN is not specified, or is given as 0 or [], then zero torque
% is applied to the manipulator joints.
% - The builtin integration function ode45() is used.
%
% See also SerialLink.accel, SerialLink.nofriction, SerialLink.rne, ode45.
% Copyright (C) 1993-2011, by Peter I. Corke
%
% This file is part of The Robotics Toolbox for Matlab (RTB).
%
% RTB is free software: you can redistribute it and/or modify
% it under the terms of the GNU Lesser General Public License as published by
% the Free Software Foundation, either version 3 of the License, or
% (at your option) any later version.
%
% RTB is distributed in the hope that it will be useful,
% but WITHOUT ANY WARRANTY; without even the implied warranty of
% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
% GNU Lesser General Public License for more details.
%
% You should have received a copy of the GNU Leser General Public License
% along with RTB. If not, see <http://www.gnu.org/licenses/>.
%
% http://www.petercorke.com
function [t, q, qd] = fdyn(robot, t1, torqfun, q0, qd0, varargin)
% check the Matlab version, since ode45 syntax has changed
if verLessThan('matlab', '7')
error('fdyn now requires Matlab version >= 7');
end
n = robot.n;
if nargin == 2
torqfun = 0;
q0 = zeros(1,n);
qd0 = zeros(1,n);
elseif nargin == 3
q0 = zeros(1,n);
qd0 = zeros(1,n);
elseif nargin == 4
qd0 = zeros(1,n);
end
% concatenate q and qd into the initial state vector
q0 = [q0(:); qd0(:)];
[t,y] = ode45(@fdyn2, [0 t1], q0, [], robot, torqfun, varargin{:});
q = y(:,1:n);
qd = y(:,n+1:2*n);
end
%FDYN2 private function called by FDYN
%
% XDD = FDYN2(T, X, FLAG, ROBOT, TORQUEFUN)
%
% Called by FDYN to evaluate the robot velocity and acceleration for
% forward dynamics. T is the current time, X = [Q QD] is the state vector,
% ROBOT is the object being integrated, and TORQUEFUN is the string name of
% the function to compute joint torques and called as
%
% TAU = TORQUEFUN(T, X)
%
% if not given zero joint torques are assumed.
%
% The result is XDD = [QD QDD].
function xd = fdyn2(t, x, robot, torqfun, varargin)
n = robot.n;
q = x(1:n)';
qd = x(n+1:2*n)';
% evaluate the torque function if one is given
if isa(torqfun, 'function_handle')
tau = torqfun(robot, t, q, qd, varargin{:});
else
tau = zeros(1,n);
end
qdd = robot.accel(x(1:n,1)', x(n+1:2*n,1)', tau);
xd = [x(n+1:2*n,1); qdd];
end