home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 10 / 10.iso / l / l455 / 2.ddi / MUTOOLS1.DI$ / README.M < prev    next >
Encoding:
Text File  |  1993-03-11  |  13.8 KB  |  299 lines

  1. % MUTOOLS - MU Analysis and Synthesis Toolbox 
  2. % This file contains a description of all mutools functions.
  3. % It begins with a list of functions in alphabetical order, 
  4. % followed by a list of functions grouped by subject area.
  5. %                                               14 April 91 
  6. % Summary of Commands
  7. % abv          Stack constant/varying/system matrices above one another
  8. % blknorm     Block norm of a constant/varying matrix
  9. % cjt         Conjugate transpose of a constant/varying/system matrix 
  10. % cos_tr     Generate a cosine signal as a varying matrix 
  11. % crand       Generate a complex random matrix 
  12. % csord      Ordered complex Schur form 
  13. % daug         Diagonal augmentation of constant/varying/system matrices
  14. % drawmag     Interactive moused-based sketch and fitting tool
  15. % dtrsp     Discrete time response of a linear system
  16. % dypert     Create a rational perturbation from frequency MU data
  17. % fitmag     Fit magnitude data with a real, rational, transfer function
  18. % fitmaglp     Fit magnitude data with a real, rational, transfer function
  19. % fitsys     Fit frequency response data with a transfer function
  20. % frsp         Frequency response of a system matrix
  21. % genphase      Generate a minimum phase frequency response to magnitude data
  22. % getiv     Get the independent variable of a varying matrix
  23. % h2norm     Calculate 2-norm of a stable, strictly proper system 
  24. % h2syn        H_2 control design
  25. % hankmr     Optimal Hankel norm approximation of a system
  26. % hinffi     H_infinity full information control design
  27. % hinfnorm     Calculate infinity norm of a stable, proper system
  28. % hinfsyn    H_infinity control design
  29. % indvcmp     Compare the independent variable data of two matrices
  30. % madd        Addition of constant/varying/system matrices
  31. % magfit    Fit frequency response data with a transfer function (Batch)
  32. % minfo        Information on a matrix
  33. % minv        Inverse of constant/varying/system matrices
  34. % mmult        Multiplication of constant/varying/system matrices
  35. % mprintf    Formatted printing of a matrix
  36. % mscl        Scale (by a scalar) a system or varying matrix
  37. % msub        Subtraction of constant/varying/system matrices
  38. % mu        mu-analysis of constant/varying matrices
  39. % muftbtch    A batch D scaling rational fit routine
  40. % musynfit    An interactive D scaling rational fit routine
  41. % musynflp    An interactive D scaling rational fit routine
  42. % nd2sys    Convert a SISO transfer function into a system matrix
  43. % negangle    Calculate angle of matrix elements between 0 and -2pi
  44. % pck        Create a system matrix from state-space data (A,B,C,D)
  45. % pkvnorm    Peak norm of varying matrix
  46. % pss2sys    Convert an [A B;C D] matrix into a mutools system matrix
  47. % randel    Generate a random perturbation
  48. % reordsys    Reorder states of the system
  49. % ric_eig    Solve a Riccati equation via eigenvalue decomposition
  50. % ric_schr    Solve a Riccati equation via real Schur decomposition
  51. % rifd        Display real, imaginary, frequency and damping data
  52. % samhld    Create a sample-hold approximation of a continuous system
  53. % sbs        Stack matrices next to one another
  54. % sclin        Scale system input
  55. % sclout    Scale system output
  56. % scliv        Scale the independent variable
  57. % sdecomp    Decompose a system matrix into two system matrices
  58. % see        Display varying/system matrices
  59. % seeiv        Print independent variables of a varying matrix
  60. % seesys    Formatted varying/system display
  61. % sel        Select rows/columns or outputs/inputs
  62. % sfrwtbal    Weighted balanced realization of a system matrix
  63. % sfrwtbld    Stable weighted balanced realization of a system matrix
  64. % sin_tr    Generate a sine signal as a varying matrix
  65. % siggen        Generate a signal as a varying matrix
  66. % sisorat    Fit a frequency point with a first order, all-pass,
  67. %         stable transfer function
  68. % sncfbal    Balanced realization of coprime factors of a system matrix
  69. % sortiv    Sort the independent variable
  70. % spoles    Poles of system matrix
  71. % srelbal    Stochastic balanced realization of a system matrix
  72. % sresid    Residualize states of a system matrix
  73. % starp        Redheffer star product
  74. % statecc    Apply a coordinate transformation to system matrices
  75. % step\_tr    Generate a step signal as a varying matrix
  76. % strans    Bidiagonal coordinate transformation of system matrices
  77. % strunc    Truncate states of a system matrix
  78. % sys2pss    Extract the state-space matrix [A B; C D] from a system matrix
  79. % sysbal    Balanced realization of a system matrix
  80. % sysic        System interconnection program
  81. % sysrand    Generate a random system matrix
  82. % szeros    Transmission zeros of a system matrix
  83. % tackon    String together varying matrices
  84. % transp    Transpose of varying/system matrices
  85. % trsp        Time response of a linear system
  86. % tustin    Prewarped continuous system to discrete system transformation
  87. % unpck        Extract state-space data (A,B,C,D) from a system matrix
  88. % unwrapd    Construct D scaling from MU
  89. % unwrapp    Construct Delta perturbation from MU
  90. % vabs        Absolute value of a varying/constant matrix
  91. % var2con    Convert a varying matrix to a constant matrix
  92. % varyrand    Generate a random varying matrix
  93. % vceil        Round elements of constant/varying matrices towards infinity
  94. % vconj        Conjugate of constant/varying matrices
  95. % vcjt        Conjugate transpace of constant/varying matrices
  96. % vdcmate    Decimate a varying matrix
  97. % vdet        Determinant of constant/varying matrices
  98. % vdiag        Diagonal of  constant/varying matrices
  99. % vebe        Element-by-element operations on varying matrices
  100. % veig        Eigenvalue decomposition of constant/varying matrices
  101. % veval        Evaluate general functions of varying matrices
  102. % vexpm        Exponential of  constant/varying matrices
  103. % vfft        FFT for varying matrices
  104. % vfloor    Round elements of constant/varying matrices towards -infinity
  105. % vifft        Inverse FFT for varying matrices
  106. % vinv        Inverse of a constant/varying matrix
  107. % vimag        Imaginary part of a constant/varying matrix
  108. % vinterp    Interpolate varying matrices
  109. % vldiv        Left division of constant/varying matrices
  110. % vnorm        Norm of varying/constant matrices
  111. % vpoly        Characteristic polynomial of varying/constant matrices
  112. % vpinv        Pseudoinverse of a constant/varying matrix
  113. % vplot        Plot a varying matrix
  114. % vpck        Pack a varying matrix
  115. % vrcond    Condition number of a constant/varying matrix
  116. % vrdiv        Right division of constant/varying matrices
  117. % vreal        Real part of a constant/varying matrix
  118. % vrho        Spectral radius of a varying/constant matrix
  119. % vroots    Polynomial roots of varying/constant matrices
  120. % vschur    Schur form of a varying/constant matrix.
  121. % vspect    Signal Processing % spectrum} command for varying matrices
  122. % vsvd        Singular value decomposition of a varying/constant matrix
  123. % vtp        Transpose of constant/varying matrices
  124. % vunpck    Unpack a varying matrix
  125. % vzoom        Mouse driven axis selection of plot window
  126. % xtract    Extract portions of a varying matrix
  127. % xtracti    Extract portions of  a varying matrix
  128. % zp2sys    Convert transfer function poles and zeros into system matrix
  129. %
  130. %___________________________________________________________________________
  131. %
  132. %                    COMMANDS GROUPED BY FUNCTION
  133. %
  134. %___________________________________________________________________________
  135. %
  136. % STANDARD OPERATIONS/ BASIC FUNCTIONS
  137. %
  138. % abv        Stack constant/varying/system matrices above one another
  139. % cjt        Conjugate transpose of varying/system matrices
  140. % daug        Diagonal augmentation of constant/varying/system matrices
  141. % madd        Addition of constant/varying/system matrices
  142. % minv        Inverse of constant/varying/system matrices
  143. % mmult        Multiplication of constant/varying/system matrices
  144. % mscl        Scale (by a scalar) a system or varying matrix
  145. % msub        Subtraction of constant/varying/system matrices
  146. % sbs        Stack matrices next to one another
  147. % sclin        Scale system input 
  148. % sclout    Scale system output
  149. % sel        Select rows/columns or outputs/inputs
  150. % starp        Redheffer star product
  151. % transp    Transpose of varying/system matrices
  152. %
  153. % MATRIX INFORMATION, DISPLAY AND PLOTTING
  154. %
  155. % drawmag    Interactive moused-based sketch and fitting tool
  156. % minfo        Information on a matrix
  157. % mprintf    Formatted printing of a matrix
  158. % rifd        Display real, imaginary, frequency and damping data
  159. % see        Display varying/system matrices
  160. % seeiv        Display independent variables of a varying matrix
  161. % seesys    Formatted varying/system display
  162. % vplot        Plot a varying matrix
  163. % vzoom        Mouse driven axis selection of plot window
  164. %
  165. % MODELING FUNCTIONS
  166. %
  167. % nd2sys    Convert a SISO transfer function into a system matrix
  168. % pck        Create a system matrix from state-space data (A,B,C,D)
  169. % pss2sys    Convert an [A B;C D] matrix into a mutools system matrix
  170. % sys2pss    Extract state-space matrix [A B; C D] from a system matrix
  171. % sysic        System interconnection program
  172. % unpck        Extract state-space data (A,B,C,D) from a system matrix
  173. % zp2sys    Convert transfer function poles and zeros to a system matrix
  174. %
  175. % SYSTEM MATRIX FUNCTIONS
  176. %
  177. % reordsys    Reorder states in a system matrix
  178. % samhld    Sample-hold approximation of a continuous system
  179. % spoles    Poles of system matrix
  180. % statecc    Apply a coordinate transformation to system matrices
  181. % strans    Bidiagonal coordinate transformation of system matrices
  182. % sysrand    Generate a random system matrix
  183. % szeros    Transmission zeros of a system matrix
  184. % tustin    Prewarped continuous to discrete system transformation 
  185. %
  186. % MODEL REDUCTION FUNCTIONS
  187. %
  188. % hankmr    Optimal Hankel norm approximation of a system
  189. % sdecomp    Decompose a system matrix into two system matrices
  190. % sfrwtbal    Frequency weighted balanced realization of a system matrix
  191. % sfrwtbld    Stable frequency weighted realization of a system matrix
  192. % sncfbal    Balanced realization of coprime factors of a system matrix
  193. % srelbal    Stochastic balanced realization of a system matrix
  194. % sresid    Residualize states of a system matrix
  195. % strunc    Truncate states of a system matrix
  196. % sysbal    Balanced realization of a system matrix
  197. %
  198. % SYSTEM RESPONSE FUNCTIONS
  199. %
  200. % cos_tr    Generate a cosine signal as a varying matrix 
  201. % dtrsp        Discrete time response of a linear system
  202. % frsp        Frequency response of a system matrix
  203. % sin_tr    Generate a sine signal as a varying matrix
  204. % siggen    Generate a signal as a varying matrix
  205. % step_tr    Generate a step signal as a varying matrix
  206. % trsp        Time response of a linear system
  207. %
  208. % H_2 and H_infinity ANALYSIS AND SYNTHESIS FUNCTIONS
  209. %
  210. % h2norm    Calculate 2-norm of a stable, strictly proper system 
  211. % h2syn        H_2 control design
  212. % hinffi    H_infinity full information control design
  213. % hinfnorm    Calculate infinity norm of a stable, proper system 
  214. % hinfsyn    H_infinity control design
  215. % pkvnorm    Peak norm of varying matrix
  216. %
  217. % STRUCTURED SINGULAR VALUE (MU) ANALYSIS AND SYNTHESIS
  218. %
  219. % blknorm    Block norm of constant/varying matrices
  220. % dypert    Create a rational perturbation from frequency MU data
  221. % fitmag    Fit magnitude data with real, rational, transfer function
  222. % fitmaglp    Fit magnitude data with real, rational, transfer function
  223. % fitsys    Fit frequency response data with transfer function
  224. % genphase    Generate a minimum phase frequency response to magnitude data
  225. % magfit    Fit magnitude data with real, rational, transfer 
  226. %                function (a batch process)
  227. % mu        mu analysis of constant/varying matrices
  228. % muftbtch    Batch D scaling rational fit routine
  229. % musynfit    Interactive D scaling rational fit routine
  230. % musynflp    Interactive D scaling rational fit routine 
  231. % randel    Generate a random perturbation
  232. % sisorat    Fit a frequency point with first order, all-pass, 
  233. %                stable transfer function
  234. % unwrapd    Construct D scaling from MU
  235. % unwrapp    Construct $\Delta$ perturbation from MU
  236. %
  237. % VARYING MATRIX MANIPULATION
  238. %
  239. % getiv        Get the independent variable of a varying matrix
  240. % indvcmp    Compare the independent variable data of two matrices
  241. % scliv        Scale the independent variable
  242. % sortiv    Sort the independent variable
  243. % tackon    String together varying matrices
  244. % var2con    Convert a varying matrix to a constant matrix
  245. % varyrand    Generate a random varying matrix
  246. % vpck        Pack a varying matrix
  247. % vunpck    Unpack a varying matrix
  248. % xtract    Extract portions of a varying matrix
  249. % xtracti    Extract portions of a varying matrix
  250. %
  251. % STANDARD MATLAB COMMANDS FOR VARYING MATRICES
  252. %
  253. % vabs        Absolute value of a constant/varying matrix
  254. % vceil        Round elements of constant/varying matrices towards infinity
  255. % vdet        Determinant of constant/varying matrices
  256. % vdiag        Diagonal of  constant/varying matrices
  257. % veig        Eigenvalue decomposition of constant/varying matrices
  258. % vexpm        Exponential of  constant/varying matrices
  259. % vfft        FFT for varying matrices
  260. % vfloor    Round elements of constant/varying matrices towards -infinity
  261. % vifft        Inverse FFT for varying matrices
  262. % vinv        Inverse of a constant/varying matrix
  263. % vimag        Imaginary part of a constant/varying matrix
  264. % vnorm        Norm of varying/constant matrices
  265. % vpoly        Characteristic polynomial of constant/varying matrices
  266. % vpinv        Pseudoinverse of a constant/varying matrix
  267. % vrcond    Condition number of a constant/varying matrix
  268. % vreal        Real part of a constant/varying matrix
  269. % vroots    Polynomial roots of constant/varying matrices
  270. % vschur    Schur form of a constant/varying matrix
  271. % vspect    Signal Processing spectrum command for varying matrices
  272. % vsvd        Singular value decomposition of a constant/varying matrix
  273. %
  274. % ADDITIONAL VARYING MATRIX FUNCTIONS
  275. %
  276. % vconj        Conjugate of constant/varying matrices
  277. % vcjt        Conjugate transpose of constant/varying matrices
  278. % vdcmate    Decimate varying matrices
  279. % vebe        Element-by-element operations on varying matrices
  280. % veval        Evaluate general functions of varying matrices
  281. % vinterp    Interpolate varying matrices
  282. % vldiv        Left division of constant/varying matrices
  283. % vrdiv        Right division of constant/varying matrices
  284. % vrho        Spectral radius of a constant/varying matrix
  285. % vtp        Transpose of constant/varying matrices
  286. %
  287. % UTILITIES AND MISCELLANEOUS FUNCTIONS
  288. %
  289. % crand        Complex random matrix generator
  290. % csord        Order complex Schur form matrices
  291. % negangle    Calculate angle of matrix elements between 0 and -2pi
  292. % ric_eig    Solve a Riccati equation via eigenvalue decomposition
  293. % ric_schr    Solve a Riccati equation via real Schur decomposition
  294. %
  295. % Use HELP on these files, or TYPE them for more information.
  296.