~ubuntu-branches/ubuntu/hoary/scilab/hoary

« back to all changes in this revision

Viewing changes to man/eng/linear/glever.xml

  • Committer: Bazaar Package Importer
  • Author(s): Torsten Werner
  • Date: 2005-01-09 22:58:21 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20050109225821-473xr8vhgugxxx5j
Tags: 3.0-12
changed configure.in to build scilab's own malloc.o, closes: #255869

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
 
2
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
 
3
<MAN>
 
4
  <LANGUAGE>eng</LANGUAGE>
 
5
  <TITLE>glever</TITLE>
 
6
  <TYPE>Scilab Function</TYPE>
 
7
  <DATE>April 1993</DATE>
 
8
  <SHORT_DESCRIPTION name="glever"> inverse of matrix pencil</SHORT_DESCRIPTION>
 
9
  <CALLING_SEQUENCE>
 
10
    <CALLING_SEQUENCE_ITEM>[Bfs,Bis,chis]=glever(E,A [,s])  </CALLING_SEQUENCE_ITEM>
 
11
  </CALLING_SEQUENCE>
 
12
  <PARAM>
 
13
    <PARAM_INDENT>
 
14
      <PARAM_ITEM>
 
15
        <PARAM_NAME>E, A</PARAM_NAME>
 
16
        <PARAM_DESCRIPTION>
 
17
          <SP>: two real square matrices of same dimensions</SP>
 
18
        </PARAM_DESCRIPTION>
 
19
      </PARAM_ITEM>
 
20
      <PARAM_ITEM>
 
21
        <PARAM_NAME>s</PARAM_NAME>
 
22
        <PARAM_DESCRIPTION>
 
23
          <SP>: character string (default value '<VERB>s</VERB>')</SP>
 
24
        </PARAM_DESCRIPTION>
 
25
      </PARAM_ITEM>
 
26
      <PARAM_ITEM>
 
27
        <PARAM_NAME>Bfs,Bis</PARAM_NAME>
 
28
        <PARAM_DESCRIPTION>
 
29
          <SP>: two polynomial matrices</SP>
 
30
        </PARAM_DESCRIPTION>
 
31
      </PARAM_ITEM>
 
32
      <PARAM_ITEM>
 
33
        <PARAM_NAME>chis</PARAM_NAME>
 
34
        <PARAM_DESCRIPTION>
 
35
          <SP>: polynomial</SP>
 
36
        </PARAM_DESCRIPTION>
 
37
      </PARAM_ITEM>
 
38
    </PARAM_INDENT>
 
39
  </PARAM>
 
40
  <DESCRIPTION>
 
41
    <P>
 
42
    Computation of</P>
 
43
    <P>
 
44
    (s*E-A)^-1</P>
 
45
    <P>
 
46
     by generalized Leverrier's algorithm for a matrix pencil.</P>
 
47
    <VERBATIM>
 
48
<![CDATA[
 
49
(s*E-A)^-1 = (Bfs/chis) - Bis.
 
50
   ]]>
 
51
    </VERBATIM>
 
52
    <P><VERB>chis</VERB> = characteristic polynomial (up to a multiplicative constant).</P>
 
53
    <P><VERB>Bfs</VERB>  = numerator polynomial matrix.</P>
 
54
    <P><VERB>Bis</VERB>
 
55
    = polynomial matrix ( - expansion of <VERB>(s*E-A)^-1</VERB> at infinity).</P>
 
56
    <P>
 
57
    Note the - sign before <VERB>Bis</VERB>.</P>
 
58
  </DESCRIPTION>
 
59
  <SECTION label="Caution">
 
60
    <P>
 
61
    This function uses <VERB>cleanp</VERB> to simplify <VERB>Bfs,Bis</VERB> and <VERB>chis</VERB>.</P>
 
62
  </SECTION>
 
63
  <EXAMPLE>
 
64
<![CDATA[
 
65
s=%s;F=[-1,s,0,0;0,-1,0,0;0,0,s-2,0;0,0,0,s-1];
 
66
[Bfs,Bis,chis]=glever(F)
 
67
inv(F)-((Bfs/chis) - Bis)
 
68
 ]]>
 
69
  </EXAMPLE>
 
70
  <SEE_ALSO>
 
71
    <SEE_ALSO_ITEM>
 
72
      <LINK>rowshuff</LINK>
 
73
    </SEE_ALSO_ITEM>
 
74
    <SEE_ALSO_ITEM>
 
75
      <LINK>det</LINK>
 
76
    </SEE_ALSO_ITEM>
 
77
    <SEE_ALSO_ITEM>
 
78
      <LINK>invr</LINK>
 
79
    </SEE_ALSO_ITEM>
 
80
    <SEE_ALSO_ITEM>
 
81
      <LINK>coffg</LINK>
 
82
    </SEE_ALSO_ITEM>
 
83
    <SEE_ALSO_ITEM>
 
84
      <LINK>pencan</LINK>
 
85
    </SEE_ALSO_ITEM>
 
86
    <SEE_ALSO_ITEM>
 
87
      <LINK>penlaur</LINK>
 
88
    </SEE_ALSO_ITEM>
 
89
  </SEE_ALSO>
 
90
  <AUTHOR>F. D. (1988)  </AUTHOR>
 
91
</MAN>