Summary of important user-visible changes for releases of the control package =============================================================================== control-2.6.2 Release Date: 2014-02-02 Release Manager: Lukas Reichlin =============================================================================== ** hinfsyn, mixsyn By default, hinfsyn and mixsyn compute now an optimal instead of a suboptimal controller. Furthermore, Matlab compatibility is improved if hinfsyn/mixsyn is called with more than three/four input arguments. (Thanks to Thomas Vasileiou for the gamma iteration) The old behavior (sub-optimal controller) can be restored by the expressions hinfsyn (P, nmeas, ncont, 'method', 'sub') mixsyn (G, W1, W2, W3, 'method', 'sub') ** h2syn, hinfsyn, mixsyn, ncfsyn For Matlab compatibility, the third return argument is now norm "gamma". The info struct is now returned as fourth argument. [K, N, gamma, info] = *syn (G, …) ** mktito New function to partition plant for robust control. "mktito" is also used by function "augw". If a plant is partitioned that way, one can omit the inputs "nmeas" and "ncon" when calling the functions "hinfsyn" and "h2syn". ** ss The conversion of realizable descriptor systems to regular state-space form is now possible, even when the descriptor matrix "E" is singular. (Thanks to Thomas Vasileiou and Bruce Minaker) =============================================================================== control-2.6.1 Release Date: 2013-12-10 Release Manager: Lukas Reichlin =============================================================================== ** LTI models Raise an error if the user tries to create an ingroup or outgroup with indices larger than the number of inputs m or outputs p. ** thiran New function to approximate a continuous-time delay by a discrete-time allpass Thiran filter. (Thanks to Thomas Vasileiou and Spencer Jackson) ** end "end" indexing for LTI and IDDATA objects works now as expected. =============================================================================== control-2.6.0 Release Date: 2013-10-24 Release Manager: Lukas Reichlin =============================================================================== ** LTI models -- Support for name-based channel selection in various commands. Example: sys = Boeing707, sys('pitch', {'rudder', 'thrust'}) instead of sys(2, [2, 1]). -- New properties "ingroup" and "outgroup" to pool several channels: sys.ingroup.controls = [3, 1], sys.outgroup.measurements = [1, 2] sys('measurements', 'controls') instead of sys([1, 2], [3, 1]). -- Support names instead of indices in commands like "feedback" and "xperm". ** connect Support name-based interconnections. This means that the LTI models passed to "connect" will be interconnected automatically if they have their inputs and outputs named accordingly. ** sumblk New function to build summing junctions for name-based interconnections by "connect". Example: Sum = sumblk ('e = r - y + n') ** tf State-space to transfer function conversions of static gains, e.g. "tf (ss (5))", no longer error out. (Thanks to Thomas Vasileiou) ** IDDATA identification datasets Support for name-based output, input and experiment selection similar to LTI models. =============================================================================== control-2.4.5 Release Date: 2013-10-07 Release Manager: Lukas Reichlin =============================================================================== ** Compatibility to GNU Octave 3.8 Replaced line continuation marker "\" by "..." to avoid deprecated syntax warning. (Thanks to John W. Eaton) ** db2mag, mag2db New functions to convert Decibels to Magnitude and vice versa. ** d2d New function for resampling of discrete-time models. =============================================================================== control-2.4.4 Release Date: 2013-08-11 Release Manager: Lukas Reichlin =============================================================================== ** zero -- Fix documentation. Function "zero" computes the invariant zeros, not the transmission zeros when it is called with one input argument. -- Added new options to compute the system, transmission, input decoupling and output decoupling zeros besides the already existing invariant zeros. Examples: z = zero (sys, 'system'), z = zero (sys, 'transmission') -- Return an "info" struct as third output argument. It contains additional rank information as well as Kronecker indices and the numbers of infinite elementary divisors. Example: [z, k, info] = zero (sys) (Special thanks to Ferdinand Svaricek) ** resample The "resample" function for "iddata" identification datasets now handles unspecified sampling times (tsam = -1) correctly. ** Time response functions (impulse, initial, lsim, ramp, step) Fix a thinko introduced with control-2.4.3. In some cases, several responses were mistakingly plotted on the same subplot. (Thanks to Thomas Vasileiou) ** Various documentation enhancements and fixes. =============================================================================== control-2.4.3 Release Date: 2013-07-12 Release Manager: Lukas Reichlin =============================================================================== ** resample The resample function for iddata sets now adjusts the sampling time correctly after resampling. ** Time response functions (impulse, initial, lsim, ramp, step) Don't use subplot for SISO models. This allows the user to plot different responses on a single figure by calling subplot. (Thanks to Matthias Meier) ** h2syn, hinfsyn, mixsyn, ncfsyn Third return argument is now an info struct. [K, N, info] = *syn (G, …) ** optiPID Beef up documentation. =============================================================================== control-2.4.2 Release Date: 2013-02-16 Release Manager: Lukas Reichlin =============================================================================== ** Transfer function to state-space conversion (Thanks to Thomas Vasileiou): -- Fix crash. -- Fix bug if denominators are zero. ** minreal Fix crash in minreal for state-space systems. (Thanks to Thomas Vasileiou) ** sigma The plot types 1, 2, 3 were no longer supported since the introduction of multi-system plots in control-2.3.54. The help text is now updated accordingly and cruft is removed from the codebase. ** mixsyn, ncfsyn, Madievski Beef up help text. =============================================================================== control-2.4.1 Release Date: 2012-11-01 Release Manager: Lukas Reichlin =============================================================================== ** impulse, initial, lsim, step These time response functions now error out correctly when the user tries to plot multiple systems in one window with mismatching numbers of inputs and outputs. The problem was caused by Octave's built-in function "size_equal" which gave false positives for LTI objects. The problem is solved by overloading the built-in function with a new LTI method "size_equal". ** ramp Added a new time domain analysis function "ramp" which plots/computes the system's response to a ramp signal. ** c2d, d2c Added matched pole/zero discretization method "matched". Usage: Gd = c2d (Gc, Ts, 'matched'), Gc = d2c (Gd, 'matched') ** doc/control.pdf Revised PDF manual. There is now a function index at the end of the manual. Improved docstrings in several functions. =============================================================================== control-2.4.0 Release Date: 2012-09-26 Release Manager: Lukas Reichlin =============================================================================== ** Multiplot feature for time-domain plotting: impulse lsim initial step Supported are now function calls like impulse (sys1, sys2, ...), step (sys1, 'b', sys2, 'r', ...) lsim (sys1, '-k', sys2, '--k', u), initial (sys, sys2, x0) The multiplot feature for frequency-domain plotting has already been introduced with control-2.3.54. ** Anderson, Madievski, MDSSystem, optiPID Updated example scripts to use new multiplot feature. ** sensitivity Fixed a problem with plotting, introduced with control-2.3.54. ** doc/control.pdf Updated PDF manual. =============================================================================== control-2.3.54 Release Date: 2012-09-15 Release Manager: Lukas Reichlin =============================================================================== ** Multiplot feature for frequency-domain plotting: bode nichols pzmap bodemag nyquist sigma The functions above support calls like sigma (sys1, sys2, ...), nyquist (sys1, 'b', sys2, 'r', ...), bode (sys1, '-k', sys2, '-.k', sys3, ':k', {wmin, wmax}). Time domain functions are not yet multiplot ready, but they will follow in control-2.4.0. ** plot A selection of experiments from iddata identification datasets can be plotted by plot (dat, exp) instead of plot (dat(:,:,:,exp)). ** sensitivity Fixed a problem where an error was raised about an undefined function "issiso". ** All SLICOT function names have now leading and trailing underscores to emphasize their private nature. =============================================================================== control-2.3.53 Release Date: 2012-08-27 Release Manager: Lukas Reichlin =============================================================================== ** Added new functions for system identification, including: arx iddata ifft moen4 detrend nkshift moesp fft plot n4sid filter resample ** sensitivity Added new function to compute and plot the sensitivity margin Ms. ** feedback Fixed an argument check which caused false positive error messages. It was a copy-paste mistake affecting non-square systems. (Thanks to Tony Olivo) =============================================================================== control-2.3.52 Release Date: 2012-06-25 Release Manager: Lukas Reichlin =============================================================================== ** Fixed a silly mistake in MIMO transfer function to state-space conversion. The bug has been introduced with control-2.3.51. (Thanks to Jim Rawlings for providing the test case) ** dlqe, lqe Added new functions for linear quadratic estimators. (Thanks to Megan Zagrobelny) ** Upon request of the Debian maintainers, the tex-files control.tex and functions.texi for generating control.pdf are included in the doc folder, next to control.pdf. Note that functions.texi is generated automatically by the scripts in the control/devel folder and the package generate_html. They are not included in the control package and can be found on the OctaveForge SVN server. ** Minor improvements in various help texts. =============================================================================== control-2.3.51 Release Date: 2012-06-03 Release Manager: Lukas Reichlin =============================================================================== ** filt, filtdata, tf -- Added function "filt" to specify disrete-time transfer functions in DSP format, i.e. z^-1. -- Added function "filtdata" to return any type of discrete-time LTI model in DSP format. -- tf models have a new property "inv". To display a discrete-time TF sys in z^-1, set sys.inv=true. In order to switch to z, set sys.inv=false. "filt" sets property "inv" to true (z^-1) by default, while "tf" uses false (z) as default value. ** ctranspose Conjugate transpose or pertransposition of LTI objects. Used by Octave for "sys'". For a transfer-function matrix G, G' denotes the conjugate of G given by G.'(-s) for a continuous-time system or G.'(1/z) for a discrete-time system. The frequency response of the pertransposition of G is the Hermitian (conjugate) transpose of G(jw), i.e. freqresp (G', w) = freqresp (G, w)'. WARNING: Do NOT use this for dual problems, use the transpose "sys.'" (note the dot) instead. ** test_control Add a few remarks to the help text regarding the severity of failing tests. ** Makefile fixed to work with non-standard linker options e.g on Apple. ** The conversion to state-space of multi-input transfer functions with common row denominators is now handled more efficiently. =============================================================================== control-2.3.50 Release Date: 2012-03-06 Release Manager: Lukas Reichlin =============================================================================== ** Added new functions for frequency-weighted model and controller order reduction: bstmodred btaconred btamodred cfconred hnamodred fwcfconred spamodred spaconred ** Anderson, Madievski -- Added two examples for controller reduction. The m-files are named after the authors of the corresponding papers. ** fitfrd -- Added function to fit frequency response data with a state-space model. ** set -- The set command doesn't need a return argument anymore in order to save the modified values. set (sys, "key", value) is now equivalent to sys = set (sys, "key", value). ** Require Octave version 3.6.0 or better. (The frequency response plotting commands have been simplified. They now use the fixed "axis tight" command. This is a first step towards multiple systems in one plot, e.g. bode (sys1, sys2, sys3). Furthermore, the code takes advantage of the new "arrayfun" function which became a faster oct-file instead of an m-file) ** Revised package installation and cleanup efforts under the hood. The new solution compiles the SLICOT library in a less barbaric way and creates only a single oct-file containing all the SLICOT routines. This also brings along faster compile times. (Special thanks to Hans Buchmann, Carlo De Falco and Michael Goffioul for their advice) ** doc/control.pdf -- Extended PDF manual. =============================================================================== control-2.2.5 Release Date: 2012-02-09 Release Manager: Lukas Reichlin =============================================================================== ** Improved Matlab compatibility for frequency response commands. It is now possible to specify a frequency range. Example: bode (sys, {wmin, wmax}) where wmin and wmax denote frequencies in rad/s. ** margin -- Fixed a variable name such that discrete-time models are plotted without an error. (Thanks to Renato Caldas) =============================================================================== control-2.2.4 Release Date: 2012-01-07 Release Manager: Lukas Reichlin =============================================================================== ** Compatibility with Octave 3.6.0. (The makefile must specify the libraries that mkoctfile needs to link. Thanks to Marco Atzeri and Carlo De Falco) ** ctrbf, obsvf -- Added new functions to compute controllable and observable block Hessenberg realizations based on SLICOT TB01UD. (Thanks to Benjamin Fernandez and Alexandre Felipe) =============================================================================== control-2.2.3 Release Date: 2011-12-07 Release Manager: Lukas Reichlin =============================================================================== ** Improved performance when computing the frequency response of transfer function models by orders of magnitude. (I realized that "polyval" can evaluate a polynomial at several values at once in a vectorized manner.) ** bode, bodemag, nichols, sigma -- Fixed a hang when plotting pairs of purely imaginary poles or zeros. The hang was caused by nonsensical (Inf, NaN) axis values. (Reported by Laurent Tissier) ** Use single instead of double quotes when displaying names of TF and FRD models. =============================================================================== control-2.2.2 Release Date: 2011-12-04 Release Manager: Lukas Reichlin =============================================================================== ** Improved error messages for place, ARE solvers and robust control commands. ** minreal, ss -- Fixed a crash for descriptor models. minreal for dss models as well as conversion from non-proper transfer functions to descriptor state-space models should work now as expected. ** ss -- Revised default tolerance for transfer function to state-space conversion by SLICOT TD04AD. ** Better performance when computing the frequency response of SISO transfer function models. ** Reorganized tests. Most tests have been moved from "ltimodels" to the files of the LTI methods being tested. All available tests can be executed by "test_control". ** The NEWS file is handled correctly when using Octave version 3.6. Type "news("control")" or "news control" to display the news (3.6 only). =============================================================================== control-2.2.1 Release Date: 2011-10-24 Release Manager: Lukas Reichlin =============================================================================== ** tf -- Fixed a nasty bug that prevented shortening of numerator and denominator polynomials consisting solely of zeros. -- MIMO support for descriptor state-space to transfer function conversion. Usage: tf_sys = tf (dss_sys) -- MIMO support for interconnections of non-proper transfer functions via internal conversion to state-space. ** ss -- Support conversion from non-proper transfer function to descriptor state- space. Usage: dss_sys = ss (tf_sys) ** c2d, d2c -- Support bilinear transformation of descriptor state-space models. ** inv -- Support the inversion of MIMO transfer functions. Inverses of 2x2 TFs are computed directly, larger models are computed internally in state-space. ** place -- Return the number of fixed, assigned and uncontrollable poles in a single "info" struct instead of three individual output arguments. ** rlocus -- Clarify usage statement in help string. -- Check whether system is SISO. ** MDSSystem -- Display bode plots of controllers instead of singular value plots of the closed loops. ** hsvd -- Added option "alpha" to specify the alpha-stability boundary for the eigenvalues of the state dynamics matrix A. ** isctrb, isobsv -- Return number of controllable/observable states as a second output argument. ** doc/control.pdf -- Added preface to PDF manual. =============================================================================== control-2.2.0 Release Date: 2011-09-26 Release Manager: Lukas Reichlin =============================================================================== ** ss -- Transfer function to state-space conversion uses now SLICOT TD04AD. Conversion of MIMO models is now supported. Usage: ss_sys = ss (tf_sys) ** tf -- Support for interconnections of MIMO transfer functions. This is done by an internal conversion to a minimal state-space representation. With the current tf2ss and ss2tf conversions, only proper transfer function are supported. This limitation does not exist for SISO transfer functions. -- Fixed a cellfun statement that caused problems on MinGW32 builds and possibly some others. (Reported by Bernhard Weller) ** pole, zero -- Computation of poles and zeros of MIMO transfer functions is now possible via conversion to state-space. Please note that the state-space realization of SLICOT TD04AD is a minimal one. Therefore certain poles and zeros might be missing. ** zpk, zpkdata -- Included wrappers that create transfer function models from zero-pole-gain data (zpk) and zero-pole-gain data from lti models (zpkdata). They are stop-gap measures for compatibility until ZPK models are implemented. ** tfdata -- "vector" option added. For SISO models, it returns numerator and denominator directly as column vectors instead of cells containing a single column vector. ** doc/control.pdf -- Revised PDF manual. =============================================================================== control-2.1.55 Release Date: 2011-09-07 Release Manager: Lukas Reichlin =============================================================================== ** c2d -- Support for "tustin" and "prewarp" method added. -- Transfer functions are now supported via the state-space methods. -- Improved Texinfo string. ** d2c -- Discrete to continuous-time conversion added. However, support is limited to the zero-order hold, tustin and pre-warping methods. ** Conversion from descriptor to regular state-space is now performed by SLICOT routine SB10JD. Better numerical results are to be expected over the previous naive inversion formula. This conversion is used internally for ssdata and some other functions. =============================================================================== control-2.1.54 Release Date: 2011-08-22 Release Manager: Lukas Reichlin =============================================================================== ** tf -- State-space to transfer function conversion uses now SLICOT TB04BD. Conversion of MIMO models is now supported. Usage: tf_sys = tf (ss_sys) -- Display an empty line between title and numerator for better readability. -- Display whether model is static, continuous- or discrete-time. ** A PDF manual is included for the first time. It is located inside the "doc" folder. It has been generated automatically from the Texinfo help strings and is not yet completely sorted out. =============================================================================== control-2.1.53 Release Date: 2011-08-08 Release Manager: Lukas Reichlin =============================================================================== ** ncfsyn -- Added support for McFarlane/Glover loop shaping design procedure. "ncfsyn" stands for Normalized Coprime Factor Synthesis. ** MDSSystem -- Added example script which demonstrates the usage of the robust control commands "mixsyn" and "ncfsyn". ** Texinfo help strings of several functions have been extended, although documentation still leaves a lot to be desired. =============================================================================== control-2.1.52 Release Date: 2011-07-27 Release Manager: Lukas Reichlin =============================================================================== ** hsvd -- Use scaling unless state-space model property "scaled" is set to true. ** norm -- Use scaling for computation of L-infinity norm unless state-space model property "scaled" is set to true. ** minreal -- Use scaling for state-space and descriptor state-space models unless property "scaled" is set to true. -- More accurate results are to be expected for descriptor state-space models by performing only those reduction phases where effective order reduction occurs. This is achieved by saving the system matrices before each phase and restoring them if no order reduction took place. ** zero -- Use scaling for state-space and descriptor state-space models unless property "scaled" is set to true. ** frdata -- The frequency response is now returned correctly as an array and not as a vector, unless the "vector" option is set and the system is single-input single-output. -- Added help text. =============================================================================== control-2.1.51 Release Date: 2011-07-21 Release Manager: Lukas Reichlin =============================================================================== ** frd -- Support for Frequency Response Data (frd) measurement "models". =============================================================================== control-2.1.50 Release Date: 2011-07-06 Release Manager: Lukas Reichlin =============================================================================== ** ss -- Support for property "scaled". By default, it is set to "false". ** prescale -- Scaling for state-space models (SLICOT TB01ID) and descriptor models (SLICOT TG01AD). ** freqresp -- Scale state-space models using @lti/prescale.m if property "scaled" is set to "false". Frequency response commands now perform automatic scaling unless model property "scaled" is set to "true". =============================================================================== control-2.0.2 Release Date: 2011-03-18 Release Manager: Lukas Reichlin =============================================================================== ** lsim -- Fixed a logical error that refused valid initial state vectors. It was due to a thinko introduced with the changes in control-2.0.1. (Thanks to Rob Frohne) =============================================================================== control-2.0.1 Release Date: 2011-03-06 Release Manager: Lukas Reichlin =============================================================================== ** lsim -- Support time vectors not starting at zero. (Thanks to Rob Frohne) -- Improved help text. ** zero -- The gain of descriptor state-space models is now computed correctly. (fingers crossed) =============================================================================== control-2.0.0 Release Date: 2011-02-08 Release Manager: Lukas Reichlin =============================================================================== ** First official release. ===============================================================================