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

« back to all changes in this revision

Viewing changes to man/eng/control/lin.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>lin</TITLE>
 
6
  <TYPE>Scilab Function</TYPE>
 
7
  <DATE>April 1993</DATE>
 
8
  <SHORT_DESCRIPTION name="lin"> linearization</SHORT_DESCRIPTION>
 
9
  <CALLING_SEQUENCE>
 
10
    <CALLING_SEQUENCE_ITEM>[A,B,C,D]=lin(sim,x0,u0)  </CALLING_SEQUENCE_ITEM>
 
11
    <CALLING_SEQUENCE_ITEM>[sl]=lin(sim,x0,u0)  </CALLING_SEQUENCE_ITEM>
 
12
  </CALLING_SEQUENCE>
 
13
  <PARAM>
 
14
    <PARAM_INDENT>
 
15
      <PARAM_ITEM>
 
16
        <PARAM_NAME>sim</PARAM_NAME>
 
17
        <PARAM_DESCRIPTION>
 
18
          <SP>: function</SP>
 
19
        </PARAM_DESCRIPTION>
 
20
      </PARAM_ITEM>
 
21
      <PARAM_ITEM>
 
22
        <PARAM_NAME>x0, u0</PARAM_NAME>
 
23
        <PARAM_DESCRIPTION>
 
24
          <SP>: vectors of compatible dimensions</SP>
 
25
        </PARAM_DESCRIPTION>
 
26
      </PARAM_ITEM>
 
27
      <PARAM_ITEM>
 
28
        <PARAM_NAME>A,B,C,D</PARAM_NAME>
 
29
        <PARAM_DESCRIPTION>
 
30
          <SP>: real matrices</SP>
 
31
        </PARAM_DESCRIPTION>
 
32
      </PARAM_ITEM>
 
33
      <PARAM_ITEM>
 
34
        <PARAM_NAME>sl</PARAM_NAME>
 
35
        <PARAM_DESCRIPTION>
 
36
          <SP>: <VERB>syslin</VERB> list</SP>
 
37
        </PARAM_DESCRIPTION>
 
38
      </PARAM_ITEM>
 
39
    </PARAM_INDENT>
 
40
  </PARAM>
 
41
  <DESCRIPTION>
 
42
    <P>
 
43
    linearization of the non-linear system <VERB>[y,xdot]=sim(x,u)</VERB>
 
44
    around <VERB>x0,u0</VERB>.</P>
 
45
    <P><VERB>sim</VERB> is a function which computes <VERB>y</VERB> and <VERB>xdot</VERB>.</P>
 
46
    <P>
 
47
    The output is a linear system (<VERB>syslin</VERB> list) <VERB>sl</VERB> or the 
 
48
    four matrices <VERB>(A,B,C,D)</VERB></P>
 
49
    <P>
 
50
    For example, if <VERB>ftz</VERB> is the function passed to ode e.g.</P>
 
51
    <VERBATIM>
 
52
<![CDATA[
 
53
[zd]=ftz(t,z,u)
 
54
   ]]>
 
55
    </VERBATIM>
 
56
    <P>
 
57
    and if we assume that <VERB>y=x</VERB></P>
 
58
    <P><VERB>[z]=ode(x0,t0,tf,list(ftz,u)</VERB> compute <VERB>x(tf)</VERB>.</P>
 
59
    <P>
 
60
    If <VERB>simula</VERB> is the following function:</P>
 
61
    <VERBATIM>
 
62
<![CDATA[
 
63
deff('[y,xd]=simula(x,u)','xd=ftz(tf,x,u); y=x;');
 
64
   ]]>
 
65
    </VERBATIM>
 
66
    <P>
 
67
    the tangent linear system <VERB>sl</VERB> can be obtained by:</P>
 
68
    <VERBATIM>
 
69
<![CDATA[
 
70
[A,B,C,D]=lin(simula,z,u)
 
71
sl = syslin('c',A,B,C,D,x0)
 
72
   ]]>
 
73
    </VERBATIM>
 
74
  </DESCRIPTION>
 
75
  <EXAMPLE>
 
76
<![CDATA[
 
77
deff('[y,xdot]=sim(x,u)','xdot=[u*sin(x);-u*x^2];y=xdot(1)+xdot(2)')
 
78
sl=lin(sim,1,2);
 
79
 ]]>
 
80
  </EXAMPLE>
 
81
  <SEE_ALSO>
 
82
    <SEE_ALSO_ITEM>
 
83
      <LINK>external</LINK>
 
84
    </SEE_ALSO_ITEM>
 
85
    <SEE_ALSO_ITEM>
 
86
      <LINK>derivat</LINK>
 
87
    </SEE_ALSO_ITEM>
 
88
  </SEE_ALSO>
 
89
</MAN>