Mercurial > hg > ltpda
diff m-toolbox/classes/@ssm/ssm2ss.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/ssm2ss.m Wed Nov 23 19:22:13 2011 +0100 @@ -0,0 +1,107 @@ +% SSM2SS converts a statespace model object to a MATLAB statespace object. +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% +% DESCRIPTION: SSM2SS converts a statespace model object to a MATLAB statespace object. +% +% CALL: Convert a statespace model object to a MATLAB statespace object. +% >> ss = ssm2ss(ssm, pl); +% +% ssm - ssm object +% plist with parameters 'inputs', 'states' and 'outputs' to indicate which +% inputs, states and outputs variables are taken in account. This requires +% proper variable naming. If a variable called appears more that once it +% will be used once only. +% +% <a href="matlab:utils.helper.displayMethodInfo('ssm', 'ssm2ss')">Parameters Description</a> +% +% VERSION: $Id: ssm2ss.m,v 1.33 2011/04/08 08:56:23 hewitson Exp $ +% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +function varargout = ssm2ss(varargin) + + %% starting initial checks + % Check if this is a call for parameters + if utils.helper.isinfocall(varargin{:}) + varargout{1} = getInfo(varargin{3}); + return + end + + utils.helper.msg(utils.const.msg.MNAME, ['running ', mfilename]); + + in_names = cell(size(varargin)); + for ii = 1:nargin,in_names{ii} = inputname(ii);end + + [obj, ssm_invars, rest] = utils.helper.collect_objects(varargin(:), 'ssm', in_names); + [pl, invars2, rest] = utils.helper.collect_objects(rest(:), 'plist'); + if ~isempty(rest) + pl = combine(pl, plist(rest{:})); + end + pl = combine(pl, getDefaultPlist()); + + %% begin function body + if ~obj.isnumerical + error('system should be numeric') + end + if nargout == numel(obj) + for ii = 1:numel(obj) + [A,B,C,D,Ts,inputvarnames,ssvarnames, outputvarnames] = double(obj(ii), pl); + sys = ss(A,B,C,D,Ts); + sys.StateName = ssvarnames; + sys.InputName = inputvarnames; + sys.OutputName = outputvarnames; + sys.Notes = obj.description; + sys.Name = obj.name; + varargout{ii} = sys; + end + else + [A,B,C,D,Ts,inputvarnames,ssvarnames, outputvarnames] = double(obj, pl); + sys = ss(A,B,C,D,Ts); + sys.StateName = ssvarnames; + sys.InputName = inputvarnames; + sys.OutputName = outputvarnames; + sys.Notes = obj.description; + sys.Name = obj.name; + varargout{1} = sys; + end +end + +%-------------------------------------------------------------------------- +% Get Info Object +%-------------------------------------------------------------------------- +function ii = getInfo(varargin) + + if nargin == 1 && strcmpi(varargin{1}, 'None') + sets = {}; + pl = []; + else + sets = {'Default'}; + pl = getDefaultPlist; + end + % Build info object + ii = minfo(mfilename, 'ssm', 'ltpda', utils.const.categories.converter, '$Id: ssm2ss.m,v 1.33 2011/04/08 08:56:23 hewitson Exp $', sets, pl); +end + +%-------------------------------------------------------------------------- +% Get Default Plist +%-------------------------------------------------------------------------- +function pl = getDefaultPlist() + pl = plist(); + + p = param({'inputs', ['Specify the inputs. Give one of:<ul>'... + '<li>A cell-array of input port names.</li>'... + '<li>A cell-array of logical arrays specifying which input ports to use for each input block.</li>'... + '<li>A cell-array of double values specifying which input ports to use for each input block.<li>'... + '<li>The string ''ALL'' to use all inputs.']}, paramValue.STRING_VALUE('ALL')); + pl.append(p); + + p = param({'states', 'Specify the states. Specify the states as for the ''inputs'' parameter.'}, paramValue.STRING_VALUE('ALL')); + pl.append(p); + + p = param({'outputs', 'Specify the outputs. Specify the outputs as for the ''inputs'' parameter.'}, paramValue.STRING_VALUE('ALL')); + pl.append(p); +end + + + +