X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?p=CreaPhase.git;a=blobdiff_plain;f=octave_packages%2Fcontrol-2.3.52%2Festim.m;fp=octave_packages%2Fcontrol-2.3.52%2Festim.m;h=1c40ad0e100a4e992f1a19e3c18566add3116eae;hp=0000000000000000000000000000000000000000;hb=c880e8788dfc484bf23ce13fa2787f2c6bca4863;hpb=1705066eceaaea976f010f669ce8e972f3734b05 diff --git a/octave_packages/control-2.3.52/estim.m b/octave_packages/control-2.3.52/estim.m new file mode 100644 index 0000000..1c40ad0 --- /dev/null +++ b/octave_packages/control-2.3.52/estim.m @@ -0,0 +1,99 @@ +## Copyright (C) 2009, 2010 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{est} =} estim (@var{sys}, @var{l}) +## @deftypefnx {Function File} {@var{est} =} estim (@var{sys}, @var{l}, @var{sensors}, @var{known}) +## Return state estimator for a given estimator gain. +## +## @strong{Inputs} +## @table @var +## @item sys +## LTI model. +## @item l +## State feedback matrix. +## @item sensors +## Indices of measured output signals y from @var{sys}. If omitted, all outputs are measured. +## @item known +## Indices of known input signals u (deterministic) to @var{sys}. All other inputs to @var{sys} +## are assumed stochastic. If argument @var{known} is omitted, no inputs u are known. +## @end table +## +## @strong{Outputs} +## @table @var +## @item est +## State-space model of estimator. +## @end table +## @seealso{kalman, place} +## @end deftypefn + +## Author: Lukas Reichlin +## Created: November 2009 +## Version: 0.2 + +function est = estim (sys, l, sensors = [], known = []) + + if (nargin < 2 || nargin > 4) + print_usage (); + endif + + if (! isa (sys, "lti")) + error ("estim: first argument must be an LTI system"); + endif + + [a, b, c, d, e, tsam] = dssdata (sys, []); + + if (isempty (sensors)) + sensors = 1 : rows (c); + endif + + m = length (known); + n = rows (a); + p = length (sensors); + + b = b(:, known); + c = c(sensors, :); + d = d(sensors, known); + + f = a - l*c; + g = [b - l*d, l]; + h = [c; eye(n)]; + j = [d, zeros(p, p); zeros(n, m), zeros(n, p)]; + ## k = e; + + est = dss (f, g, h, j, e, tsam); + + ## TODO: inname, stname, outname + +endfunction + + +%!shared m, m_exp +%! sys = ss (-2, 1, 1, 3); +%! est = estim (sys, 5); +%! [a, b, c, d] = ssdata (est); +%! m = [a, b; c, d]; +%! m_exp = [-7, 5; 1, 0; 1, 0]; +%!assert (m, m_exp, 1e-4); + +%!shared m, m_exp +%! sys = ss (-1, 2, 3, 4); +%! est = estim (sys, 5); +%! [a, b, c, d] = ssdata (est); +%! m = [a, b; c, d]; +%! m_exp = [-16, 5; 3, 0; 1, 0]; +%!assert (m, m_exp, 1e-4); \ No newline at end of file