diff m-toolbox/classes/@ssm/ssmFromParfrac.m @ 0:f0afece42f48

Import.
author Daniele Nicolodi <nicolodi@science.unitn.it>
date Wed, 23 Nov 2011 19:22:13 +0100
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/m-toolbox/classes/@ssm/ssmFromParfrac.m	Wed Nov 23 19:22:13 2011 +0100
@@ -0,0 +1,91 @@
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+% FUNCTION:    ssmFromParfrac
+%
+% DESCRIPTION: Construct a statespace model from a ssmFromParfrac
+%
+% CALL:        see ssm, this function is private
+%
+% TODO:        check must be made there is no pole zero cancelation
+%
+% VERSION :    '$Id: ssmFromParfrac.m,v 1.10 2010/08/27 13:09:56 adrien Exp $';
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+function varargout = ssmFromParfrac(varargin)
+
+  VERSION = '$Id: ssmFromParfrac.m,v 1.10 2010/08/27 13:09:56 adrien Exp $';
+  utils.helper.msg(utils.const.msg.MNAME, ['running ', mfilename]);
+  % get info
+  ii = ssm.getInfo('ssm', 'From Description');
+  % Set the method version string in the minfo object
+  ii.setMversion([VERSION '-->' ii.mversion]);
+
+  if nargin ~=2
+    error('ssmFromRational need 2 inputs : (obj, plist) ')
+  elseif isa(varargin{1}, 'parfrac') && isa(varargin{2}, 'plist')
+    pl = combine(varargin{2}, ii.plists);
+    parfracsin = varargin{1};
+  else
+    error('### Please input  (<object>,<plist>)');
+  end
+
+  ssmout = ssm.initObjectWithSize(size(parfracsin,1),size(parfracsin,2));
+  for i =1:numel(parfracsin)
+
+    res = parfracsin(i).res;
+    poles = parfracsin(i).poles;
+    dterm = parfracsin(i).dir;
+    pmul = parfracsin(i).pmul;
+
+    % check poles multiplicity
+    for jj=1:length(pmul)
+      if pmul(jj)~=1;
+        error('!!! Poles multiplicity higher than 1 is not supported')
+      end
+    end
+
+    % willing to work with columns
+    if size(res,2)>1
+      res = res.';
+    end
+    if size(poles,2)>1
+      poles = poles.';
+    end
+    
+    Nss = numel(poles);
+
+    % convert to state space matrices
+    [A,B,C,D] = utils.math.pf2ss(res,poles,dterm);
+
+
+    
+    ssmout(i).dmats = {D};
+    ssmout(i).amats = {A};
+    ssmout(i).bmats = {B};
+    ssmout(i).cmats = {C};
+    
+    ssmout(i).name  = parfracsin(i).name;
+    ssmout(i).timestep = 0;
+    ssmout(i).addHistory(ii, pl, {''}, parfracsin(i).hist);
+    
+    inputstr = 'input';
+    outputstr = 'output';
+    ssstr =  'state';
+    
+    ssmout(i).inputs = ssmblock.makeBlocksWithData({inputstr}, [], {{inputstr}}, {parfracsin(i).iunits}, []);
+    ssmout(i).outputs = ssmblock.makeBlocksWithData({outputstr}, [], {{outputstr}}, {parfracsin(i).ounits}, []);
+    ssmout(i).states = ssmblock.makeBlocksWithSize(Nss, ssstr);
+    
+    if ~strcmp(pl.find('name'),'none')
+      ssmout(i).name = pl.find('name');
+    end
+    if ~strcmp(pl.find('description'),'')
+      ssmout(i).description = pl.find('description');
+    end
+  end
+
+  varargout = {ssmout};
+end
+
+