X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?p=CreaPhase.git;a=blobdiff_plain;f=octave_packages%2Fcontrol-2.3.52%2F%40lti%2Ftfdata.m;fp=octave_packages%2Fcontrol-2.3.52%2F%40lti%2Ftfdata.m;h=be31e23507e631a85bcc100d544a82da785e9ecb;hp=0000000000000000000000000000000000000000;hb=f5f7a74bd8a4900f0b797da6783be80e11a68d86;hpb=1705066eceaaea976f010f669ce8e972f3734b05 diff --git a/octave_packages/control-2.3.52/@lti/tfdata.m b/octave_packages/control-2.3.52/@lti/tfdata.m new file mode 100644 index 0000000..be31e23 --- /dev/null +++ b/octave_packages/control-2.3.52/@lti/tfdata.m @@ -0,0 +1,79 @@ +## Copyright (C) 2009, 2010, 2011, 2012 Lukas F. Reichlin +## +## This file is part of LTI Syncope. +## +## LTI Syncope is free software: you can redistribute it and/or modify +## it under the terms of the GNU General Public License as published by +## the Free Software Foundation, either version 3 of the License, or +## (at your option) any later version. +## +## LTI Syncope 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 General Public License for more details. +## +## You should have received a copy of the GNU General Public License +## along with LTI Syncope. If not, see . + +## -*- texinfo -*- +## @deftypefn {Function File} {[@var{num}, @var{den}, @var{tsam}] =} tfdata (@var{sys}) +## @deftypefnx {Function File} {[@var{num}, @var{den}, @var{tsam}] =} tfdata (@var{sys}, @var{"vector"}) +## @deftypefnx {Function File} {[@var{num}, @var{den}, @var{tsam}] =} tfdata (@var{sys}, @var{"tfpoly"}) +## Access transfer function data. +## Argument @var{sys} is not limited to transfer function models. +## If @var{sys} is not a transfer function, it is converted automatically. +## +## @strong{Inputs} +## @table @var +## @item sys +## Any type of LTI model. +## @item "v", "vector" +## For SISO models, return @var{num} and @var{den} directly as column vectors +## instead of cells containing a single column vector. +## @end table +## +## @strong{Outputs} +## @table @var +## @item num +## Cell of numerator(s). Each numerator is a row vector +## containing the coefficients of the polynomial in descending powers of +## the transfer function variable. +## num@{i,j@} contains the numerator polynomial from input j to output i. +## In the SISO case, a single vector is possible as well. +## @item den +## Cell of denominator(s). Each denominator is a row vector +## containing the coefficients of the polynomial in descending powers of +## the transfer function variable. +## den@{i,j@} contains the denominator polynomial from input j to output i. +## In the SISO case, a single vector is possible as well. +## @item tsam +## Sampling time in seconds. If @var{sys} is a continuous-time model, +## a zero is returned. +## @end table +## @end deftypefn + +## Author: Lukas Reichlin +## Created: September 2009 +## Version: 0.5 + +function [num, den, tsam] = tfdata (sys, rtype = "cell") + + if (! isa (sys, "tf")) + sys = tf (sys); + endif + + [num, den] = __sys_data__ (sys); + + tsam = sys.tsam; + + if (! strncmpi (rtype, "t", 1)) # != tfpoly + num = cellfun (@get, num, "uniformoutput", false); + den = cellfun (@get, den, "uniformoutput", false); + endif + + if (strncmpi (rtype, "v", 1) && issiso (sys)) # == vector + num = num{1}; + den = den{1}; + endif + +endfunction