From 96868ec9c8592ff2f7fd3a9a4e3f2d7f6df9fcc0 Mon Sep 17 00:00:00 2001 From: Anthony De Bortoli Date: Fri, 28 Dec 2018 19:40:01 +0100 Subject: [PATCH 01/12] Add requirements.txt file --- requirements.txt | 4 ++++ 1 file changed, 4 insertions(+) create mode 100644 requirements.txt diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 000000000..fea59b9a4 --- /dev/null +++ b/requirements.txt @@ -0,0 +1,4 @@ +matplotlib +numpy +scipy +slycot \ No newline at end of file From d8e57780febfba31d2c33c8b7061e8c8b299e469 Mon Sep 17 00:00:00 2001 From: Anthony De Bortoli Date: Fri, 28 Dec 2018 19:40:33 +0100 Subject: [PATCH 02/12] Update run_all tests to make it run in pycharm --- control/tests/run_all.py | 19 ++++++++----------- 1 file changed, 8 insertions(+), 11 deletions(-) diff --git a/control/tests/run_all.py b/control/tests/run_all.py index b21248432..d713e7a3b 100755 --- a/control/tests/run_all.py +++ b/control/tests/run_all.py @@ -8,6 +8,7 @@ import re # regular expressions import os # operating system commands + def test_all(verbosity=0): """ Runs all tests written for python-control. """ @@ -15,16 +16,12 @@ def test_all(verbosity=0): start_dir = './' pattern = '*_test.py' top_level_dir = '../' - testModules = \ - unittest.defaultTestLoader.discover(start_dir, pattern=pattern, \ - top_level_dir=top_level_dir) - - for mod in test_mods: - print('Running tests in', mod) - tests = unittest.defaultTestLoader.loadTestFromModule(mod) + test_mods = unittest.defaultTestLoader.discover(start_dir, pattern=pattern, + top_level_dir=top_level_dir) + for suite in test_mods: + print("Running tests in: ", suite) t = unittest.TextTestRunner() - t.run(tests) - print('Completed tests in', mod) + t.run(suite) except: testModules = findTests('./tests/') @@ -33,8 +30,8 @@ def test_all(verbosity=0): for mod in testModules: print('Running tests in', mod) suiteList=[] # list of unittest.TestSuite objects - exec('import '+mod+' as currentModule') - + exec('import control.tests.'+mod+' as currentModule') + print(currentModule.suite()) try: currentSuite = currentModule.suite() if isinstance(currentSuite, unittest.TestSuite): From 7cd1d6527370ede3774d782d81724c808b2a21dc Mon Sep 17 00:00:00 2001 From: Anthony De Bortoli Date: Sat, 5 Jan 2019 15:15:06 +0100 Subject: [PATCH 03/12] [statefbk.py] Refactor style - Fix pep8 warnings - Clean some comments - Add module docstring --- control/statefbk.py | 227 +++++++++++++++++++++++--------------------- 1 file changed, 120 insertions(+), 107 deletions(-) diff --git a/control/statefbk.py b/control/statefbk.py index 0fb377a47..81eafca2b 100644 --- a/control/statefbk.py +++ b/control/statefbk.py @@ -1,10 +1,11 @@ -# statefbk.py - tools for state feedback control -# -# Author: Richard M. Murray, Roberto Bucher -# Date: 31 May 2010 -# -# This file contains routines for designing state space controllers -# +""" statefbk.py + +This file contains routines for designing state space controllers through state feedback control. +""" + +__author__ = "Richard M. Murray" +__contributor__ = "Roberto Bucher" + # Copyright (c) 2010 by California Institute of Technology # All rights reserved. # @@ -98,12 +99,15 @@ def place(A, B, p): # Convert the system inputs to NumPy arrays A_mat = np.array(A) B_mat = np.array(B) - if (A_mat.shape[0] != A_mat.shape[1]): - raise ControlDimension("A must be a square matrix") + if A_mat.shape[0] != A_mat.shape[1]: + raise ControlDimension("A must be a square matrix. " + "rows: {} != columns: {}".format(A_mat.shape[0], + A_mat.shape[1])) - if (A_mat.shape[0] != B_mat.shape[0]): - err_str = "The number of rows of A must equal the number of rows in B" - raise ControlDimension(err_str) + if A_mat.shape[0] != B_mat.shape[0]: + raise ControlDimension("The number of rows of A ({}) must equal " + "the number of rows in B ({})". format(A_mat.shape[0], + B_mat.shape[0])) # Convert desired poles to numpy array placed_eigs = np.array(p) @@ -171,14 +175,13 @@ def place_varga(A, B, p, dtime=False, alpha=None): try: from slycot import sb01bd except ImportError: - raise ControlSlycot("can't find slycot module 'sb01bd'") + raise ControlSlycot("Can't find slycot module 'sb01bd'.") # Convert the system inputs to NumPy arrays A_mat = np.array(A) B_mat = np.array(B) - if (A_mat.shape[0] != A_mat.shape[1] or - A_mat.shape[0] != B_mat.shape[0]): - raise ControlDimension("matrix dimensions are incorrect") + if A_mat.shape[0] != A_mat.shape[1] or A_mat.shape[0] != B_mat.shape[0]: + raise ControlDimension("Matrix dimensions are incorrect.") # Compute the system eigenvalues and convert poles to numpy array system_eigs = np.linalg.eig(A_mat)[0] @@ -186,13 +189,13 @@ def place_varga(A, B, p, dtime=False, alpha=None): # Need a character parameter for SB01BD if dtime: - DICO = 'D' + dico = 'D' else: - DICO = 'C' + dico = 'C' if alpha is None: # SB01BD ignores eigenvalues with real part less than alpha - # (if DICO='C') or with modulus less than alpha + # (if DICO = 'C') or with modulus less than alpha # (if DICO = 'D'). if dtime: # For discrete time, slycot only cares about modulus, so just make @@ -205,23 +208,24 @@ def place_varga(A, B, p, dtime=False, alpha=None): # the same as what slicot thinks are the eigs. So we need some # numerical breathing room. The following is pretty heuristic, # but does the trick - alpha = -2*abs(min(system_eigs.real)) + alpha = -2 * abs(min(system_eigs.real)) elif dtime and alpha < 0.0: - raise ValueError("Need alpha > 0 when DICO='D'") - + raise ValueError("Need alpha > 0 when DICO='D'.") # Call SLICOT routine to place the eigenvalues - A_z,w,nfp,nap,nup,F,Z = \ + A_z, w, nfp, nap, nup, F, Z = \ sb01bd(B_mat.shape[0], B_mat.shape[1], len(placed_eigs), alpha, - A_mat, B_mat, placed_eigs, DICO) + A_mat, B_mat, placed_eigs, dico) # Return the gain matrix, with MATLAB gain convention return -F -# Contributed by Roberto Bucher + def acker(A, B, poles): """Pole placement using Ackermann method + Contributed by Roberto Bucher + Call: K = acker(A, B, poles) @@ -237,7 +241,11 @@ def acker(A, B, poles): K: matrix Gains such that A - B K has given eigenvalues + See Also: + -------- + place, place_varga """ + # Convert the inputs to matrices a = np.mat(A) b = np.mat(B) @@ -245,22 +253,23 @@ def acker(A, B, poles): # Make sure the system is controllable ct = ctrb(A, B) if np.linalg.matrix_rank(ct) != a.shape[0]: - raise ValueError("System not reachable; pole placement invalid") + raise ValueError("System is not reachable, pole placement is invalid.") # Compute the desired characteristic polynomial p = np.real(np.poly(poles)) # Place the poles using Ackermann's method n = np.size(p) - pmat = p[n-1]*a**0 - for i in np.arange(1,n): - pmat = pmat + p[n-i-1]*a**i + pmat = p[n - 1] * a ** 0 + for i in np.arange(1, n): + pmat = pmat + p[n - i - 1] * a ** i K = np.linalg.solve(ct, pmat) - K = K[-1][:] # Extract the last row + K = K[-1][:] # Extract the last row return K -def lqr(*args, **keywords): + +def lqr(*args): """lqr(A, B, Q, R[, N]) Linear quadratic regulator design @@ -312,63 +321,64 @@ def lqr(*args, **keywords): from slycot import sb02md from slycot import sb02mt except ImportError: - raise ControlSlycot("can't find slycot module 'sb02md' or 'sb02nt'") + raise ControlSlycot("Can't find slycot module 'sb02md' or 'sb02nt'.") # # Process the arguments and figure out what inputs we received # # Get the system description - if (len(args) < 3): - raise ControlArgument("not enough input arguments") + if len(args) < 3: + raise ControlArgument("Not enough input arguments.") try: # If this works, we were (probably) passed a system as the # first argument; extract A and B - A = np.array(args[0].A, ndmin=2, dtype=float); - B = np.array(args[0].B, ndmin=2, dtype=float); - index = 1; + A = np.array(args[0].A, ndmin=2, dtype=float) + B = np.array(args[0].B, ndmin=2, dtype=float) + index = 1 except AttributeError: # Arguments should be A and B matrices - A = np.array(args[0], ndmin=2, dtype=float); - B = np.array(args[1], ndmin=2, dtype=float); - index = 2; + A = np.array(args[0], ndmin=2, dtype=float) + B = np.array(args[1], ndmin=2, dtype=float) + index = 2 # Get the weighting matrices (converting to matrices, if needed) - Q = np.array(args[index], ndmin=2, dtype=float); - R = np.array(args[index+1], ndmin=2, dtype=float); - if (len(args) > index + 2): - N = np.array(args[index+2], ndmin=2, dtype=float); + Q = np.array(args[index], ndmin=2, dtype=float) + R = np.array(args[index + 1], ndmin=2, dtype=float) + if len(args) > index + 2: + N = np.array(args[index + 2], ndmin=2, dtype=float) else: - N = np.zeros((Q.shape[0], R.shape[1])); + N = np.zeros((Q.shape[0], R.shape[1])) # Check dimensions for consistency - nstates = B.shape[0]; - ninputs = B.shape[1]; - if (A.shape[0] != nstates or A.shape[1] != nstates): - raise ControlDimension("inconsistent system dimensions") + nstates = B.shape[0] + ninputs = B.shape[1] + # TODO: Create / Figure out a generic function to check for inconsistent system + if A.shape[0] != nstates or A.shape[1] != nstates: + raise ControlDimension("Inconsistent system dimensions.") elif (Q.shape[0] != nstates or Q.shape[1] != nstates or R.shape[0] != ninputs or R.shape[1] != ninputs or N.shape[0] != nstates or N.shape[1] != ninputs): - raise ControlDimension("incorrect weighting matrix dimensions") + raise ControlDimension("Incorrect weighting matrix dimensions.") # Compute the G matrix required by SB02MD - A_b,B_b,Q_b,R_b,L_b,ipiv,oufact,G = \ - sb02mt(nstates, ninputs, B, R, A, Q, N, jobl='N'); + A_b, B_b, Q_b, R_b, L_b, ipiv, oufact, G = sb02mt(nstates, ninputs, B, R, A, Q, N, jobl='N') # Call the SLICOT function - X,rcond,w,S,U,A_inv = sb02md(nstates, A_b, G, Q_b, 'C') + X, rcond, w, S, U, A_inv = sb02md(nstates, A_b, G, Q_b, 'C') # Now compute the return value # We assume that R is positive definite and, hence, invertible - K = np.linalg.solve(R, np.dot(B.T, X) + N.T); - S = X; - E = w[0:nstates]; + K = np.linalg.solve(R, np.dot(B.T, X) + N.T) + S = X + E = w[0:nstates] return K, S, E -def ctrb(A,B): + +def ctrb(A, B): """Controllabilty matrix Parameters @@ -392,10 +402,11 @@ def ctrb(A,B): bmat = np.mat(B) n = np.shape(amat)[0] # Construct the controllability matrix - ctrb = bmat + C = bmat for i in range(1, n): - ctrb = np.hstack((ctrb, amat**i*bmat)) - return ctrb + C = np.hstack((C, amat ** i * bmat)) + return C + def obsv(A, C): """Observability matrix @@ -422,22 +433,24 @@ def obsv(A, C): n = np.shape(amat)[0] # Construct the controllability matrix - obsv = cmat + O = cmat for i in range(1, n): - obsv = np.vstack((obsv, cmat*amat**i)) - return obsv + O = np.vstack((O, cmat * amat ** i)) + return O + -def gram(sys,type): +def gram(sys, desired_computation_str): """Gramian (controllability or observability) Parameters ---------- sys: StateSpace State-space system to compute Gramian for - type: String + desired_computation_str: String Type of desired computation. - `type` is either 'c' (controllability) or 'o' (observability). To compute the - Cholesky factors of gramians use 'cf' (controllability) or 'of' (observability) + `desired_computation_str` is either 'c' (controllability) or 'o' (observability). + To compute the Cholesky factors of gramians use 'cf' (controllability) + or 'of' (observability) Returns ------- @@ -448,7 +461,7 @@ def gram(sys,type): ------ ValueError * if system is not instance of StateSpace class - * if `type` is not 'c', 'o', 'cf' or 'of' + * if `desired_computation_str` is not 'c', 'o', 'cf' or 'of' * if system is unstable (sys.A has eigenvalues not in left half plane) ImportError @@ -457,71 +470,71 @@ def gram(sys,type): Examples -------- - >>> Wc = gram(sys,'c') - >>> Wo = gram(sys,'o') - >>> Rc = gram(sys,'cf'), where Wc=Rc'*Rc - >>> Ro = gram(sys,'of'), where Wo=Ro'*Ro + >>> Wc = gram(sys, 'c') + >>> Wo = gram(sys, 'o') + >>> Rc = gram(sys, 'cf') #, where Wc = Rc' * Rc + >>> Ro = gram(sys, 'of') #, where Wo = Ro' * Ro """ - #Check for ss system object - if not isinstance(sys,statesp.StateSpace): + # Check for ss system object + if not isinstance(sys, statesp.StateSpace): raise ValueError("System must be StateSpace!") - if type not in ['c', 'o', 'cf', 'of']: + if desired_computation_str not in ['c', 'o', 'cf', 'of']: raise ValueError("That type is not supported!") - #TODO: Check for continous or discrete, only continuous supported right now - # if isCont(): - # dico = 'C' - # elif isDisc(): - # dico = 'D' - # else: + # TODO: Check for continuous or discrete, only continuous supported right now + # if isCont(): + # dico = 'C' + # elif isDisc(): + # dico = 'D' + # else: dico = 'C' - #TODO: Check system is stable, perhaps a utility in ctrlutil.py - # or a method of the StateSpace class? + # TODO: Check system is stable, perhaps a utility in ctrlutil.py + # or a method of the StateSpace class? if np.any(np.linalg.eigvals(sys.A).real >= 0.0): - raise ValueError("Oops, the system is unstable!") + raise ValueError("The system is unstable.") - if type=='c' or type=='o': - #Compute Gramian by the Slycot routine sb03md - #make sure Slycot is installed + if desired_computation_str == 'c' or desired_computation_str == 'o': + # Compute Gramian by the Slycot routine sb03md + # make sure Slycot is installed try: from slycot import sb03md except ImportError: - raise ControlSlycot("can't find slycot module 'sb03md'") - if type=='c': + raise ControlSlycot("Can't find slycot module 'sb03md'.") + if desired_computation_str == 'c': tra = 'T' - C = -np.dot(sys.B,sys.B.transpose()) - elif type=='o': + C = -np.dot(sys.B, sys.B.transpose()) + elif desired_computation_str == 'o': tra = 'N' - C = -np.dot(sys.C.transpose(),sys.C) + C = -np.dot(sys.C.transpose(), sys.C) n = sys.states - U = np.zeros((n,n)) - A = np.array(sys.A) # convert to NumPy array for slycot - X,scale,sep,ferr,w = sb03md(n, C, A, U, dico, job='X', fact='N', trana=tra) + U = np.zeros((n, n)) + A = np.array(sys.A) # convert to NumPy array for slycot + X, scale, sep, ferr, w = sb03md(n, C, A, U, dico, job='X', fact='N', trana=tra) gram = X return gram - elif type=='cf' or type=='of': - #Compute cholesky factored gramian from slycot routine sb03od + elif desired_computation_str == 'cf' or desired_computation_str == 'of': + # Compute cholesky factored gramian from slycot routine sb03od try: from slycot import sb03od except ImportError: - raise ControlSlycot("can't find slycot module 'sb03od'") - tra='N' + raise ControlSlycot("Can't find slycot module 'sb03od'.") + tra = 'N' n = sys.states - Q = np.zeros((n,n)) - A = np.array(sys.A) # convert to NumPy array for slycot - if type=='cf': + Q = np.zeros((n, n)) + A = np.array(sys.A) # convert to NumPy array for slycot + if desired_computation_str == 'cf': m = sys.B.shape[1] B = np.zeros_like(A) - B[0:m,0:n] = sys.B.transpose() - X,scale,w = sb03od(n, m, A.transpose(), Q, B, dico, fact='N', trans=tra) - elif type=='of': + B[0:m, 0:n] = sys.B.transpose() + X, scale, w = sb03od(n, m, A.transpose(), Q, B, dico, fact='N', trans=tra) + elif desired_computation_str == 'of': m = sys.C.shape[0] C = np.zeros_like(A) - C[0:n,0:m] = sys.C.transpose() - X,scale,w = sb03od(n, m, A, Q, C.transpose(), dico, fact='N', trans=tra) + C[0:n, 0:m] = sys.C.transpose() + X, scale, w = sb03od(n, m, A, Q, C.transpose(), dico, fact='N', trans=tra) gram = X return gram From aeb12f12c9d79ace6d0b708b157ac9f49af8e814 Mon Sep 17 00:00:00 2001 From: Anthony De Bortoli Date: Sat, 5 Jan 2019 15:33:20 +0100 Subject: [PATCH 04/12] [exception.py] Clean except case --- control/exception.py | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/control/exception.py b/control/exception.py index 2c4f29704..12d1bd859 100644 --- a/control/exception.py +++ b/control/exception.py @@ -39,32 +39,44 @@ # # $Id$ + class ControlSlycot(Exception): """Exception for Slycot import. Used when we can't import a function from the slycot package""" - pass + def __init__(self, error): + print("slycot import failed") + print(error) + class ControlDimension(Exception): """Raised when dimensions of system objects are not correct""" pass + class ControlArgument(Exception): """Raised when arguments to a function are not correct""" pass + class ControlMIMONotImplemented(Exception): """Function is not currently implemented for MIMO systems""" pass + class ControlNotImplemented(Exception): """Functionality is not yet implemented""" pass + # Utility function to see if slycot is installed def slycot_check(): try: import slycot - except: + except ImportError as error: + print(error) + return False + except Exception as exception: + print(exception, False) return False else: return True From ed7ea5155ab797d22cc1008c8fccb0125333cfb9 Mon Sep 17 00:00:00 2001 From: Anthony De Bortoli Date: Sat, 5 Jan 2019 16:58:50 +0100 Subject: [PATCH 05/12] [statefbk.py] Refactor place, induce change in API - Make place_varga protected -> _place_varga - Make acker protected -> _acker - place: Add optional arguments (alpha, dtime, method) - Add fallback strategy in case scipy or slycot are not found - Update docstrings - Update tests and remove pass condition in case which "slycot is not installed." - testPlace do not expect anymore a ValueError in case redundant place location is found. Instead, the algorithm fall back on the Ackermann method while printing a warning. TODO: Complete pole placement example when PR#267 is merged. --- control/statefbk.py | 105 +++++++++++++++++++++++---------- control/tests/matlab_test.py | 4 +- control/tests/statefbk_test.py | 25 ++++---- doc/control.rst | 1 - 4 files changed, 87 insertions(+), 48 deletions(-) diff --git a/control/statefbk.py b/control/statefbk.py index 81eafca2b..ed3686062 100644 --- a/control/statefbk.py +++ b/control/statefbk.py @@ -46,11 +46,11 @@ from . import statesp from .exception import ControlSlycot, ControlArgument, ControlDimension -__all__ = ['ctrb', 'obsv', 'gram', 'place', 'place_varga', 'lqr', 'acker'] +__all__ = ['ctrb', 'obsv', 'gram', 'place', 'lqr'] # Pole placement -def place(A, B, p): +def place(A, B, p, method="YT", dtime=False, alpha=None): """Place closed loop eigenvalues K = place(A, B, p) @@ -62,6 +62,19 @@ def place(A, B, p): Input matrix p : 1-d list Desired eigenvalue locations + method : string - optional + Method used for pole placement: {"YT", "KNV0", "varga", "acker"} + dtime: optional (useful only if method=="varga") + False for continuous time pole placement or True for discrete time. + The default is dtime=False. + alpha: double scalar (useful only if method=="varga") + If DICO='C', then _place_varga will leave the eigenvalues with real + real part less than alpha untouched. + If DICO='D', the _place_varga will leave eigenvalues with modulus + less than alpha untouched. + + By default (alpha=None), _place_varga computes alpha such that all + poles will be placed. Returns ------- @@ -92,32 +105,60 @@ def place(A, B, p): See Also -------- - place_varga, acker + _acker, _place_varga """ - from scipy.signal import place_poles - - # Convert the system inputs to NumPy arrays - A_mat = np.array(A) - B_mat = np.array(B) - if A_mat.shape[0] != A_mat.shape[1]: - raise ControlDimension("A must be a square matrix. " - "rows: {} != columns: {}".format(A_mat.shape[0], - A_mat.shape[1])) - - if A_mat.shape[0] != B_mat.shape[0]: - raise ControlDimension("The number of rows of A ({}) must equal " - "the number of rows in B ({})". format(A_mat.shape[0], - B_mat.shape[0])) - - # Convert desired poles to numpy array - placed_eigs = np.array(p) - - result = place_poles(A_mat, B_mat, placed_eigs, method='YT') - K = result.gain_matrix - return K - + if method == "acker": + return _acker(A, B, p) + if method == "varga": + try: + return _place_varga(A, B, p, dtime=dtime, alpha=alpha) + except ControlSlycot as error: + print("[Pole placement] Fallback strategy: using Tits-Yang method from scipy.") + return place(A, B, p) + else: + try: + from scipy.signal import place_poles + except ImportError as error: + print(error) + print("[Pole placement] Fallback strategy: using Varga method from slycot.") + try: + K = _place_varga(A, B, p, dtime=dtime, alpha=alpha) + return K + except ControlSlycot as error: + print("[Pole placement] Fallback strategy: using Ackermanm method.") + return _acker(A, B, p) + + # Convert the system inputs to NumPy arrays + A_mat = np.array(A) + B_mat = np.array(B) + if A_mat.shape[0] != A_mat.shape[1]: + raise ControlDimension("A must be a square matrix. " + "rows: {} != columns: {}".format(A_mat.shape[0], + A_mat.shape[1])) + + if A_mat.shape[0] != B_mat.shape[0]: + raise ControlDimension("The number of rows of A ({}) must equal " + "the number of rows in B ({})".format(A_mat.shape[0], + B_mat.shape[0])) + + # Convert desired poles to numpy array + placed_eigs = np.array(p) -def place_varga(A, B, p, dtime=False, alpha=None): + try: + result = place_poles(A_mat, B_mat, placed_eigs, method=method) + except ValueError as error: + print("[Pole placement] Redundant pole location. " + "Fallback strategy: using Ackermann method.") + try: + return _acker(A, B, p) + except ValueError as error: + print("Pole placement failed.") + return None + K = result.gain_matrix + return K + + +def _place_varga(A, B, p, dtime=False, alpha=None): """Place closed loop eigenvalues K = place_varga(A, B, p, dtime=False, alpha=None) @@ -164,18 +205,18 @@ def place_varga(A, B, p, dtime=False, alpha=None): -------- >>> A = [[-1, -1], [0, 1]] >>> B = [[0], [1]] - >>> K = place_varga(A, B, [-2, -5]) + >>> K = _place_varga(A, B, [-2, -5]) See Also: -------- - place, acker + place, _acker """ # Make sure that SLICOT is installed try: from slycot import sb01bd - except ImportError: - raise ControlSlycot("Can't find slycot module 'sb01bd'.") + except ImportError as error: + raise ControlSlycot(error) # Convert the system inputs to NumPy arrays A_mat = np.array(A) @@ -221,7 +262,7 @@ def place_varga(A, B, p, dtime=False, alpha=None): return -F -def acker(A, B, poles): +def _acker(A, B, poles): """Pole placement using Ackermann method Contributed by Roberto Bucher @@ -243,7 +284,7 @@ def acker(A, B, poles): See Also: -------- - place, place_varga + place, _place_varga """ # Convert the inputs to matrices diff --git a/control/tests/matlab_test.py b/control/tests/matlab_test.py index d187f6125..bcba99be1 100644 --- a/control/tests/matlab_test.py +++ b/control/tests/matlab_test.py @@ -402,13 +402,13 @@ def testModred(self): @unittest.skipIf(not slycot_check(), "slycot not installed") def testPlace_varga(self): - place_varga(self.siso_ss1.A, self.siso_ss1.B, [-2, -2]) + place(self.siso_ss1.A, self.siso_ss1.B, [-2, -2], method="varga") def testPlace(self): place(self.siso_ss1.A, self.siso_ss1.B, [-2, -2.5]) def testAcker(self): - acker(self.siso_ss1.A, self.siso_ss1.B, [-2, -2.5]) + place(self.siso_ss1.A, self.siso_ss1.B, [-2, -2.5], method="acker") @unittest.skipIf(not slycot_check(), "slycot not installed") diff --git a/control/tests/statefbk_test.py b/control/tests/statefbk_test.py index 66dce2b12..1b9112db4 100644 --- a/control/tests/statefbk_test.py +++ b/control/tests/statefbk_test.py @@ -6,7 +6,7 @@ from __future__ import print_function import unittest import numpy as np -from control.statefbk import ctrb, obsv, place, place_varga, lqr, gram, acker +from control.statefbk import ctrb, obsv, place, _place_varga, lqr, gram, _acker from control.matlab import * from control.exception import slycot_check, ControlDimension from control.mateqn import care, dare @@ -144,7 +144,7 @@ def testAcker(self): poles = pole(des) # Now place the poles using acker - K = acker(sys.A, sys.B, poles) + K = _acker(sys.A, sys.B, poles) new = ss(sys.A - sys.B * K, sys.B, sys.C, sys.D) placed = pole(new) @@ -184,9 +184,10 @@ def testPlace(self): # Check that we get an error if we ask for too many poles in the same # location. Here, rank(B) = 2, so lets place three at the same spot. P_repeated = np.array([-0.5, -0.5, -0.5, -8.6659]) - np.testing.assert_raises(ValueError, place, A, B, P_repeated) - @unittest.skipIf(not slycot_check(), "slycot not installed") + # Error not raised anymore as fallback solution is implemented. + # np.testing.assert_raises(ValueError, place, A, B, P_repeated) + def testPlace_varga_continuous(self): """ Check that we can place eigenvalues for dtime=False @@ -195,7 +196,7 @@ def testPlace_varga_continuous(self): B = np.array([[5.], [7.]]) P = np.array([-2., -2.]) - K = place_varga(A, B, P) + K = _place_varga(A, B, P) P_placed = np.linalg.eigvals(A - B.dot(K)) # No guarantee of the ordering, so sort them P.sort() @@ -211,7 +212,7 @@ def testPlace_varga_continuous(self): A = np.array([[0, 1], [100, 0]]) B = np.array([[0], [1]]) P = np.array([-20 + 10*1j, -20 - 10*1j]) - K = place_varga(A, B, P) + K = place(A, B, P, method="varga") P_placed = np.linalg.eigvals(A - B.dot(K)) # No guarantee of the ordering, so sort them @@ -219,7 +220,6 @@ def testPlace_varga_continuous(self): P_placed.sort() np.testing.assert_array_almost_equal(P, P_placed) - @unittest.skipIf(not slycot_check(), "slycot not installed") def testPlace_varga_continuous_partial_eigs(self): """ Check that we are able to use the alpha parameter to only place @@ -233,7 +233,7 @@ def testPlace_varga_continuous_partial_eigs(self): P = np.array([-3.]) P_expected = np.array([-2.0, -3.0]) alpha = -1.5 - K = place_varga(A, B, P, alpha=alpha) + K = place(A, B, P, method="varga", alpha=alpha) P_placed = np.linalg.eigvals(A - B.dot(K)) # No guarantee of the ordering, so sort them @@ -241,7 +241,6 @@ def testPlace_varga_continuous_partial_eigs(self): P_placed.sort() np.testing.assert_array_almost_equal(P_expected, P_placed) - @unittest.skipIf(not slycot_check(), "slycot not installed") def testPlace_varga_discrete(self): """ Check that we can place poles using dtime=True (discrete time) @@ -250,14 +249,13 @@ def testPlace_varga_discrete(self): B = np.array([[5.], [7.]]) P = np.array([0.5, 0.5]) - K = place_varga(A, B, P, dtime=True) + K = place(A, B, P, method="varga", dtime=True) P_placed = np.linalg.eigvals(A - B.dot(K)) # No guarantee of the ordering, so sort them P.sort() P_placed.sort() np.testing.assert_array_almost_equal(P, P_placed) - @unittest.skipIf(not slycot_check(), "slycot not installed") def testPlace_varga_discrete_partial_eigs(self): """" Check that we can only assign a single eigenvalue in the discrete @@ -270,7 +268,7 @@ def testPlace_varga_discrete_partial_eigs(self): P = np.array([0.2, 0.6]) P_expected = np.array([0.5, 0.6]) alpha = 0.51 - K = place_varga(A, B, P, dtime=True, alpha=alpha) + K = place(A, B, P, method="varga", dtime=True, alpha=alpha) P_placed = np.linalg.eigvals(A - B.dot(K)) P_expected.sort() P_placed.sort() @@ -331,7 +329,8 @@ def test_dare(self): def test_suite(): - return unittest.TestLoader().loadTestsFromTestCase(TestStatefbk) + return unittest.TestLoader().loadTestsFromTestCase(TestStatefbk) + if __name__ == '__main__': unittest.main() diff --git a/doc/control.rst b/doc/control.rst index 1d0b14644..c3c248655 100644 --- a/doc/control.rst +++ b/doc/control.rst @@ -108,7 +108,6 @@ Control system synthesis .. autosummary:: :toctree: generated/ - acker h2syn hinfsyn lqr From 14fa3a6123e28fefe310287af2f32449339d95ca Mon Sep 17 00:00:00 2001 From: Anthony De Bortoli Date: Sat, 5 Jan 2019 18:09:48 +0100 Subject: [PATCH 06/12] [statefbk_test.py] Fix pep8 warnings --- control/tests/statefbk_test.py | 55 +++++++++++++++++----------------- 1 file changed, 27 insertions(+), 28 deletions(-) diff --git a/control/tests/statefbk_test.py b/control/tests/statefbk_test.py index 1b9112db4..65d5b9181 100644 --- a/control/tests/statefbk_test.py +++ b/control/tests/statefbk_test.py @@ -11,6 +11,7 @@ from control.exception import slycot_check, ControlDimension from control.mateqn import care, dare + class TestStatefbk(unittest.TestCase): """Test state feedback functions""" @@ -28,38 +29,38 @@ def testCtrbSISO(self): A = np.matrix("1. 2.; 3. 4.") B = np.matrix("5.; 7.") Wctrue = np.matrix("5. 19.; 7. 43.") - Wc = ctrb(A,B) + Wc = ctrb(A, B) np.testing.assert_array_almost_equal(Wc, Wctrue) def testCtrbMIMO(self): A = np.matrix("1. 2.; 3. 4.") B = np.matrix("5. 6.; 7. 8.") Wctrue = np.matrix("5. 6. 19. 22.; 7. 8. 43. 50.") - Wc = ctrb(A,B) + Wc = ctrb(A, B) np.testing.assert_array_almost_equal(Wc, Wctrue) def testObsvSISO(self): A = np.matrix("1. 2.; 3. 4.") C = np.matrix("5. 7.") Wotrue = np.matrix("5. 7.; 26. 38.") - Wo = obsv(A,C) + Wo = obsv(A, C) np.testing.assert_array_almost_equal(Wo, Wotrue) def testObsvMIMO(self): A = np.matrix("1. 2.; 3. 4.") C = np.matrix("5. 6.; 7. 8.") Wotrue = np.matrix("5. 6.; 7. 8.; 23. 34.; 31. 46.") - Wo = obsv(A,C) + Wo = obsv(A, C) np.testing.assert_array_almost_equal(Wo, Wotrue) def testCtrbObsvDuality(self): A = np.matrix("1.2 -2.3; 3.4 -4.5") B = np.matrix("5.8 6.9; 8. 9.1") - Wc = ctrb(A,B); + Wc = ctrb(A, B); A = np.transpose(A) C = np.transpose(B) - Wo = np.transpose(obsv(A,C)); - np.testing.assert_array_almost_equal(Wc,Wo) + Wo = np.transpose(obsv(A, C)); + np.testing.assert_array_almost_equal(Wc, Wo) @unittest.skipIf(not slycot_check(), "slycot not installed") def testGramWc(self): @@ -69,7 +70,7 @@ def testGramWc(self): D = np.matrix("13. 14.; 15. 16.") sys = ss(A, B, C, D) Wctrue = np.matrix("18.5 24.5; 24.5 32.5") - Wc = gram(sys,'c') + Wc = gram(sys, 'c') np.testing.assert_array_almost_equal(Wc, Wctrue) @unittest.skipIf(not slycot_check(), "slycot not installed") @@ -80,7 +81,7 @@ def testGramRc(self): D = np.matrix("13. 14.; 15. 16.") sys = ss(A, B, C, D) Rctrue = np.matrix("4.30116263 5.6961343; 0. 0.23249528") - Rc = gram(sys,'cf') + Rc = gram(sys, 'cf') np.testing.assert_array_almost_equal(Rc, Rctrue) @unittest.skipIf(not slycot_check(), "slycot not installed") @@ -91,7 +92,7 @@ def testGramWo(self): D = np.matrix("13. 14.; 15. 16.") sys = ss(A, B, C, D) Wotrue = np.matrix("257.5 -94.5; -94.5 56.5") - Wo = gram(sys,'o') + Wo = gram(sys, 'o') np.testing.assert_array_almost_equal(Wo, Wotrue) @unittest.skipIf(not slycot_check(), "slycot not installed") @@ -100,9 +101,9 @@ def testGramWo2(self): B = np.matrix("5.; 7.") C = np.matrix("6. 8.") D = np.matrix("9.") - sys = ss(A,B,C,D) + sys = ss(A, B, C, D) Wotrue = np.matrix("198. -72.; -72. 44.") - Wo = gram(sys,'o') + Wo = gram(sys, 'o') np.testing.assert_array_almost_equal(Wo, Wotrue) @unittest.skipIf(not slycot_check(), "slycot not installed") @@ -113,13 +114,13 @@ def testGramRo(self): D = np.matrix("13. 14.; 15. 16.") sys = ss(A, B, C, D) Rotrue = np.matrix("16.04680654 -5.8890222; 0. 4.67112593") - Ro = gram(sys,'of') + Ro = gram(sys, 'of') np.testing.assert_array_almost_equal(Ro, Rotrue) def testGramsys(self): - num =[1.] + num = [1.] den = [1., 1., 1.] - sys = tf(num,den) + sys = tf(num, den) self.assertRaises(ValueError, gram, sys, 'o') self.assertRaises(ValueError, gram, sys, 'c') @@ -160,16 +161,16 @@ def testAcker(self): def testPlace(self): # Matrices shamelessly stolen from scipy example code. - A = np.array([[1.380, -0.2077, 6.715, -5.676], - [-0.5814, -4.290, 0, 0.6750], - [1.067, 4.273, -6.654, 5.893], - [0.0480, 4.273, 1.343, -2.104]]) - - B = np.array([[0, 5.679], - [1.136, 1.136], - [0, 0,], - [-3.146, 0]]) - P = np.array([-0.5+1j, -0.5-1j, -5.0566, -8.6659]) + A = np.array([[1.380, -0.2077, 6.715, -5.676], + [-0.5814, -4.290, 0, 0.6750], + [1.067, 4.273, -6.654, 5.893], + [0.0480, 4.273, 1.343, -2.104]]) + + B = np.array([[0, 5.679], + [1.136, 1.136], + [0, 0, ], + [-3.146, 0]]) + P = np.array([-0.5 + 1j, -0.5 - 1j, -5.0566, -8.6659]) K = place(A, B, P) P_placed = np.linalg.eigvals(A - B.dot(K)) # No guarantee of the ordering, so sort them @@ -211,7 +212,7 @@ def testPlace_varga_continuous(self): # https://github.com/python-control/python-control/issues/177 A = np.array([[0, 1], [100, 0]]) B = np.array([[0], [1]]) - P = np.array([-20 + 10*1j, -20 - 10*1j]) + P = np.array([-20 + 10 * 1j, -20 - 10 * 1j]) K = place(A, B, P, method="varga") P_placed = np.linalg.eigvals(A - B.dot(K)) @@ -274,7 +275,6 @@ def testPlace_varga_discrete_partial_eigs(self): P_placed.sort() np.testing.assert_array_almost_equal(P_expected, P_placed) - def check_LQR(self, K, S, poles, Q, R): S_expected = np.array(np.sqrt(Q * R)) K_expected = S_expected / R @@ -283,7 +283,6 @@ def check_LQR(self, K, S, poles, Q, R): np.testing.assert_array_almost_equal(K, K_expected) np.testing.assert_array_almost_equal(poles, poles_expected) - @unittest.skipIf(not slycot_check(), "slycot not installed") def test_LQR_integrator(self): A, B, Q, R = 0., 1., 10., 2. From e26f9cca206b0d1c6f63f0ebc651459acd4ecf1e Mon Sep 17 00:00:00 2001 From: Anthony De Bortoli Date: Sat, 5 Jan 2019 18:51:55 +0100 Subject: [PATCH 07/12] [test_statefbk.py] Clean style and remove matrix usage --- .../{statefbk_test.py => test_statefbk.py} | 167 +++++++++--------- 1 file changed, 83 insertions(+), 84 deletions(-) rename control/tests/{statefbk_test.py => test_statefbk.py} (74%) diff --git a/control/tests/statefbk_test.py b/control/tests/test_statefbk.py similarity index 74% rename from control/tests/statefbk_test.py rename to control/tests/test_statefbk.py index 65d5b9181..a3c04a29e 100644 --- a/control/tests/statefbk_test.py +++ b/control/tests/test_statefbk.py @@ -1,6 +1,6 @@ #!/usr/bin/env python # -# statefbk_test.py - test state feedback functions +# test_statefbk.py - test state feedback functions # RMM, 30 Mar 2011 (based on TestStatefbk from v0.4a) from __future__ import print_function @@ -25,118 +25,117 @@ def setUp(self): # get consistent test results np.random.seed(0) - def testCtrbSISO(self): - A = np.matrix("1. 2.; 3. 4.") - B = np.matrix("5.; 7.") - Wctrue = np.matrix("5. 19.; 7. 43.") - Wc = ctrb(A, B) + # 2 states SISO system + self.A_siso = np.array([[1., -2.], + [3., -4.]]) + self.B_siso = np.array([[5.], [7.]]) + self.C_siso = np.array([6., 8.]) + self.D_siso = np.array([9.]) + self.sys_siso = ss(self.A_siso, self.B_siso, self.C_siso, self.D_siso) + + # 2 states MIMO (2 inputs, 2 outputs) system + self.A_mimo = np.array([[1., -2.], + [3., -4.]]) + self.B_mimo = np.array([[5., 6.], + [7., 8.]]) + self.C_mimo = np.array([[4., 5.], + [6., 7.]]) + self.D_mimo = np.array([[13., 14.], + [15., 16.]]) + self.sys_mimo = ss(self.A_mimo, self.B_mimo, self.C_mimo, self.D_mimo) + + def test_ctrb_siso(self): + Wctrue = np.array([[5., -9.], + [7., -13.]]) + Wc = ctrb(self.A_siso, self.B_siso) np.testing.assert_array_almost_equal(Wc, Wctrue) - def testCtrbMIMO(self): - A = np.matrix("1. 2.; 3. 4.") - B = np.matrix("5. 6.; 7. 8.") - Wctrue = np.matrix("5. 6. 19. 22.; 7. 8. 43. 50.") - Wc = ctrb(A, B) + def test_ctrb_mimo(self): + Wctrue = np.array([[5., 6., -9., -10.], + [7., 8., -13., -14.]]) + Wc = ctrb(self.A_mimo, self.B_mimo) np.testing.assert_array_almost_equal(Wc, Wctrue) - def testObsvSISO(self): - A = np.matrix("1. 2.; 3. 4.") - C = np.matrix("5. 7.") - Wotrue = np.matrix("5. 7.; 26. 38.") - Wo = obsv(A, C) + def test_obsv_siso(self): + Wotrue = np.array([[6., 8.], + [30., -44.]]) + Wo = obsv(self.A_siso, self.C_siso) np.testing.assert_array_almost_equal(Wo, Wotrue) - def testObsvMIMO(self): - A = np.matrix("1. 2.; 3. 4.") - C = np.matrix("5. 6.; 7. 8.") - Wotrue = np.matrix("5. 6.; 7. 8.; 23. 34.; 31. 46.") - Wo = obsv(A, C) + def test_obsv_mimo(self): + Wotrue = np.array([[4., 5.], + [6., 7.], + [19., -28.], + [27., -40.]]) + Wo = obsv(self.A_mimo, self.C_mimo) np.testing.assert_array_almost_equal(Wo, Wotrue) - def testCtrbObsvDuality(self): - A = np.matrix("1.2 -2.3; 3.4 -4.5") - B = np.matrix("5.8 6.9; 8. 9.1") - Wc = ctrb(A, B); + def test_ctrb_obsv_duality(self): + A = np.array([[1.2, -2.3], + [3.4, -4.5]]) + B = np.array([[5.8, 6.9], + [8., 9.1]]) + Wc = ctrb(A, B) A = np.transpose(A) C = np.transpose(B) - Wo = np.transpose(obsv(A, C)); + Wo = np.transpose(obsv(A, C)) np.testing.assert_array_almost_equal(Wc, Wo) @unittest.skipIf(not slycot_check(), "slycot not installed") - def testGramWc(self): - A = np.matrix("1. -2.; 3. -4.") - B = np.matrix("5. 6.; 7. 8.") - C = np.matrix("4. 5.; 6. 7.") - D = np.matrix("13. 14.; 15. 16.") - sys = ss(A, B, C, D) - Wctrue = np.matrix("18.5 24.5; 24.5 32.5") - Wc = gram(sys, 'c') + def test_gram_wc(self): + Wctrue = np.array([[18.5, 24.5], + [24.5, 32.5]]) + Wc = gram(self.sys_mimo, 'c') np.testing.assert_array_almost_equal(Wc, Wctrue) @unittest.skipIf(not slycot_check(), "slycot not installed") - def testGramRc(self): - A = np.matrix("1. -2.; 3. -4.") - B = np.matrix("5. 6.; 7. 8.") - C = np.matrix("4. 5.; 6. 7.") - D = np.matrix("13. 14.; 15. 16.") - sys = ss(A, B, C, D) - Rctrue = np.matrix("4.30116263 5.6961343; 0. 0.23249528") - Rc = gram(sys, 'cf') + def test_gram_rc(self): + Rctrue = np.array([[4.30116263, 5.6961343], + [0., 0.23249528]]) + Rc = gram(self.sys_mimo, 'cf') np.testing.assert_array_almost_equal(Rc, Rctrue) @unittest.skipIf(not slycot_check(), "slycot not installed") - def testGramWo(self): - A = np.matrix("1. -2.; 3. -4.") - B = np.matrix("5. 6.; 7. 8.") - C = np.matrix("4. 5.; 6. 7.") - D = np.matrix("13. 14.; 15. 16.") - sys = ss(A, B, C, D) - Wotrue = np.matrix("257.5 -94.5; -94.5 56.5") - Wo = gram(sys, 'o') + def test_gram_wo(self): + Wotrue = np.array([[257.5, -94.5], + [-94.5, 56.5]]) + Wo = gram(self.sys_mimo, 'o') np.testing.assert_array_almost_equal(Wo, Wotrue) @unittest.skipIf(not slycot_check(), "slycot not installed") - def testGramWo2(self): - A = np.matrix("1. -2.; 3. -4.") - B = np.matrix("5.; 7.") - C = np.matrix("6. 8.") - D = np.matrix("9.") - sys = ss(A, B, C, D) - Wotrue = np.matrix("198. -72.; -72. 44.") - Wo = gram(sys, 'o') + def test_gram_wo2(self): + Wotrue = np.array([[198., -72.], + [-72., 44.]]) + Wo = gram(self.sys_siso, 'o') np.testing.assert_array_almost_equal(Wo, Wotrue) @unittest.skipIf(not slycot_check(), "slycot not installed") - def testGramRo(self): - A = np.matrix("1. -2.; 3. -4.") - B = np.matrix("5. 6.; 7. 8.") - C = np.matrix("4. 5.; 6. 7.") - D = np.matrix("13. 14.; 15. 16.") - sys = ss(A, B, C, D) - Rotrue = np.matrix("16.04680654 -5.8890222; 0. 4.67112593") - Ro = gram(sys, 'of') + def test_gram_ro(self): + Rotrue = np.array([[16.04680654, -5.8890222], + [0., 4.67112593]]) + Ro = gram(self.sys_mimo, 'of') np.testing.assert_array_almost_equal(Ro, Rotrue) - def testGramsys(self): + def test_gram_sys(self): num = [1.] den = [1., 1., 1.] sys = tf(num, den) self.assertRaises(ValueError, gram, sys, 'o') self.assertRaises(ValueError, gram, sys, 'c') - def testAcker(self): + def test_acker(self): for states in range(1, self.maxStates): for i in range(self.maxTries): # start with a random SS system and transform to TF then # back to SS, check that the matrices are the same. sys = rss(states, 1, 1) - if (self.debug): + if self.debug: print(sys) # Make sure the system is not degenerate Cmat = ctrb(sys.A, sys.B) if np.linalg.matrix_rank(Cmat) != states: - if (self.debug): + if self.debug: print(" skipping (not reachable or ill conditioned)") continue @@ -159,7 +158,7 @@ def testAcker(self): np.testing.assert_array_almost_equal(np.sort(poles), np.sort(placed), decimal=4) - def testPlace(self): + def test_place(self): # Matrices shamelessly stolen from scipy example code. A = np.array([[1.380, -0.2077, 6.715, -5.676], [-0.5814, -4.290, 0, 0.6750], @@ -189,12 +188,12 @@ def testPlace(self): # Error not raised anymore as fallback solution is implemented. # np.testing.assert_raises(ValueError, place, A, B, P_repeated) - def testPlace_varga_continuous(self): + def test_place_varga_continuous(self): """ Check that we can place eigenvalues for dtime=False """ - A = np.array([[1., -2.], [3., -4.]]) - B = np.array([[5.], [7.]]) + A = self.A_siso + B = self.B_siso P = np.array([-2., -2.]) K = _place_varga(A, B, P) @@ -221,15 +220,15 @@ def testPlace_varga_continuous(self): P_placed.sort() np.testing.assert_array_almost_equal(P, P_placed) - def testPlace_varga_continuous_partial_eigs(self): + def test_pleace_varga_continuous_partial_eigs(self): """ Check that we are able to use the alpha parameter to only place a subset of the eigenvalues, for the continous time case. """ # A matrix has eigenvalues at s=-1, and s=-2. Choose alpha = -1.5 # and check that eigenvalue at s=-2 stays put. - A = np.array([[1., -2.], [3., -4.]]) - B = np.array([[5.], [7.]]) + A = self.A_siso + B = self.B_siso P = np.array([-3.]) P_expected = np.array([-2.0, -3.0]) @@ -242,7 +241,7 @@ def testPlace_varga_continuous_partial_eigs(self): P_placed.sort() np.testing.assert_array_almost_equal(P_expected, P_placed) - def testPlace_varga_discrete(self): + def test_place_varga_discrete(self): """ Check that we can place poles using dtime=True (discrete time) """ @@ -257,7 +256,7 @@ def testPlace_varga_discrete(self): P_placed.sort() np.testing.assert_array_almost_equal(P, P_placed) - def testPlace_varga_discrete_partial_eigs(self): + def test_place_varga_discrete_partial_eigs(self): """" Check that we can only assign a single eigenvalue in the discrete time case. @@ -275,7 +274,7 @@ def testPlace_varga_discrete_partial_eigs(self): P_placed.sort() np.testing.assert_array_almost_equal(P_expected, P_placed) - def check_LQR(self, K, S, poles, Q, R): + def check_lqr(self, K, S, poles, Q, R): S_expected = np.array(np.sqrt(Q * R)) K_expected = S_expected / R poles_expected = np.array([-K_expected]) @@ -284,17 +283,17 @@ def check_LQR(self, K, S, poles, Q, R): np.testing.assert_array_almost_equal(poles, poles_expected) @unittest.skipIf(not slycot_check(), "slycot not installed") - def test_LQR_integrator(self): + def test_lqr_integrator(self): A, B, Q, R = 0., 1., 10., 2. K, S, poles = lqr(A, B, Q, R) - self.check_LQR(K, S, poles, Q, R) + self.check_lqr(K, S, poles, Q, R) @unittest.skipIf(not slycot_check(), "slycot not installed") - def test_LQR_3args(self): + def test_lqr_3args(self): sys = ss(0., 1., 1., 0.) Q, R = 10., 2. K, S, poles = lqr(sys, Q, R) - self.check_LQR(K, S, poles, Q, R) + self.check_lqr(K, S, poles, Q, R) @unittest.skipIf(not slycot_check(), "slycot not installed") def test_care(self): From 707f6fc19dc4f0c53d09d7872f2369e1f51101ec Mon Sep 17 00:00:00 2001 From: Anthony De Bortoli Date: Sat, 5 Jan 2019 20:49:08 +0100 Subject: [PATCH 08/12] Test place with varga method only if slycot is installed --- control/tests/test_statefbk.py | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/control/tests/test_statefbk.py b/control/tests/test_statefbk.py index a3c04a29e..d8fde0c03 100644 --- a/control/tests/test_statefbk.py +++ b/control/tests/test_statefbk.py @@ -188,6 +188,7 @@ def test_place(self): # Error not raised anymore as fallback solution is implemented. # np.testing.assert_raises(ValueError, place, A, B, P_repeated) + @unittest.skipIf(not slycot_check(), "slycot not installed") def test_place_varga_continuous(self): """ Check that we can place eigenvalues for dtime=False @@ -220,6 +221,7 @@ def test_place_varga_continuous(self): P_placed.sort() np.testing.assert_array_almost_equal(P, P_placed) + @unittest.skipIf(not slycot_check(), "slycot not installed") def test_pleace_varga_continuous_partial_eigs(self): """ Check that we are able to use the alpha parameter to only place @@ -241,6 +243,7 @@ def test_pleace_varga_continuous_partial_eigs(self): P_placed.sort() np.testing.assert_array_almost_equal(P_expected, P_placed) + @unittest.skipIf(not slycot_check(), "slycot not installed") def test_place_varga_discrete(self): """ Check that we can place poles using dtime=True (discrete time) @@ -256,6 +259,7 @@ def test_place_varga_discrete(self): P_placed.sort() np.testing.assert_array_almost_equal(P, P_placed) + @unittest.skipIf(not slycot_check(), "slycot not installed") def test_place_varga_discrete_partial_eigs(self): """" Check that we can only assign a single eigenvalue in the discrete From 89e5c7bb9bfc7635c2f47235f8a386d2e5142b4a Mon Sep 17 00:00:00 2001 From: Anthony De Bortoli Date: Mon, 7 Jan 2019 22:40:38 +0100 Subject: [PATCH 09/12] [pvtol-lqr] Fix pep8 warnings --- examples/pvtol-lqr.py | 185 ++++++++++++++++++++++-------------------- 1 file changed, 99 insertions(+), 86 deletions(-) diff --git a/examples/pvtol-lqr.py b/examples/pvtol-lqr.py index 8412dc2ff..fa9acf265 100644 --- a/examples/pvtol-lqr.py +++ b/examples/pvtol-lqr.py @@ -9,9 +9,9 @@ import os -from numpy import * # Grab all of the NumPy functions -from matplotlib.pyplot import * # Grab MATLAB plotting functions -from control.matlab import * # MATLAB-like functions +from numpy import * # Grab all of the NumPy functions +from matplotlib.pyplot import * # Grab MATLAB plotting functions +from control.matlab import * # MATLAB-like functions # # System dynamics @@ -21,31 +21,31 @@ # # System parameters -m = 4; # mass of aircraft -J = 0.0475; # inertia around pitch axis -r = 0.25; # distance to center of force -g = 9.8; # gravitational constant -c = 0.05; # damping factor (estimated) +m = 4 # mass of aircraft +J = 0.0475 # inertia around pitch axis +r = 0.25 # distance to center of force +g = 9.8 # gravitational constant +c = 0.05 # damping factor (estimated) # State space dynamics -xe = [0, 0, 0, 0, 0, 0]; # equilibrium point of interest -ue = [0, m*g]; # (note these are lists, not matrices) +xe = [0, 0, 0, 0, 0, 0] # equilibrium point of interest +ue = [0, m * g] # (note these are lists, not matrices) # Dynamics matrix (use matrix type so that * works for multiplication) A = matrix( - [[ 0, 0, 0, 1, 0, 0], - [ 0, 0, 0, 0, 1, 0], - [ 0, 0, 0, 0, 0, 1], - [ 0, 0, (-ue[0]*sin(xe[2]) - ue[1]*cos(xe[2]))/m, -c/m, 0, 0], - [ 0, 0, (ue[0]*cos(xe[2]) - ue[1]*sin(xe[2]))/m, 0, -c/m, 0], - [ 0, 0, 0, 0, 0, 0 ]]) + [[0, 0, 0, 1, 0, 0], + [0, 0, 0, 0, 1, 0], + [0, 0, 0, 0, 0, 1], + [0, 0, (-ue[0] * sin(xe[2]) - ue[1] * cos(xe[2])) / m, -c / m, 0, 0], + [0, 0, (ue[0] * cos(xe[2]) - ue[1] * sin(xe[2])) / m, 0, -c / m, 0], + [0, 0, 0, 0, 0, 0]]) # Input matrix B = matrix( - [[0, 0], [0, 0], [0, 0], - [cos(xe[2])/m, -sin(xe[2])/m], - [sin(xe[2])/m, cos(xe[2])/m], - [r/J, 0]]) + [[0, 0], [0, 0], [0, 0], + [cos(xe[2]) / m, -sin(xe[2]) / m], + [sin(xe[2]) / m, cos(xe[2]) / m], + [r / J, 0]]) # Output matrix C = matrix([[1, 0, 0, 0, 0, 0], [0, 1, 0, 0, 0, 0]]) @@ -69,8 +69,8 @@ # so that xd corresponds to the desired steady state. # -xd = matrix([[1], [0], [0], [0], [0], [0]]); -yd = matrix([[0], [1], [0], [0], [0], [0]]); +xd = matrix([[1], [0], [0], [0], [0], [0]]) +yd = matrix([[0], [1], [0], [0], [0], [0]]) # # Extract the relevant dynamics for use with SISO library @@ -83,18 +83,22 @@ # # Indices for the parts of the state that we want -lat = (0,2,3,5); -alt = (1,4); +lat = (0, 2, 3, 5) +alt = (1, 4) # Decoupled dynamics -Ax = (A[lat, :])[:, lat]; #! not sure why I have to do it this way -Bx = B[lat, 0]; Cx = C[0, lat]; Dx = D[0, 0]; +Ax = (A[lat, :])[:, lat] # ! not sure why I have to do it this way +Bx = B[lat, 0] +Cx = C[0, lat] +Dx = D[0, 0] -Ay = (A[alt, :])[:, alt]; #! not sure why I have to do it this way -By = B[alt, 1]; Cy = C[1, alt]; Dy = D[1, 1]; +Ay = (A[alt, :])[:, alt] # ! not sure why I have to do it this way +By = B[alt, 1] +Cy = C[1, alt] +Dy = D[1, 1] # Label the plot -clf(); +clf() suptitle("LQR controllers for vectored thrust aircraft (pvtol-lqr)") # @@ -102,72 +106,81 @@ # # Start with a diagonal weighting -Qx1 = diag([1, 1, 1, 1, 1, 1]); -Qu1a = diag([1, 1]); -(K, X, E) = lqr(A, B, Qx1, Qu1a); K1a = matrix(K); +Qx1 = diag([1, 1, 1, 1, 1, 1]) +Qu1a = diag([1, 1]) +(K, X, E) = lqr(A, B, Qx1, Qu1a) +K1a = matrix(K) # Close the loop: xdot = Ax - B K (x-xd) # Note: python-control requires we do this 1 input at a time -# H1a = ss(A-B*K1a, B*K1a*concatenate((xd, yd), axis=1), C, D); -# (T, Y) = step(H1a, T=linspace(0,10,100)); +# H1a = ss(A-B*K1a, B*K1a*concatenate((xd, yd), axis=1), C, D) +# (T, Y) = step(H1a, T=linspace(0,10,100)) # Step response for the first input -H1ax = ss(Ax - Bx*K1a[0,lat], Bx*K1a[0,lat]*xd[lat,:], Cx, Dx); -(Yx, Tx) = step(H1ax, T=linspace(0,10,100)); +H1ax = ss(Ax - Bx * K1a[0, lat], Bx * K1a[0, lat] * xd[lat, :], Cx, Dx) +(Yx, Tx) = step(H1ax, T=linspace(0, 10, 100)) # Step response for the second input -H1ay = ss(Ay - By*K1a[1,alt], By*K1a[1,alt]*yd[alt,:], Cy, Dy); -(Yy, Ty) = step(H1ay, T=linspace(0,10,100)); +H1ay = ss(Ay - By * K1a[1, alt], By * K1a[1, alt] * yd[alt, :], Cy, Dy) +(Yy, Ty) = step(H1ay, T=linspace(0, 10, 100)) -subplot(221); title("Identity weights") -# plot(T, Y[:,1, 1], '-', T, Y[:,2, 2], '--'); -plot(Tx.T, Yx.T, '-', Ty.T, Yy.T, '--'); -plot([0, 10], [1, 1], 'k-'); +subplot(221) +title("Identity weights") +# plot(T, Y[:,1, 1], '-', T, Y[:,2, 2], '--') +plot(Tx.T, Yx.T, '-', Ty.T, Yy.T, '--') +plot([0, 10], [1, 1], 'k-') -axis([0, 10, -0.1, 1.4]); -ylabel('position'); -legend(('x', 'y'), loc='lower right'); +axis([0, 10, -0.1, 1.4]) +ylabel('position') +legend(('x', 'y'), loc='lower right') # Look at different input weightings -Qu1a = diag([1, 1]); (K1a, X, E) = lqr(A, B, Qx1, Qu1a); -H1ax = ss(Ax - Bx*K1a[0,lat], Bx*K1a[0,lat]*xd[lat,:], Cx, Dx); +Qu1a = diag([1, 1]) +(K1a, X, E) = lqr(A, B, Qx1, Qu1a) +H1ax = ss(Ax - Bx * K1a[0, lat], Bx * K1a[0, lat] * xd[lat, :], Cx, Dx) -Qu1b = (40**2)*diag([1, 1]); (K1b, X, E) = lqr(A, B, Qx1, Qu1b); -H1bx = ss(Ax - Bx*K1b[0,lat], Bx*K1b[0,lat]*xd[lat,:],Cx, Dx); +Qu1b = (40 ** 2) * diag([1, 1]) +(K1b, X, E) = lqr(A, B, Qx1, Qu1b) +H1bx = ss(Ax - Bx * K1b[0, lat], Bx * K1b[0, lat] * xd[lat, :], Cx, Dx) -Qu1c = (200**2)*diag([1, 1]); (K1c, X, E) = lqr(A, B, Qx1, Qu1c); -H1cx = ss(Ax - Bx*K1c[0,lat], Bx*K1c[0,lat]*xd[lat,:],Cx, Dx); +Qu1c = (200 ** 2) * diag([1, 1]) +(K1c, X, E) = lqr(A, B, Qx1, Qu1c) +H1cx = ss(Ax - Bx * K1c[0, lat], Bx * K1c[0, lat] * xd[lat, :], Cx, Dx) -[Y1, T1] = step(H1ax, T=linspace(0,10,100)); -[Y2, T2] = step(H1bx, T=linspace(0,10,100)); -[Y3, T3] = step(H1cx, T=linspace(0,10,100)); +[Y1, T1] = step(H1ax, T=linspace(0, 10, 100)) +[Y2, T2] = step(H1bx, T=linspace(0, 10, 100)) +[Y3, T3] = step(H1cx, T=linspace(0, 10, 100)) -subplot(222); title("Effect of input weights") -plot(T1.T, Y1.T, 'b-'); -plot(T2.T, Y2.T, 'b-'); -plot(T3.T, Y3.T, 'b-'); -plot([0 ,10], [1, 1], 'k-'); +subplot(222) +title("Effect of input weights") +plot(T1.T, Y1.T, 'b-') +plot(T2.T, Y2.T, 'b-') +plot(T3.T, Y3.T, 'b-') +plot([0, 10], [1, 1], 'k-') -axis([0, 10, -0.1, 1.4]); +axis([0, 10, -0.1, 1.4]) -# arcarrow([1.3, 0.8], [5, 0.45], -6); -text(5.3, 0.4, 'rho'); +# arcarrow([1.3, 0.8], [5, 0.45], -6) +text(5.3, 0.4, 'rho') # Output weighting - change Qx to use outputs -Qx2 = C.T * C; -Qu2 = 0.1 * diag([1, 1]); -(K, X, E) = lqr(A, B, Qx2, Qu2); K2 = matrix(K) - -H2x = ss(Ax - Bx*K2[0,lat], Bx*K2[0,lat]*xd[lat,:], Cx, Dx); -H2y = ss(Ay - By*K2[1,alt], By*K2[1,alt]*yd[alt,:], Cy, Dy); - -subplot(223); title("Output weighting") -[Y2x, T2x] = step(H2x, T=linspace(0,10,100)); -[Y2y, T2y] = step(H2y, T=linspace(0,10,100)); +Qx2 = C.T * C +Qu2 = 0.1 * diag([1, 1]) +(K, X, E) = lqr(A, B, Qx2, Qu2) +K2 = matrix(K) + +H2x = ss(Ax - Bx * K2[0, lat], Bx * K2[0, lat] * xd[lat, :], Cx, Dx) +H2y = ss(Ay - By * K2[1, alt], By * K2[1, alt] * yd[alt, :], Cy, Dy) + +subplot(223) +title("Output weighting") +[Y2x, T2x] = step(H2x, T=linspace(0, 10, 100)) +[Y2y, T2y] = step(H2y, T=linspace(0, 10, 100)) plot(T2x.T, Y2x.T, T2y.T, Y2y.T) -ylabel('position'); -xlabel('time'); ylabel('position'); -legend(('x', 'y'), loc='lower right'); +ylabel('position') +xlabel('time') +ylabel('position') +legend(('x', 'y'), loc='lower right') # # Physically motivated weighting @@ -177,21 +190,21 @@ # due to loss in efficiency. # -Qx3 = diag([100, 10, 2*pi/5, 0, 0, 0]); -Qu3 = 0.1 * diag([1, 10]); -(K, X, E) = lqr(A, B, Qx3, Qu3); K3 = matrix(K); +Qx3 = diag([100, 10, 2 * pi / 5, 0, 0, 0]) +Qu3 = 0.1 * diag([1, 10]) +(K, X, E) = lqr(A, B, Qx3, Qu3) +K3 = matrix(K) -H3x = ss(Ax - Bx*K3[0,lat], Bx*K3[0,lat]*xd[lat,:], Cx, Dx); -H3y = ss(Ay - By*K3[1,alt], By*K3[1,alt]*yd[alt,:], Cy, Dy); +H3x = ss(Ax - Bx * K3[0, lat], Bx * K3[0, lat] * xd[lat, :], Cx, Dx) +H3y = ss(Ay - By * K3[1, alt], By * K3[1, alt] * yd[alt, :], Cy, Dy) subplot(224) -# step(H3x, H3y, 10); -[Y3x, T3x] = step(H3x, T=linspace(0,10,100)); -[Y3y, T3y] = step(H3y, T=linspace(0,10,100)); +# step(H3x, H3y, 10) +[Y3x, T3x] = step(H3x, T=linspace(0, 10, 100)) +[Y3y, T3y] = step(H3y, T=linspace(0, 10, 100)) plot(T3x.T, Y3x.T, T3y.T, Y3y.T) title("Physically motivated weights") -xlabel('time'); -legend(('x', 'y'), loc='lower right'); +xlabel('time') +legend(('x', 'y'), loc='lower right') if 'PYCONTROL_TEST_EXAMPLES' not in os.environ: show() - From a1b74210f19493eb55dedf42e8ab81f42f864611 Mon Sep 17 00:00:00 2001 From: Anthony De Bortoli Date: Mon, 7 Jan 2019 23:35:00 +0100 Subject: [PATCH 10/12] [pvtol-lqr-nested.ipynb] Clean example --- examples/pvtol-lqr-nested.ipynb | 580 +++++++++++++++++++++++++++++++- 1 file changed, 579 insertions(+), 1 deletion(-) diff --git a/examples/pvtol-lqr-nested.ipynb b/examples/pvtol-lqr-nested.ipynb index bb9a51b07..daad7c1c9 100644 --- a/examples/pvtol-lqr-nested.ipynb +++ b/examples/pvtol-lqr-nested.ipynb @@ -1 +1,579 @@ -{"nbformat_minor": 0, "cells": [{"source": "#`python-control` Example: Vertical takeoff and landing aircraft\n\nhttp://www.cds.caltech.edu/~murray/wiki/index.php/Python-control/Example:_Vertical_takeoff_and_landing_aircraft\n\nThis page demonstrates the use of the python-control package for analysis and design of a controller for a vectored thrust aircraft model that is used as a running example through the text *Feedback Systems* by Astrom and Murray. This example makes use of MATLAB compatible commands. ", "cell_type": "markdown", "metadata": {}}, {"source": "##System Description\nThis example uses a simplified model for a (planar) vertical takeoff and landing aircraft (PVTOL), as shown below:\n \n\nThe position and orientation of the center of mass of the aircraft is denoted by $(x,y,\\theta)$, $m$ is the mass of the vehicle, $J$ the moment of inertia, $g$ the gravitational constant and $c$ the damping coefficient. The forces generated by the main downward thruster and the maneuvering thrusters are modeled as a pair of forces $F_1$ and $F_2$ acting at a distance $r$ below the aircraft (determined by the geometry of the thrusters).\n\nIt is convenient to redefine the inputs so that the origin is an equilibrium point of the system with zero input. Letting $u_1 =\nF_1$ and $u_2 = F_2 - mg$, the equations can be written in state space form as:\n\n\n##LQR state feedback controller\nThis section demonstrates the design of an LQR state feedback controller for the vectored thrust aircraft example. This example is pulled from Chapter 6 (State Feedback) of [http:www.cds.caltech.edu/~murray/amwiki Astrom and Murray]. The python code listed here are contained the the file pvtol-lqr.py.\n\nTo execute this example, we first import the libraries for SciPy, MATLAB plotting and the python-control package:", "cell_type": "markdown", "metadata": {}}, {"execution_count": 1, "cell_type": "code", "source": "from numpy import * # Grab all of the NumPy functions\nfrom matplotlib.pyplot import * # Grab MATLAB plotting functions\nfrom control.matlab import * # MATLAB-like functions\n%matplotlib inline", "outputs": [], "metadata": {"collapsed": true, "trusted": true}}, {"source": "The parameters for the system are given by", "cell_type": "markdown", "metadata": {}}, {"execution_count": 2, "cell_type": "code", "source": "m = 4; # mass of aircraft\nJ = 0.0475; # inertia around pitch axis\nr = 0.25; # distance to center of force\ng = 9.8; # gravitational constant\nc = 0.05; # damping factor (estimated)\nprint \"m = %f\" % m\nprint \"J = %f\" % J\nprint \"r = %f\" % r\nprint \"g = %f\" % g\nprint \"c = %f\" % c", "outputs": [{"output_type": "stream", "name": "stdout", "text": "m = 4.000000\nJ = 0.047500\nr = 0.250000\ng = 9.800000\nc = 0.050000\n"}], "metadata": {"collapsed": false, "trusted": true}}, {"source": "The linearization of the dynamics near the equilibrium point $x_e = (0, 0, 0, 0, 0, 0)$, $u_e = (0, mg)$ are given by", "cell_type": "markdown", "metadata": {}}, {"execution_count": 3, "cell_type": "code", "source": "# State space dynamics\nxe = [0, 0, 0, 0, 0, 0]; # equilibrium point of interest\nue = [0, m*g]; # (note these are lists, not matrices)", "outputs": [], "metadata": {"collapsed": true, "trusted": true}}, {"execution_count": 4, "cell_type": "code", "source": "# Dynamics matrix (use matrix type so that * works for multiplication)\nA = matrix(\n [[ 0, 0, 0, 1, 0, 0],\n [ 0, 0, 0, 0, 1, 0],\n [ 0, 0, 0, 0, 0, 1],\n [ 0, 0, (-ue[0]*sin(xe[2]) - ue[1]*cos(xe[2]))/m, -c/m, 0, 0],\n [ 0, 0, (ue[0]*cos(xe[2]) - ue[1]*sin(xe[2]))/m, 0, -c/m, 0],\n [ 0, 0, 0, 0, 0, 0 ]])\n\n# Input matrix\nB = matrix(\n [[0, 0], [0, 0], [0, 0],\n [cos(xe[2])/m, -sin(xe[2])/m],\n [sin(xe[2])/m, cos(xe[2])/m],\n [r/J, 0]])\n\n# Output matrix \nC = matrix([[1, 0, 0, 0, 0, 0], [0, 1, 0, 0, 0, 0]])\nD = matrix([[0, 0], [0, 0]])", "outputs": [], "metadata": {"collapsed": true, "trusted": true}}, {"source": "To compute a linear quadratic regulator for the system, we write the cost function as\n\n\nwhere $z = z - z_e$ and $v = u - u_e$ represent the local coordinates around the desired equilibrium point $(z_e, u_e)$. We begin with diagonal matrices for the state and input costs:", "cell_type": "markdown", "metadata": {}}, {"execution_count": 5, "cell_type": "code", "source": "Qx1 = diag([1, 1, 1, 1, 1, 1]);\nQu1a = diag([1, 1]);\n(K, X, E) = lqr(A, B, Qx1, Qu1a); K1a = matrix(K);", "outputs": [], "metadata": {"collapsed": true, "trusted": true}}, {"source": "This gives a control law of the form $v = -K z$, which can then be used to derive the control law in terms of the original variables:\n\n\n $$u = v + u_d = - K(z - z_d) + u_d.$$\nwhere $u_d = (0, mg)$ and $z_d = (x_d, y_d, 0, 0, 0, 0)$\n\nSince the `python-control` package only supports SISO systems, in order to compute the closed loop dynamics, we must extract the dynamics for the lateral and altitude dynamics as individual systems. In addition, we simulate the closed loop dynamics using the step command with $K x_d$ as the input vector (assumes that the \"input\" is unit size, with $xd$ corresponding to the desired steady state. The following code performs these operations:", "cell_type": "markdown", "metadata": {}}, {"execution_count": 6, "cell_type": "code", "source": "xd = matrix([[1], [0], [0], [0], [0], [0]]); \nyd = matrix([[0], [1], [0], [0], [0], [0]]); ", "outputs": [], "metadata": {"collapsed": true, "trusted": true}}, {"execution_count": 7, "cell_type": "code", "source": "# Indices for the parts of the state that we want\nlat = (0,2,3,5);\nalt = (1,4);\n\n# Decoupled dynamics\nAx = (A[lat, :])[:, lat]; #! not sure why I have to do it this way\nBx = B[lat, 0]; Cx = C[0, lat]; Dx = D[0, 0];\n \nAy = (A[alt, :])[:, alt]; #! not sure why I have to do it this way\nBy = B[alt, 1]; Cy = C[1, alt]; Dy = D[1, 1];\n\n# Step response for the first input\nH1ax = ss(Ax - Bx*K1a[0,lat], Bx*K1a[0,lat]*xd[lat,:], Cx, Dx);\n(Tx, Yx) = step(H1ax, T=linspace(0,10,100));\n\n# Step response for the second input\nH1ay = ss(Ay - By*K1a[1,alt], By*K1a[1,alt]*yd[alt,:], Cy, Dy);\n(Ty, Yy) = step(H1ay, T=linspace(0,10,100));", "outputs": [], "metadata": {"collapsed": true, "trusted": true}}, {"execution_count": 8, "cell_type": "code", "source": "plot(Yx.T, Tx, '-', Yy.T, Ty, '--'); hold(True);\nplot([0, 10], [1, 1], 'k-'); hold(True);\nylabel('Position');\nxlabel('Time (s)');\ntitle('Step Response for Inputs');\nlegend(('Yx', 'Yy'), loc='lower right');", "outputs": [{"output_type": "display_data", "data": {"image/png": "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\n6v8DfENdKxw8Sq0AAAAASUVORK5CYII=\n", "text/plain": ""}, "metadata": {}}], "metadata": {"collapsed": false, "trusted": true}}, {"source": "The plot above shows the $x$ and $y$ positions of the aircraft when it is commanded to move 1 m in each direction. The following shows the $x$ motion for control weights $\\rho = 1, 10^2, 10^4$. A higher weight of the input term in the cost function causes a more sluggish response. It is created using the code:", "cell_type": "markdown", "metadata": {}}, {"execution_count": 9, "cell_type": "code", "source": "# Look at different input weightings\nQu1a = diag([1, 1]); (K1a, X, E) = lqr(A, B, Qx1, Qu1a);\nH1ax = ss(Ax - Bx*K1a[0,lat], Bx*K1a[0,lat]*xd[lat,:], Cx, Dx);\n\nQu1b = (40**2)*diag([1, 1]); (K1b, X, E) = lqr(A, B, Qx1, Qu1b);\nH1bx = ss(Ax - Bx*K1b[0,lat], Bx*K1b[0,lat]*xd[lat,:],Cx, Dx);\n\nQu1c = (200**2)*diag([1, 1]); (K1c, X, E) = lqr(A, B, Qx1, Qu1c);\nH1cx = ss(Ax - Bx*K1c[0,lat], Bx*K1c[0,lat]*xd[lat,:],Cx, Dx);\n\n[T1, Y1] = step(H1ax, T=linspace(0,10,100));\n[T2, Y2] = step(H1bx, T=linspace(0,10,100));\n[T3, Y3] = step(H1cx, T=linspace(0,10,100));", "outputs": [], "metadata": {"collapsed": true, "trusted": true}}, {"execution_count": 10, "cell_type": "code", "source": "plot(Y1.T, T1, 'b-'); hold(True);\nplot(Y2.T, T2, 'r-'); hold(True);\nplot(Y3.T, T3, 'g-'); hold(True);\nplot([0 ,10], [1, 1], 'k-'); hold(True);\ntitle('Step Response for Inputs');\nylabel('Position');\nxlabel('Time (s)');\nlegend(('Y1','Y2','Y3'),loc='lower right');\naxis([0, 10, -0.1, 1.4]); ", "outputs": [{"output_type": "display_data", "data": {"image/png": "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\ni76yKeGdswAAAABJRU5ErkJggg==\n", "text/plain": ""}, "metadata": {}}], "metadata": {"collapsed": false, "trusted": true}}, {"source": "##Lateral control using inner/outer loop design\nThis section demonstrates the design of loop shaping controller for the vectored thrust aircraft example. This example is pulled from Chapter 11 [Frequency Domain Design](http:www.cds.caltech.edu/~murray/amwiki) of Astrom and Murray. \n\nTo design a controller for the lateral dynamics of the vectored thrust aircraft, we make use of a \"inner/outer\" loop design methodology. We begin by representing the dynamics using the block diagram\n\n\nwhere\n \nThe controller is constructed by splitting the process dynamics and controller into two components: an inner loop consisting of the roll dynamics $P_i$ and control $C_i$ and an outer loop consisting of the lateral position dynamics $P_o$ and controller $C_o$.\n\nThe closed inner loop dynamics $H_i$ control the roll angle of the aircraft using the vectored thrust while the outer loop controller $C_o$ commands the roll angle to regulate the lateral position.\n\nThe following code imports the libraries that are required and defines the dynamics:", "cell_type": "markdown", "metadata": {}}, {"execution_count": 11, "cell_type": "code", "source": "from matplotlib.pyplot import * # Grab MATLAB plotting functions\nfrom control.matlab import * # MATLAB-like functions", "outputs": [], "metadata": {"collapsed": true, "trusted": true}}, {"execution_count": 12, "cell_type": "code", "source": "# System parameters\nm = 4; # mass of aircraft\nJ = 0.0475; # inertia around pitch axis\nr = 0.25; # distance to center of force\ng = 9.8; # gravitational constant\nc = 0.05; # damping factor (estimated)\nprint \"m = %f\" % m\nprint \"J = %f\" % J\nprint \"r = %f\" % r\nprint \"g = %f\" % g\nprint \"c = %f\" % c", "outputs": [{"output_type": "stream", "name": "stdout", "text": "m = 4.000000\nJ = 0.047500\nr = 0.250000\ng = 9.800000\nc = 0.050000\n"}], "metadata": {"collapsed": false, "trusted": true}}, {"execution_count": 13, "cell_type": "code", "source": "# Transfer functions for dynamics\nPi = tf([r], [J, 0, 0]); # inner loop (roll)\nPo = tf([1], [m, c, 0]); # outer loop (position)", "outputs": [], "metadata": {"collapsed": true, "trusted": true}}, {"source": "For the inner loop, use a lead compensator", "cell_type": "markdown", "metadata": {}}, {"execution_count": 14, "cell_type": "code", "source": "k = 200; a = 2; b = 50\nCi = k*tf([1, a], [1, b]) # lead compensator\nLi = Pi*Ci", "outputs": [], "metadata": {"collapsed": true, "trusted": true}}, {"source": "The closed loop dynamics of the inner loop, $H_i$, are given by", "cell_type": "markdown", "metadata": {}}, {"execution_count": 15, "cell_type": "code", "source": "Hi = parallel(feedback(Ci, Pi), -m*g*feedback(Ci*Pi, 1));", "outputs": [], "metadata": {"collapsed": true, "trusted": true}}, {"source": "Finally, we design the lateral compensator using another lead compenstor", "cell_type": "markdown", "metadata": {}}, {"execution_count": 16, "cell_type": "code", "source": "# Now design the lateral control system\na = 0.02; b = 5; K = 2;\nCo = -K*tf([1, 0.3], [1, 10]); # another lead compensator\nLo = -m*g*Po*Co;", "outputs": [], "metadata": {"collapsed": true, "trusted": true}}, {"source": "The performance of the system can be characterized using the sensitivity function and the complementary sensitivity function:", "cell_type": "markdown", "metadata": {}}, {"execution_count": 17, "cell_type": "code", "source": "L = Co*Hi*Po;\nS = feedback(1, L);\nT = feedback(L, 1);", "outputs": [], "metadata": {"collapsed": true, "trusted": true}}, {"execution_count": 18, "cell_type": "code", "source": "t, y = step(T,T=linspace(0,10,100))\nplot(y, t)\ntitle(\"Step Response\")\ngrid()\nxlabel(\"time (s)\")\nylabel(\"y(t)\")", "outputs": [{"execution_count": 18, "output_type": "execute_result", "data": {"text/plain": ""}, "metadata": {}}, {"output_type": "display_data", "data": {"image/png": "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\n", "text/plain": ""}, "metadata": {}}], "metadata": {"collapsed": false, "trusted": true}}, {"source": "The frequency response and Nyquist plot for the loop transfer function are computed using the commands", "cell_type": "markdown", "metadata": {}}, {"execution_count": 19, "cell_type": "code", "source": "bode(L);", "outputs": [{"output_type": "display_data", "data": {"image/png": "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\nGZxzH3gVd6cS60xK0lf0tb1b+prkH3p91ekVdHIdxq3S1A1h6kzb30npS24MG78Tjh8DvB8u3A/m\nezOc+ReJC2HfZ2HazfbdF7Sir0l4VKwzyc6nqEPuVNp9M7lN0i8lrS9poqQjgNslzQ9tv5J2atHj\nCNOd3L7MbKNs0zIVX27u8tVlGoWr0mbWOW+HXOXL0Nfkmnnpir5a+UeTvgZaZ9bL0yZVtj36Epxw\nV/YmsyN8/Iuw17bwqW8Dr8C6n4Ffny5xlcS+sP27Yd6bG2nJEa55v/Xw+2uUp/C9x+t/jwfmtKkp\n7b6ZTAZ2A/bKwtcA/4/UkHyszToLr3wPgmA0cOsz2cyyi6Qtr4S3zw8PjQEmwXZfhe3fIHEucBEs\n/zT89d/l2jtKcMF50+0e/KdPrnmAe7L4+Uit5Ypt1OsO2DaxSJ56adXxjcJ5zrulrSx9RbV1U1+e\nuGHWV09rJ3+bndO3ybbgXcHngZ9Of390IHixdr+7Xuor8dniItraejORtDzwQ2AlYIEs2raXy1m+\nKyvfK+o/jvDNVTOct3xZ+gZ1TGHY9VWnV9CPvrneZnMI8Cvp3R+HHd4PK6wPzJbO/Cvc8wd479UN\n6hsVYyYV9ZXqm+sa4ADgIOCTpG6vsc4GzbqFpC1I61MWITU2l9bIY8fU4CAIqpBYCNiU5Jl8U5Lf\nv1OAM22eKtO2fqDos7PdxuRG22tJmuW560RutF1rMWPHkbQo8DPbu9RIi8YkCIKGSCwIfIK0lu1j\nwBWkhuU8m+fKtK0sij472x2Af0FpkeHdWdfUw8BCeQur4Ap4YH/S1r716j+Ogt1ctg9plH8krpXy\n9crWClfFVda3F23sHFkRzlW+DH3V+ftJX638o0lfA82v2TNI+rLwaZL+DiscDTt8GKbsApcfI11w\nJ/x8f+Ay0O4l6Gv0/KlZvo6+euHq5wmU6OhxHdLWvUsDxwFnAO9vofx6wJq8fgB+LHA3aQB+XrIB\neGB74GDg7YCAHwMbNKjb7WiqqmNikTz10qrjG4XznHdLW1n6imrrpr48ccOsr57WTv42e6mvvh6/\nFQ7+Bfg68KNw3Ong94HVK30lPltcRFtb3VydQP+5j8kHSL5hJmXhKZm6AyvK7AF8keRqZaazbYSr\n6rWjmysIgoJITAA+T9rt9VXgJOAkm3tKNaxL9LSbS9K5gElvCNXY9ifbNYR8K+APBQ7NYedxFFsB\n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\n", "text/plain": ""}, "metadata": {}}], "metadata": {"collapsed": false, "trusted": true}}, {"execution_count": 20, "cell_type": "code", "source": "nyquist(L, (0.0001, 1000));", "outputs": [{"output_type": "display_data", "data": {"image/png": "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\nLKv/D2ULb19b6nZgAAAAAElFTkSuQmCC\n", "text/plain": ""}, "metadata": {}}], "metadata": {"collapsed": false, "trusted": true}}, {"execution_count": 21, "cell_type": "code", "source": "gangof4(Hi*Po, Co);", "outputs": [{"output_type": "display_data", "data": {"image/png": "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\nAAAASUVORK5CYII=\n", "text/plain": ""}, "metadata": {}}], "metadata": {"collapsed": false, "trusted": true}}], "nbformat": 4, "metadata": {"kernelspec": {"display_name": "Python 2", "name": "python2", "language": "python"}, "language_info": {"mimetype": "text/x-python", "nbconvert_exporter": "python", "version": "2.7.6", "name": "python", "file_extension": ".py", "pygments_lexer": "ipython2", "codemirror_mode": {"version": 2, "name": "ipython"}}}} \ No newline at end of file +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "#`python-control` Example: Vertical takeoff and landing aircraft\n", + "\n", + "http://www.cds.caltech.edu/~murray/wiki/index.php/Python-control/Example:_Vertical_takeoff_and_landing_aircraft\n", + "\n", + "This page demonstrates the use of the python-control package for analysis and design of a controller for a vectored thrust aircraft model that is used as a running example through the text *Feedback Systems* by Astrom and Murray. This example makes use of MATLAB compatible commands. " + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "##System Description\n", + "This example uses a simplified model for a (planar) vertical takeoff and landing aircraft (PVTOL), as shown below:\n", + " \n", + "\n", + "The position and orientation of the center of mass of the aircraft is denoted by $(x,y,\\theta)$, $m$ is the mass of the vehicle, $J$ the moment of inertia, $g$ the gravitational constant and $c$ the damping coefficient. The forces generated by the main downward thruster and the maneuvering thrusters are modeled as a pair of forces $F_1$ and $F_2$ acting at a distance $r$ below the aircraft (determined by the geometry of the thrusters).\n", + "\n", + "It is convenient to redefine the inputs so that the origin is an equilibrium point of the system with zero input. Letting $u_1 =\n", + "F_1$ and $u_2 = F_2 - mg$, the equations can be written in state space form as:\n", + "\n", + "\n", + "##LQR state feedback controller\n", + "This section demonstrates the design of an LQR state feedback controller for the vectored thrust aircraft example. This example is pulled from Chapter 6 (State Feedback) of [http:www.cds.caltech.edu/~murray/amwiki Astrom and Murray]. The python code listed here are contained the the file pvtol-lqr.py.\n", + "\n", + "To execute this example, we first import the libraries for SciPy, MATLAB plotting and the python-control package:" + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": {}, + "outputs": [], + "source": [ + "from numpy import * # Grab all of the NumPy functions\n", + "from matplotlib.pyplot import * # Grab MATLAB plotting functions\n", + "from control.matlab import * # MATLAB-like functions\n", + "%matplotlib inline" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The parameters for the system are given by" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "m = 4\n", + "J = 0.0475\n", + "r = 0.25\n", + "g = 9.8\n", + "c = 0.05\n" + ] + } + ], + "source": [ + "m = 4 # mass of aircraft\n", + "J = 0.0475 # inertia around pitch axis\n", + "r = 0.25 # distance to center of force\n", + "g = 9.8 # gravitational constant\n", + "c = 0.05 # damping factor (estimated)\n", + "print(\"m = {}\".format(m))\n", + "print(\"J = {}\".format(J))\n", + "print(\"r = {}\".format(r))\n", + "print(\"g = {}\".format(g))\n", + "print(\"c = {}\".format(c))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The linearization of the dynamics near the equilibrium point $x_e = (0, 0, 0, 0, 0, 0)$, $u_e = (0, mg)$ are given by" + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "metadata": {}, + "outputs": [], + "source": [ + "# State space dynamics\n", + "xe = [0, 0, 0, 0, 0, 0] # equilibrium point of interest\n", + "ue = [0, m * g] # (note these are lists, not matrices)" + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": {}, + "outputs": [], + "source": [ + "# Dynamics matrix (use matrix type so that * works for multiplication)\n", + "F1 = ue[0]\n", + "F2 = ue[1]\n", + "st = sin(xe[2])\n", + "ct = cos(xe[2])\n", + "A = matrix(\n", + " [[ 0, 0, 0, 1, 0, 0],\n", + " [ 0, 0, 0, 0, 1, 0],\n", + " [ 0, 0, 0, 0, 0, 1],\n", + " [ 0, 0, ((-F1 * st) - F2 * ct) / m, -c / m, 0, 0],\n", + " [ 0, 0, ((F1 * ct) - F2 * st) / m, 0, -c / m, 0],\n", + " [ 0, 0, 0, 0, 0, 0 ]])\n", + "\n", + "# Input matrix\n", + "B = matrix(\n", + " [[0, 0], \n", + " [0, 0], \n", + " [0, 0],\n", + " [ct / m, -st / m],\n", + " [st / m, ct / m],\n", + " [r / J, 0]])\n", + "\n", + "# Output matrix \n", + "C = matrix([[1, 0, 0, 0, 0, 0], \n", + " [0, 1, 0, 0, 0, 0]])\n", + "D = matrix([[0, 0], \n", + " [0, 0]])" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "To compute a linear quadratic regulator for the system, we write the cost function as\n", + "\n", + "\n", + "where $z = x - x_e$ and $v = u - u_e$ represent the local coordinates around the desired equilibrium point $(z_e, u_e)$. We begin with diagonal matrices for the state and input costs:" + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "metadata": {}, + "outputs": [], + "source": [ + "Qz1 = diag([1, 1, 1, 1, 1, 1])\n", + "Qv1a = diag([1, 1])\n", + "(K, X, E) = lqr(A, B, Qz1, Qv1a) \n", + "K1a = array(K)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This gives a control law of the form $v = -K z$, which can then be used to derive the control law in terms of the original variables:\n", + "\n", + "\n", + " $$u = v + u_d = - K(z - z_d) + u_d.$$\n", + "where $u_d = (0, mg)$ and $z_d = (x_d, y_d, 0, 0, 0, 0)$\n", + "\n", + "Since the `python-control` package only supports SISO systems, in order to compute the closed loop dynamics, we must extract the dynamics for the lateral and altitude dynamics as individual systems. In addition, we simulate the closed loop dynamics using the step command with $K x_d$ as the input vector (assumes that the \"input\" is unit size, with $xd$ corresponding to the desired steady state. The following code performs these operations:" + ] + }, + { + "cell_type": "code", + "execution_count": 7, + "metadata": {}, + "outputs": [], + "source": [ + "xd = array([[1], [0], [0], [0], [0], [0]])\n", + "yd = array([[0], [1], [0], [0], [0], [0]]) " + ] + }, + { + "cell_type": "code", + "execution_count": 11, + "metadata": {}, + "outputs": [], + "source": [ + "# Indices for the parts of the state that we want\n", + "lat = (0, 2, 3, 5)\n", + "alt = (1, 4)\n", + "\n", + "# Decoupled dynamics\n", + "Ax = (A[lat, :])[:, lat]\n", + "Bx = B[lat, 0]\n", + "Cx = C[0, lat]\n", + "Dx = D[0, 0]\n", + " \n", + "Ay = A[alt, :][:, alt]\n", + "By = B[alt, 1]\n", + "Cy = C[1, alt]\n", + "Dy = D[1, 1]\n", + "\n", + "# Step response for the first input\n", + "H1ax = ss(Ax - Bx * K1a[0, lat], \n", + " Bx * K1a[0, lat] * xd[lat, :], \n", + " Cx, \n", + " Dx)\n", + "(Tx, Yx) = step(H1ax, T=linspace(0, 10, 100))\n", + "\n", + "# Step response for the second input\n", + "H1ay = ss(Ay - By * K1a[1, alt], \n", + " By * K1a[1, alt] * yd[alt, :], \n", + " Cy, \n", + " Dy)\n", + "(Ty, Yy) = step(H1ay, T=linspace(0, 10, 100))" + ] + }, + { + "cell_type": "code", + "execution_count": 13, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "" + ] + }, + "execution_count": 13, + "metadata": {}, + "output_type": "execute_result" + }, + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": { + "needs_background": "light" + }, + "output_type": "display_data" + } + ], + "source": [ + "plot(Yx.T, Tx, '-', Yy.T, Ty, '--')\n", + "plot([0, 10], [1, 1], 'k-')\n", + "ylabel('Position')\n", + "xlabel('Time (s)')\n", + "title('Step Response for Inputs')\n", + "legend(('Yx', 'Yy'), loc='lower right')" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The plot above shows the $x$ and $y$ positions of the aircraft when it is commanded to move 1 m in each direction. The following shows the $x$ motion for control weights $\\rho = 1, 10^2, 10^4$. A higher weight of the input term in the cost function causes a more sluggish response. It is created using the code:" + ] + }, + { + "cell_type": "code", + "execution_count": 15, + "metadata": {}, + "outputs": [], + "source": [ + "# Look at different input weightings\n", + "Qv1a = diag([1, 1])\n", + "(K1a, X, E) = lqr(A, B, Qz1, Qv1a)\n", + "H1ax = ss(Ax - Bx * K1a[0, lat], \n", + " Bx * K1a[0, lat] * xd[lat, :], \n", + " Cx, \n", + " Dx)\n", + "\n", + "Qv1b = (40 ** 2) * diag([1, 1])\n", + "(K1b, X, E) = lqr(A, B, Qz1, Qv1b)\n", + "H1bx = ss(Ax - Bx * K1b[0, lat], \n", + " Bx * K1b[0, lat] * xd[lat, :], \n", + " Cx, \n", + " Dx)\n", + "\n", + "Qv1c = (200 ** 2) * diag([1, 1]) \n", + "(K1c, X, E) = lqr(A, B, Qz1, Qv1c)\n", + "H1cx = ss(Ax - Bx * K1c[0, lat], \n", + " Bx * K1c[0, lat] * xd[lat, :],\n", + " Cx, \n", + " Dx)\n", + "\n", + "[T1, Y1] = step(H1ax, T=linspace(0, 10, 100))\n", + "[T2, Y2] = step(H1bx, T=linspace(0, 10, 100))\n", + "[T3, Y3] = step(H1cx, T=linspace(0, 10, 100))" + ] + }, + { + "cell_type": "code", + "execution_count": 16, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "[0, 10, -0.1, 1.4]" + ] + }, + "execution_count": 16, + "metadata": {}, + "output_type": "execute_result" + }, + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": { + "needs_background": "light" + }, + "output_type": "display_data" + } + ], + "source": [ + "plot(Y1.T, T1, 'b-')\n", + "plot(Y2.T, T2, 'r-')\n", + "plot(Y3.T, T3, 'g-')\n", + "plot([0 ,10], [1, 1], 'k-')\n", + "title('Step Response for Inputs')\n", + "ylabel('Position')\n", + "xlabel('Time (s)')\n", + "legend(('Y1', 'Y2', 'Y3'), loc='lower right')\n", + "axis([0, 10, -0.1, 1.4])" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "##Lateral control using inner/outer loop design\n", + "This section demonstrates the design of loop shaping controller for the vectored thrust aircraft example. This example is pulled from Chapter 11 [Frequency Domain Design](http:www.cds.caltech.edu/~murray/amwiki) of Astrom and Murray. \n", + "\n", + "To design a controller for the lateral dynamics of the vectored thrust aircraft, we make use of a \"inner/outer\" loop design methodology. We begin by representing the dynamics using the block diagram.\n", + "\n", + "\n", + "where\n", + " \n", + "The controller is constructed by splitting the process dynamics and controller into two components: an inner loop consisting of the roll dynamics $P_i$ and control $C_i$ and an outer loop consisting of the lateral position dynamics $P_o$ and controller $C_o$.\n", + "\n", + "The closed inner loop dynamics $H_i$ control the roll angle of the aircraft using the vectored thrust while the outer loop controller $C_o$ commands the roll angle to regulate the lateral position.\n", + "\n", + "The following code imports the libraries that are required and defines the dynamics:" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "collapsed": true + }, + "source": [ + "### Transfer functions for dynamics" + ] + }, + { + "cell_type": "code", + "execution_count": 17, + "metadata": {}, + "outputs": [], + "source": [ + "Pi = tf([r], [J, 0, 0]) # inner loop (roll)\n", + "Po = tf([1], [m, c, 0]) # outer loop (position)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "For the inner loop, use a lead compensator." + ] + }, + { + "cell_type": "code", + "execution_count": 18, + "metadata": {}, + "outputs": [], + "source": [ + "k = 200\n", + "a = 2\n", + "b = 50\n", + "Ci = k * tf([1, a], [1, b])\n", + "Li = Pi * Ci" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The closed loop dynamics of the inner loop, $H_i$, are given by" + ] + }, + { + "cell_type": "code", + "execution_count": 19, + "metadata": {}, + "outputs": [], + "source": [ + "Hi = parallel(feedback(Ci, Pi), -m * g * feedback(Ci * Pi, 1))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Finally, we design the lateral compensator using another lead compensator." + ] + }, + { + "cell_type": "code", + "execution_count": 20, + "metadata": {}, + "outputs": [], + "source": [ + "# Now design the lateral control system\n", + "a = 0.02\n", + "b = 5\n", + "K = 2\n", + "Co = -K * tf([1, 0.3], [1, 10])\n", + "Lo = -m * g * Po * Co" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The performance of the system can be characterized using the sensitivity function and the complementary sensitivity function:" + ] + }, + { + "cell_type": "code", + "execution_count": 21, + "metadata": {}, + "outputs": [], + "source": [ + "L = Co * Hi * Po\n", + "S = feedback(1, L)\n", + "T = feedback(L, 1)" + ] + }, + { + "cell_type": "code", + "execution_count": 22, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "Text(0,0.5,'y(t)')" + ] + }, + "execution_count": 22, + "metadata": {}, + "output_type": "execute_result" + }, + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": { + "needs_background": "light" + }, + "output_type": "display_data" + } + ], + "source": [ + "t, y = step(T, T=linspace(0,10,100))\n", + "plot(y, t)\n", + "title(\"Step Response\")\n", + "grid()\n", + "xlabel(\"time (s)\")\n", + "ylabel(\"y(t)\")" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The frequency response and Nyquist plot for the loop transfer function are computed using the commands" + ] + }, + { + "cell_type": "code", + "execution_count": 24, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": { + "needs_background": "light" + }, + "output_type": "display_data" + } + ], + "source": [ + "_ = bode(L)" + ] + }, + { + "cell_type": "code", + "execution_count": 26, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": { + "needs_background": "light" + }, + "output_type": "display_data" + } + ], + "source": [ + "_ = nyquist(L, (0.0001, 1000))" + ] + }, + { + "cell_type": "code", + "execution_count": 27, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": { + "needs_background": "light" + }, + "output_type": "display_data" + } + ], + "source": [ + "gangof4(Hi * Po, Co)" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 2", + "language": "python", + "name": "python2" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.4.9" + } + }, + "nbformat": 4, + "nbformat_minor": 1 +} From 8644954350cb77e90715f921aca247c5e347730c Mon Sep 17 00:00:00 2001 From: Anthony De Bortoli Date: Tue, 8 Jan 2019 22:45:11 +0100 Subject: [PATCH 11/12] [statefbk.py] Check that LQR problem is solvable --- control/statefbk.py | 7 +++++++ control/tests/matlab_test.py | 16 +++++++++++----- 2 files changed, 18 insertions(+), 5 deletions(-) diff --git a/control/statefbk.py b/control/statefbk.py index ed3686062..0bf98f935 100644 --- a/control/statefbk.py +++ b/control/statefbk.py @@ -392,6 +392,13 @@ def lqr(*args): else: N = np.zeros((Q.shape[0], R.shape[1])) + # Check that LQR problem is solvable + QN = np.column_stack((Q, N)) + NTR = np.column_stack((N.T, R)) + QN_NTR = np.row_stack((QN, NTR)) + if not np.all(np.linalg.eigvals(QN_NTR) >= 0): + raise ValueError("[Q N;N' R] should be positive semi-definite.") + # Check dimensions for consistency nstates = B.shape[0] ninputs = B.shape[1] diff --git a/control/tests/matlab_test.py b/control/tests/matlab_test.py index bcba99be1..cd85f7e25 100644 --- a/control/tests/matlab_test.py +++ b/control/tests/matlab_test.py @@ -410,20 +410,26 @@ def testPlace(self): def testAcker(self): place(self.siso_ss1.A, self.siso_ss1.B, [-2, -2.5], method="acker") + @unittest.skipIf(not slycot_check(), "slycot not installed") + def test_lqr_not_semi_positive_definite_constraints(self): + np.testing.assert_raises(ValueError, lqr, self.siso_ss1.A, self.siso_ss1.B, np.eye(2), + -np.eye(1)) + + np.testing.assert_raises(ValueError, lqr, self.siso_ss2.A, self.siso_ss2.B, np.eye(3), + np.eye(1), [[1], [1], [2]]) @unittest.skipIf(not slycot_check(), "slycot not installed") - def testLQR(self): + def test_lqr(self): (K, S, E) = lqr(self.siso_ss1.A, self.siso_ss1.B, np.eye(2), np.eye(1)) - # Should work if [Q N;N' R] is positive semi-definite - (K, S, E) = lqr(self.siso_ss2.A, self.siso_ss2.B, 10*np.eye(3), \ - np.eye(1), [[1], [1], [2]]) + (K, S, E) = lqr(self.siso_ss2.A, self.siso_ss2.B, 10*np.eye(3), + np.eye(1), [[1], [1], [2]]) @unittest.skip("check not yet implemented") def testLQR_checks(self): # Make sure we get a warning if [Q N;N' R] is not positive semi-definite (K, S, E) = lqr(self.siso_ss2.A, self.siso_ss2.B, np.eye(3), \ - np.eye(1), [[1], [1], [2]]) + np.eye(1), [[1], [1], [2]]) def testRss(self): rss(1) From 2afed817a043e6b8c69f6436a0719a88d4315481 Mon Sep 17 00:00:00 2001 From: Anthony De Bortoli Date: Tue, 8 Jan 2019 23:09:32 +0100 Subject: [PATCH 12/12] [test_statefbk.py] Pep8 cleaning --- .../tests/{matlab_test.py => test_matlab.py} | 386 +++++++++--------- 1 file changed, 195 insertions(+), 191 deletions(-) rename control/tests/{matlab_test.py => test_matlab.py} (70%) diff --git a/control/tests/matlab_test.py b/control/tests/test_matlab.py similarity index 70% rename from control/tests/matlab_test.py rename to control/tests/test_matlab.py index cd85f7e25..7a2e18873 100644 --- a/control/tests/matlab_test.py +++ b/control/tests/test_matlab.py @@ -1,6 +1,6 @@ #!/usr/bin/env python # -# matlab_test.py - test MATLAB compatibility +# test_matlab.py - test MATLAB compatibility # RMM, 30 Mar 2011 (based on TestMatlab from v0.4a) # # This test suite just goes through and calls all of the MATLAB @@ -55,44 +55,46 @@ ''' + class TestMatlab(unittest.TestCase): def setUp(self): """Set up some systems for testing out MATLAB functions""" - A = np.matrix("1. -2.; 3. -4.") - B = np.matrix("5.; 7.") - C = np.matrix("6. 8.") - D = np.matrix("9.") - self.siso_ss1 = ss(A,B,C,D) + self.A_siso = np.array([[1., -2.], + [3., -4.]]) + self.B_siso = np.array([[5.], [7.]]) + self.C_siso = np.array([6., 8.]) + self.D_siso = np.array([9.]) + self.siso_ss1 = ss(self.A_siso, self.B_siso, self.C_siso, self.D_siso) # Create some transfer functions - self.siso_tf1 = tf([1], [1, 2, 1]); - self.siso_tf2 = tf([1, 1], [1, 2, 3, 1]); + self.siso_tf1 = tf([1], [1, 2, 1]) + self.siso_tf2 = tf([1, 1], [1, 2, 3, 1]) # Conversions - self.siso_tf3 = tf(self.siso_ss1); - self.siso_ss2 = ss(self.siso_tf2); - self.siso_ss3 = tf2ss(self.siso_tf3); - self.siso_tf4 = ss2tf(self.siso_ss2); - - #Create MIMO system, contains ``siso_ss1`` twice - A = np.matrix("1. -2. 0. 0.;" - "3. -4. 0. 0.;" - "0. 0. 1. -2.;" - "0. 0. 3. -4. ") - B = np.matrix("5. 0.;" - "7. 0.;" - "0. 5.;" - "0. 7. ") - C = np.matrix("6. 8. 0. 0.;" - "0. 0. 6. 8. ") - D = np.matrix("9. 0.;" - "0. 9. ") - self.mimo_ss1 = ss(A, B, C, D) + self.siso_tf3 = tf(self.siso_ss1) + self.siso_ss2 = ss(self.siso_tf2) + self.siso_ss3 = tf2ss(self.siso_tf3) + self.siso_tf4 = ss2tf(self.siso_ss2) + + # Create MIMO system, contains ``siso_ss1`` twice + self.A_mimo = np.array([[1., -2., 0., 0.], + [3., -4., 0., 0.], + [0., 0., 1., -2.], + [0., 0., 3., -4.]]) + self.B_mimo = np.array([[5., 0.], + [7., 0.], + [0., 5.], + [0., 7.]]) + self.C_mimo = np.array([[6., 8., 0., 0.], + [0., 0., 6., 8.]]) + self.D_mimo = np.array([[9., 0.], + [0., 9.]]) + self.mimo_ss1 = ss(self.A_mimo, self.B_mimo, self.C_mimo, self.D_mimo) # get consistent test results np.random.seed(0) - def testParallel(self): + def test_parallel(self): sys1 = parallel(self.siso_ss1, self.siso_ss2) sys1 = parallel(self.siso_ss1, self.siso_tf2) sys1 = parallel(self.siso_tf1, self.siso_ss2) @@ -101,7 +103,7 @@ def testParallel(self): sys1 = parallel(self.siso_ss1, 1) sys1 = parallel(self.siso_tf1, 1) - def testSeries(self): + def test_series(self): sys1 = series(self.siso_ss1, self.siso_ss2) sys1 = series(self.siso_ss1, self.siso_tf2) sys1 = series(self.siso_tf1, self.siso_ss2) @@ -110,7 +112,7 @@ def testSeries(self): sys1 = series(self.siso_ss1, 1) sys1 = series(self.siso_tf1, 1) - def testFeedback(self): + def test_feedback(self): sys1 = feedback(self.siso_ss1, self.siso_ss2) sys1 = feedback(self.siso_ss1, self.siso_tf2) sys1 = feedback(self.siso_tf1, self.siso_ss2) @@ -119,22 +121,22 @@ def testFeedback(self): sys1 = feedback(self.siso_ss1, 1) sys1 = feedback(self.siso_tf1, 1) - def testPoleZero(self): - pole(self.siso_ss1); - pole(self.siso_tf1); - pole(self.siso_tf2); - zero(self.siso_ss1); - zero(self.siso_tf1); - zero(self.siso_tf2); - - def testPZmap(self): - # pzmap(self.siso_ss1); not implemented - # pzmap(self.siso_ss2); not implemented - pzmap(self.siso_tf1); - pzmap(self.siso_tf2); - pzmap(self.siso_tf2, Plot=False); - - def testStep(self): + def test_pole_zero(self): + pole(self.siso_ss1) + pole(self.siso_tf1) + pole(self.siso_tf2) + zero(self.siso_ss1) + zero(self.siso_tf1) + zero(self.siso_tf2) + + def test_pzmap(self): + # pzmap(self.siso_ss1) not implemented + # pzmap(self.siso_ss2) not implemented + pzmap(self.siso_tf1) + pzmap(self.siso_tf2) + pzmap(self.siso_tf2, Plot=False) + + def test_step(self): t = np.linspace(0, 1, 10) # Test transfer function yout, tout = step(self.siso_tf1, T=t) @@ -157,7 +159,7 @@ def testStep(self): np.testing.assert_array_almost_equal(yout, youttrue, decimal=4) np.testing.assert_array_almost_equal(tout, t) - X0 = np.array([0, 0]); + X0 = np.array([0, 0]) yout, tout = step(sys, T=t, X0=X0) np.testing.assert_array_almost_equal(yout, youttrue, decimal=4) np.testing.assert_array_almost_equal(tout, t) @@ -174,7 +176,7 @@ def testStep(self): np.testing.assert_array_almost_equal(y_00, youttrue, decimal=4) np.testing.assert_array_almost_equal(y_11, youttrue, decimal=4) - def testImpulse(self): + def test_impulse(self): t = np.linspace(0, 1, 10) # test transfer function yout, tout = impulse(self.siso_tf1, T=t) @@ -186,7 +188,7 @@ def testImpulse(self): # produce a warning for a system with direct feedthrough with warnings.catch_warnings(): warnings.simplefilter("ignore") - #Test SISO system + # Test SISO system sys = self.siso_ss1 youttrue = np.array([86., 70.1808, 57.3753, 46.9975, 38.5766, 31.7344, 26.1668, 21.6292, 17.9245, 14.8945]) @@ -199,7 +201,7 @@ def testImpulse(self): np.testing.assert_array_almost_equal(yout, youttrue, decimal=4) np.testing.assert_array_almost_equal(tout, t) - X0 = np.array([0, 0]); + X0 = np.array([0, 0]) yout, tout = impulse(sys, T=t, X0=X0) np.testing.assert_array_almost_equal(yout, youttrue, decimal=4) np.testing.assert_array_almost_equal(tout, t) @@ -209,15 +211,15 @@ def testImpulse(self): np.testing.assert_array_almost_equal(tout, t) if slycot_check(): - #Test MIMO system, which contains ``siso_ss1`` twice + # Test MIMO system, which contains ``siso_ss1`` twice sys = self.mimo_ss1 y_00, _t = impulse(sys, T=t, input=0, output=0) y_11, _t = impulse(sys, T=t, input=1, output=1) np.testing.assert_array_almost_equal(y_00, youttrue, decimal=4) np.testing.assert_array_almost_equal(y_11, youttrue, decimal=4) - def testInitial(self): - #Test SISO system + def test_initial(self): + # Test SISO system sys = self.siso_ss1 t = np.linspace(0, 1, 10) x0 = np.matrix(".5; 1.") @@ -233,7 +235,7 @@ def testInitial(self): np.testing.assert_array_almost_equal(tout, t) if slycot_check(): - #Test MIMO system, which contains ``siso_ss1`` twice + # Test MIMO system, which contains ``siso_ss1`` twice sys = self.mimo_ss1 x0 = np.matrix(".5; 1.; .5; 1.") y_00, _t = initial(sys, T=t, X0=x0, input=0, output=0) @@ -241,11 +243,11 @@ def testInitial(self): np.testing.assert_array_almost_equal(y_00, youttrue, decimal=4) np.testing.assert_array_almost_equal(y_11, youttrue, decimal=4) - def testLsim(self): + def test_lsim(self): t = np.linspace(0, 1, 10) - #compute step response - test with state space, and transfer function - #objects + # compute step response - test with state space, and transfer function + # objects u = np.array([1., 1, 1, 1, 1, 1, 1, 1, 1, 1]) youttrue = np.array([9., 17.6457, 24.7072, 30.4855, 35.2234, 39.1165, 42.3227, 44.9694, 47.1599, 48.9776]) @@ -255,8 +257,8 @@ def testLsim(self): yout, _t, _xout = lsim(self.siso_tf3, u, t) np.testing.assert_array_almost_equal(yout, youttrue, decimal=4) - #test with initial value and special algorithm for ``U=0`` - u=0 + # test with initial value and special algorithm for ``U=0`` + u = 0 x0 = np.matrix(".5; 1.") youttrue = np.array([11., 8.1494, 5.9361, 4.2258, 2.9118, 1.9092, 1.1508, 0.5833, 0.1645, -0.1391]) @@ -264,8 +266,8 @@ def testLsim(self): np.testing.assert_array_almost_equal(yout, youttrue, decimal=4) if slycot_check(): - #Test MIMO system, which contains ``siso_ss1`` twice - #first system: initial value, second system: step response + # Test MIMO system, which contains ``siso_ss1`` twice + # first system: initial value, second system: step response u = np.array([[0., 1.], [0, 1], [0, 1], [0, 1], [0, 1], [0, 1], [0, 1], [0, 1], [0, 1], [0, 1]]) x0 = np.matrix(".5; 1; 0; 0") @@ -277,25 +279,25 @@ def testLsim(self): yout, _t, _xout = lsim(self.mimo_ss1, u, t, x0) np.testing.assert_array_almost_equal(yout, youttrue, decimal=4) - def testMargin(self): - #! TODO: check results to make sure they are OK - gm, pm, wg, wp = margin(self.siso_tf1); - gm, pm, wg, wp = margin(self.siso_tf2); - gm, pm, wg, wp = margin(self.siso_ss1); - gm, pm, wg, wp = margin(self.siso_ss2); - gm, pm, wg, wp = margin(self.siso_ss2*self.siso_ss2*2); + def test_margin(self): + # ! TODO: check results to make sure they are OK + gm, pm, wg, wp = margin(self.siso_tf1) + gm, pm, wg, wp = margin(self.siso_tf2) + gm, pm, wg, wp = margin(self.siso_ss1) + gm, pm, wg, wp = margin(self.siso_ss2) + gm, pm, wg, wp = margin(self.siso_ss2 * self.siso_ss2 * 2) np.testing.assert_array_almost_equal( - [gm, pm, wg, wp], [1.5451, 75.9933, 1.2720, 0.6559], decimal=3) + [gm, pm, wg, wp], [1.5451, 75.9933, 1.2720, 0.6559], decimal=3) - def testDcgain(self): - #Create different forms of a SISO system + def test_dcgain(self): + # Create different forms of a SISO system A, B, C, D = self.siso_ss1.A, self.siso_ss1.B, self.siso_ss1.C, \ self.siso_ss1.D Z, P, k = sp.signal.ss2zpk(A, B, C, D) num, den = sp.signal.ss2tf(A, B, C, D) sys_ss = self.siso_ss1 - #Compute the gain with ``dcgain`` + # Compute the gain with ``dcgain`` gain_abcd = dcgain(A, B, C, D) gain_zpk = dcgain(Z, P, k) gain_numden = dcgain(np.squeeze(num), den) @@ -303,38 +305,39 @@ def testDcgain(self): # print('\ngain_abcd:', gain_abcd, 'gain_zpk:', gain_zpk) # print('gain_numden:', gain_numden, 'gain_sys_ss:', gain_sys_ss) - #Compute the gain with a long simulation + # Compute the gain with a long simulation t = linspace(0, 1000, 1000) y, _t = step(sys_ss, t) gain_sim = y[-1] # print('gain_sim:', gain_sim) - #All gain values must be approximately equal to the known gain + # All gain values must be approximately equal to the known gain np.testing.assert_array_almost_equal( - [gain_abcd, gain_zpk, gain_numden, gain_sys_ss, - gain_sim], - [59, 59, 59, 59, 59]) + [gain_abcd, gain_zpk, gain_numden, gain_sys_ss, + gain_sim], + [59, 59, 59, 59, 59]) if slycot_check(): # Test with MIMO system, which contains ``siso_ss1`` twice gain_mimo = dcgain(self.mimo_ss1) # print('gain_mimo: \n', gain_mimo) - np.testing.assert_array_almost_equal(gain_mimo, [[59., 0 ], - [0, 59.]]) + np.testing.assert_array_almost_equal(gain_mimo, [[59., 0], + [0, 59.]]) - def testBode(self): + def test_bode(self): bode(self.siso_ss1) bode(self.siso_tf1) bode(self.siso_tf2) (mag, phase, freq) = bode(self.siso_tf2, Plot=False) bode(self.siso_tf1, self.siso_tf2) - w = logspace(-3, 3); + w = logspace(-3, 3) bode(self.siso_ss1, w) bode(self.siso_ss1, self.siso_tf2, w) -# Not yet implemented -# bode(self.siso_ss1, '-', self.siso_tf1, 'b--', self.siso_tf2, 'k.') - def testRlocus(self): + # Not yet implemented + # bode(self.siso_ss1, '-', self.siso_tf1, 'b--', self.siso_tf2, 'k.') + + def test_rlocus(self): rlocus(self.siso_ss1) rlocus(self.siso_tf1) rlocus(self.siso_tf2) @@ -343,23 +346,23 @@ def testRlocus(self): np.testing.assert_equal(len(rlist), len(klist)) np.testing.assert_array_equal(klist, klist_out) - def testNyquist(self): + def test_nyquist(self): nyquist(self.siso_ss1) nyquist(self.siso_tf1) nyquist(self.siso_tf2) - w = logspace(-3, 3); + w = logspace(-3, 3) nyquist(self.siso_tf2, w) (real, imag, freq) = nyquist(self.siso_tf2, w, Plot=False) - def testNichols(self): + def test_nichols(self): nichols(self.siso_ss1) nichols(self.siso_tf1) nichols(self.siso_tf2) - w = logspace(-3, 3); + w = logspace(-3, 3) nichols(self.siso_tf2, w) nichols(self.siso_tf2, grid=False) - def testFreqresp(self): + def test_freqresp(self): w = logspace(-3, 3) freqresp(self.siso_ss1, w) freqresp(self.siso_ss2, w) @@ -368,9 +371,9 @@ def testFreqresp(self): freqresp(self.siso_tf2, w) freqresp(self.siso_tf3, w) - def testEvalfr(self): + def test_evalfr(self): w = 1j - np.testing.assert_almost_equal(evalfr(self.siso_ss1, w), 44.8-21.4j) + np.testing.assert_almost_equal(evalfr(self.siso_ss1, w), 44.8 - 21.4j) evalfr(self.siso_ss2, w) evalfr(self.siso_ss3, w) evalfr(self.siso_tf1, w) @@ -378,36 +381,36 @@ def testEvalfr(self): evalfr(self.siso_tf3, w) if slycot_check(): np.testing.assert_array_almost_equal( - evalfr(self.mimo_ss1, w), - np.array( [[44.8-21.4j, 0.], [0., 44.8-21.4j]])) + evalfr(self.mimo_ss1, w), + np.array([[44.8 - 21.4j, 0.], [0., 44.8 - 21.4j]])) @unittest.skipIf(not slycot_check(), "slycot not installed") - def testHsvd(self): + def test_hsvd(self): hsvd(self.siso_ss1) hsvd(self.siso_ss2) hsvd(self.siso_ss3) @unittest.skipIf(not slycot_check(), "slycot not installed") - def testBalred(self): + def test_balred(self): balred(self.siso_ss1, 1) balred(self.siso_ss2, 2) balred(self.siso_ss3, [2, 2]) @unittest.skipIf(not slycot_check(), "slycot not installed") - def testModred(self): + def test_modred(self): modred(self.siso_ss1, [1]) modred(self.siso_ss2 * self.siso_ss1, [0, 1]) modred(self.siso_ss1, [1], 'matchdc') modred(self.siso_ss1, [1], 'truncate') @unittest.skipIf(not slycot_check(), "slycot not installed") - def testPlace_varga(self): + def test_place_varga(self): place(self.siso_ss1.A, self.siso_ss1.B, [-2, -2], method="varga") - def testPlace(self): + def test_place(self): place(self.siso_ss1.A, self.siso_ss1.B, [-2, -2.5]) - def testAcker(self): + def test_acker(self): place(self.siso_ss1.A, self.siso_ss1.B, [-2, -2.5], method="acker") @unittest.skipIf(not slycot_check(), "slycot not installed") @@ -422,46 +425,46 @@ def test_lqr_not_semi_positive_definite_constraints(self): def test_lqr(self): (K, S, E) = lqr(self.siso_ss1.A, self.siso_ss1.B, np.eye(2), np.eye(1)) - (K, S, E) = lqr(self.siso_ss2.A, self.siso_ss2.B, 10*np.eye(3), + (K, S, E) = lqr(self.siso_ss2.A, self.siso_ss2.B, 10 * np.eye(3), np.eye(1), [[1], [1], [2]]) @unittest.skip("check not yet implemented") - def testLQR_checks(self): + def test_lqr_checks(self): # Make sure we get a warning if [Q N;N' R] is not positive semi-definite (K, S, E) = lqr(self.siso_ss2.A, self.siso_ss2.B, np.eye(3), \ np.eye(1), [[1], [1], [2]]) - def testRss(self): + def test_rss(self): rss(1) rss(2) rss(2, 1, 3) - def testDrss(self): + def test_drss(self): drss(1) drss(2) drss(2, 1, 3) - def testCtrb(self): + def test_ctrb(self): ctrb(self.siso_ss1.A, self.siso_ss1.B) ctrb(self.siso_ss2.A, self.siso_ss2.B) - def testObsv(self): + def test_obsv(self): obsv(self.siso_ss1.A, self.siso_ss1.C) obsv(self.siso_ss2.A, self.siso_ss2.C) @unittest.skipIf(not slycot_check(), "slycot not installed") - def testGram(self): + def test_gram(self): gram(self.siso_ss1, 'c') gram(self.siso_ss2, 'c') gram(self.siso_ss1, 'o') gram(self.siso_ss2, 'o') - def testPade(self): + def test_pade(self): pade(1, 1) pade(1, 2) pade(5, 4) - def testOpers(self): + def test_opers(self): self.siso_ss1 + self.siso_ss2 self.siso_tf1 + self.siso_tf2 self.siso_ss1 + self.siso_tf2 @@ -475,31 +478,31 @@ def testOpers(self): # self.siso_ss1 / self.siso_tf2 # self.siso_tf1 / self.siso_ss2 - def testUnwrap(self): + def test_unwrap(self): phase = np.array(range(1, 100)) / 10.; wrapped = phase % (2 * np.pi) unwrapped = unwrap(wrapped) - def testSISOssdata(self): - ssdata_1 = ssdata(self.siso_ss2); - ssdata_2 = ssdata(self.siso_tf2); + def test_ssdata_siso(self): + ssdata_1 = ssdata(self.siso_ss2) + ssdata_2 = ssdata(self.siso_tf2) for i in range(len(ssdata_1)): np.testing.assert_array_almost_equal(ssdata_1[i], ssdata_2[i]) @unittest.skipIf(not slycot_check(), "slycot not installed") - def testMIMOssdata(self): + def test_ssdata_mimo(self): m = (self.mimo_ss1.A, self.mimo_ss1.B, self.mimo_ss1.C, self.mimo_ss1.D) - ssdata_1 = ssdata(self.mimo_ss1); + ssdata_1 = ssdata(self.mimo_ss1) for i in range(len(ssdata_1)): np.testing.assert_array_almost_equal(ssdata_1[i], m[i]) - def testSISOtfdata(self): - tfdata_1 = tfdata(self.siso_tf2); - tfdata_2 = tfdata(self.siso_tf2); + def test_tfdata_siso(self): + tfdata_1 = tfdata(self.siso_tf2) + tfdata_2 = tfdata(self.siso_tf2) for i in range(len(tfdata_1)): np.testing.assert_array_almost_equal(tfdata_1[i], tfdata_2[i]) - def testDamp(self): + def test_damp(self): A = np.mat('''-0.2 0.06 0 -1; 0 0 1 0; -17 0 -3.8 1; @@ -509,74 +512,72 @@ def testDamp(self): -32 5.4; 2.6 -7''') C = np.eye(4) - D = np.zeros((4,2)) + D = np.zeros((4, 2)) sys = ss(A, B, C, D) wn, Z, p = damp(sys, False) # print (wn) np.testing.assert_array_almost_equal( - wn, np.array([4.07381994, 3.28874827, 3.28874827, - 1.08937685e-03])) + wn, np.array([4.07381994, 3.28874827, 3.28874827, + 1.08937685e-03])) np.testing.assert_array_almost_equal( - Z, np.array([1.0, 0.07983139, 0.07983139, 1.0])) + Z, np.array([1.0, 0.07983139, 0.07983139, 1.0])) - def testConnect(self): + def test_connect(self): sys1 = ss("1. -2; 3. -4", "5.; 7", "6, 8", "9.") sys2 = ss("-1.", "1.", "1.", "0.") sys = append(sys1, sys2) - Q= np.mat([ [ 1, 2], [2, -1] ]) # basically feedback, output 2 in 1 + Q = np.mat([[1, 2], [2, -1]]) # basically feedback, output 2 in 1 sysc = connect(sys, Q, [2], [1, 2]) # print(sysc) np.testing.assert_array_almost_equal( - sysc.A, np.mat('1 -2 5; 3 -4 7; -6 -8 -10')) + sysc.A, np.mat('1 -2 5; 3 -4 7; -6 -8 -10')) np.testing.assert_array_almost_equal( - sysc.B, np.mat('0; 0; 1')) + sysc.B, np.mat('0; 0; 1')) np.testing.assert_array_almost_equal( - sysc.C, np.mat('6 8 9; 0 0 1')) + sysc.C, np.mat('6 8 9; 0 0 1')) np.testing.assert_array_almost_equal( - sysc.D, np.mat('0; 0')) + sysc.D, np.mat('0; 0')) - def testConnect2(self): + def test_connect_2(self): sys = append(ss([[-5, -2.25], [4, 0]], [[2], [0]], - [[0, 1.125]], [[0]]), - ss([[-1.6667, 0], [1, 0]], [[2], [0]], - [[0, 3.3333]], [[0]]), - 1) - Q = [ [ 1, 3], [2, 1], [3, -2]] + [[0, 1.125]], [[0]]), + ss([[-1.6667, 0], [1, 0]], [[2], [0]], + [[0, 3.3333]], [[0]]), + 1) + Q = [[1, 3], [2, 1], [3, -2]] sysc = connect(sys, Q, [3], [3, 1, 2]) np.testing.assert_array_almost_equal( - sysc.A, np.mat([[-5, -2.25, 0, -6.6666], - [4, 0, 0, 0], - [0, 2.25, -1.6667, 0], - [0, 0, 1, 0]])) + sysc.A, np.mat([[-5, -2.25, 0, -6.6666], + [4, 0, 0, 0], + [0, 2.25, -1.6667, 0], + [0, 0, 1, 0]])) np.testing.assert_array_almost_equal( - sysc.B, np.mat([[2], [0], [0], [0]])) + sysc.B, np.mat([[2], [0], [0], [0]])) np.testing.assert_array_almost_equal( - sysc.C, np.mat([[0, 0, 0, -3.3333], - [0, 1.125, 0, 0], - [0, 0, 0, 3.3333]])) + sysc.C, np.mat([[0, 0, 0, -3.3333], + [0, 1.125, 0, 0], + [0, 0, 0, 3.3333]])) np.testing.assert_array_almost_equal( - sysc.D, np.mat([[1], [0], [0]])) - - + sysc.D, np.mat([[1], [0], [0]])) - def testFRD(self): + def test_frd(self): h = tf([1], [1, 2, 2]) omega = np.logspace(-1, 2, 10) frd1 = frd(h, omega) assert isinstance(frd1, FRD) - frd2 = frd(frd1.fresp[0,0,:], omega) + frd2 = frd(frd1.fresp[0, 0, :], omega) assert isinstance(frd2, FRD) @unittest.skipIf(not slycot_check(), "slycot not installed") - def testMinreal(self, verbose=False): + def test_minreal(self, verbose=False): """Test a minreal model reduction""" - #A = [-2, 0.5, 0; 0.5, -0.3, 0; 0, 0, -0.1] + # A = [-2, 0.5, 0; 0.5, -0.3, 0; 0, 0, -0.1] A = [[-2, 0.5, 0], [0.5, -0.3, 0], [0, 0, -0.1]] - #B = [0.3, -1.3; 0.1, 0; 1, 0] + # B = [0.3, -1.3; 0.1, 0; 1, 0] B = [[0.3, -1.3], [0.1, 0.], [1.0, 0.0]] - #C = [0, 0.1, 0; -0.3, -0.2, 0] + # C = [0, 0.1, 0; -0.3, -0.2, 0] C = [[0., 0.1, 0.0], [-0.3, -0.2, 0.0]] - #D = [0 -0.8; -0.3 0] + # D = [0 -0.8; -0.3 0] D = [[0., -0.8], [-0.3, 0.]] # sys = ss(A, B, C, D) @@ -586,82 +587,83 @@ def testMinreal(self, verbose=False): self.assertEqual(sysr.inputs, sys.inputs) self.assertEqual(sysr.outputs, sys.outputs) np.testing.assert_array_almost_equal( - eigvals(sysr.A), [-2.136154, -0.1638459]) + eigvals(sysr.A), [-2.136154, -0.1638459]) s = tf([1, 0], [1]) - h = (s+1)*(s+2.00000000001)/(s+2)/(s**2+s+1) + h = (s + 1) * (s + 2.00000000001) / (s + 2) / (s ** 2 + s + 1) hm = minreal(h, verbose=verbose) - hr = (s+1)/(s**2+s+1) + hr = (s + 1) / (s ** 2 + s + 1) np.testing.assert_array_almost_equal(hm.num[0][0], hr.num[0][0]) np.testing.assert_array_almost_equal(hm.den[0][0], hr.den[0][0]) - def testSS2cont(self): + def test_c2d(self): sys = ss( - np.mat("-3 4 2; -1 -3 0; 2 5 3"), - np.mat("1 4 ; -3 -3; -2 1"), - np.mat("4 2 -3; 1 4 3"), - np.mat("-2 4; 0 1")) + np.mat("-3 4 2; -1 -3 0; 2 5 3"), + np.mat("1 4 ; -3 -3; -2 1"), + np.mat("4 2 -3; 1 4 3"), + np.mat("-2 4; 0 1")) sysd = c2d(sys, 0.1) np.testing.assert_array_almost_equal( - np.mat( - """0.742840837331905 0.342242024293711 0.203124211149560; - -0.074130792143890 0.724553295044645 -0.009143771143630; - 0.180264783290485 0.544385612448419 1.370501013067845"""), - sysd.A) + np.mat( + """0.742840837331905 0.342242024293711 0.203124211149560; + -0.074130792143890 0.724553295044645 -0.009143771143630; + 0.180264783290485 0.544385612448419 1.370501013067845"""), + sysd.A) np.testing.assert_array_almost_equal( - np.mat(""" 0.012362066084719 0.301932197918268; + np.mat(""" 0.012362066084719 0.301932197918268; -0.260952977031384 -0.274201791021713; -0.304617775734327 0.075182622718853"""), sysd.B) - def testCombi01(self): + def test_combination_1(self): # test from a "real" case, combines tf, ss, connect and margin # this is a type 2 system, with phase starting at -180. The # margin command should remove the solution for w = nearly zero # Example is a concocted two-body satellite with flexible link - Jb = 400; - Jp = 1000; - k = 10; - b = 5; + Jb = 400 + Jp = 1000 + k = 10 + b = 5 # can now define an "s" variable, to make TF's - s = tf([1, 0], [1]); - hb1 = 1/(Jb*s); - hb2 = 1/s; - hp1 = 1/(Jp*s); - hp2 = 1/s; + s = tf([1, 0], [1]) + hb1 = 1 / (Jb * s) + hb2 = 1 / s + hp1 = 1 / (Jp * s) + hp2 = 1 / s # convert to ss and append - sat0 = append(ss(hb1), ss(hb2), k, b, ss(hp1), ss(hp2)); + sat0 = append(ss(hb1), ss(hb2), k, b, ss(hp1), ss(hp2)) # connection of the elements with connect call Q = [[1, -3, -4], # link moment (spring, damper), feedback to body - [2, 1, 0], # link integrator to body velocity - [3, 2, -6], # spring input, th_b - th_p - [4, 1, -5], # damper input - [5, 3, 4], # link moment, acting on payload - [6, 5, 0]] - inputs = [1]; - outputs = [1, 2, 5, 6]; - sat1 = connect(sat0, Q, inputs, outputs); + [2, 1, 0], # link integrator to body velocity + [3, 2, -6], # spring input, th_b - th_p + [4, 1, -5], # damper input + [5, 3, 4], # link moment, acting on payload + [6, 5, 0]] + inputs = [1] + outputs = [1, 2, 5, 6] + sat1 = connect(sat0, Q, inputs, outputs) # matched notch filter wno = 0.19 z1 = 0.05 z2 = 0.7 - Hno = (1+2*z1/wno*s+s**2/wno**2)/(1+2*z2/wno*s+s**2/wno**2) + Hno = (1 + 2 * z1 / wno * s + s ** 2 / wno ** 2) / ( + 1 + 2 * z2 / wno * s + s ** 2 / wno ** 2) # the controller, Kp = 1 for now Kp = 1.64 tau_PD = 50. - Hc = (1 + tau_PD*s)*Kp + Hc = (1 + tau_PD * s) * Kp # start with the basic satellite model sat1, and get the # payload attitude response - Hp = tf(sp.matrix([0, 0, 0, 1])*sat1) + Hp = tf(sp.matrix([0, 0, 0, 1]) * sat1) # total open loop - Hol = Hc*Hno*Hp + Hol = Hc * Hno * Hp gm, pm, wg, wp = margin(Hol) # print("%f %f %f %f" % (gm, pm, wg, wp)) @@ -670,7 +672,8 @@ def testCombi01(self): self.assertAlmostEqual(wg, 0.176469728448) self.assertAlmostEqual(wp, 0.0616288455466) -#! TODO: not yet implemented + +# ! TODO: not yet implemented # def testMIMOtfdata(self): # sisotf = ss2tf(self.siso_ss1) # tfdata_1 = tfdata(sisotf) @@ -679,7 +682,8 @@ def testCombi01(self): # np.testing.assert_array_almost_equal(tfdata_1[i], tfdata_2[i]) def test_suite(): - return unittest.TestLoader().loadTestsFromTestCase(TestMatlab) + return unittest.TestLoader().loadTestsFromTestCase(TestMatlab) + if __name__ == '__main__': unittest.main()