~ubuntu-branches/ubuntu/raring/scilab/raring-proposed

« back to all changes in this revision

Viewing changes to modules/interpolation/help/pt_BR/linear_interpn.xml

  • Committer: Package Import Robot
  • Author(s): Sylvestre Ledru
  • Date: 2012-08-30 14:42:38 UTC
  • mfrom: (1.4.7)
  • Revision ID: package-import@ubuntu.com-20120830144238-c1y2og7dbm7m9nig
Tags: 5.4.0-beta-3-1~exp1
* New upstream release
* Update the scirenderer dep
* Get ride of libjhdf5-java dependency

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
<?xml version="1.0" encoding="ISO-8859-1"?>
2
2
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:id="linear_interpn" xml:lang="en">
3
 
  <refnamediv>
4
 
    <refname>linear_interpn</refname>
5
 
    <refpurpose>interpola��o linear n-dimensional</refpurpose>
6
 
  </refnamediv>
7
 
  <refsynopsisdiv>
8
 
    <title>Seq��ncia de Chamamento</title>
9
 
    <synopsis>vp = linear_interpn(xp1,xp2,..,xpn, x1, ..., xn, v [,out_mode])</synopsis>
10
 
  </refsynopsisdiv>
11
 
  <refsection>
12
 
    <title>Par�metros</title>
13
 
    <variablelist>
14
 
      <varlistentry>
15
 
        <term>xp1, xp2, .., xpn</term>
16
 
        <listitem>
17
 
          <para>vetores de reais (ou matrizes) de mesmo tamanho </para>
18
 
        </listitem>
19
 
      </varlistentry>
20
 
      <varlistentry>
21
 
        <term>x1 ,x2, ..., xn</term>
22
 
        <listitem>
23
 
          <para> vetores linhas estritamente crescentes (com pelo menos 2
24
 
            elementos) definindo o grid de interpola��o n-dimensional 
25
 
          </para>
26
 
        </listitem>
27
 
      </varlistentry>
28
 
      <varlistentry>
29
 
        <term>v</term>
30
 
        <listitem>
31
 
          <para>vetor (caso n=1), matriz (caso n=2) ou hipermatriz (caso n
32
 
            &gt; 2) com valores da fun��o subjacente interpolada nos pontos do
33
 
            grid. 
34
 
          </para>
35
 
        </listitem>
36
 
      </varlistentry>
37
 
      <varlistentry>
38
 
        <term>out_mode</term>
39
 
        <listitem>
40
 
          <para>(opcional) string definindo a avalia��o fora do grid
41
 
            (extrapola��o)
42
 
          </para>
43
 
        </listitem>
44
 
      </varlistentry>
45
 
      <varlistentry>
46
 
        <term>vp</term>
47
 
        <listitem>
48
 
          <para>
49
 
            vetor ou matriz de mesmo tamanho que <literal>xp1, ...,
50
 
              xpn
 
3
    <refnamediv>
 
4
        <refname>linear_interpn</refname>
 
5
        <refpurpose>interpola��o linear n-dimensional</refpurpose>
 
6
    </refnamediv>
 
7
    <refsynopsisdiv>
 
8
        <title>Seq��ncia de Chamamento</title>
 
9
        <synopsis>vp = linear_interpn(xp1,xp2,..,xpn, x1, ..., xn, v [,out_mode])</synopsis>
 
10
    </refsynopsisdiv>
 
11
    <refsection>
 
12
        <title>Par�metros</title>
 
13
        <variablelist>
 
14
            <varlistentry>
 
15
                <term>xp1, xp2, .., xpn</term>
 
16
                <listitem>
 
17
                    <para>vetores de reais (ou matrizes) de mesmo tamanho </para>
 
18
                </listitem>
 
19
            </varlistentry>
 
20
            <varlistentry>
 
21
                <term>x1 ,x2, ..., xn</term>
 
22
                <listitem>
 
23
                    <para> vetores linhas estritamente crescentes (com pelo menos 2
 
24
                        elementos) definindo o grid de interpola��o n-dimensional 
 
25
                    </para>
 
26
                </listitem>
 
27
            </varlistentry>
 
28
            <varlistentry>
 
29
                <term>v</term>
 
30
                <listitem>
 
31
                    <para>vetor (caso n=1), matriz (caso n=2) ou hipermatriz (caso n
 
32
                        &gt; 2) com valores da fun��o subjacente interpolada nos pontos do
 
33
                        grid. 
 
34
                    </para>
 
35
                </listitem>
 
36
            </varlistentry>
 
37
            <varlistentry>
 
38
                <term>out_mode</term>
 
39
                <listitem>
 
40
                    <para>(opcional) string definindo a avalia��o fora do grid
 
41
                        (extrapola��o)
 
42
                    </para>
 
43
                </listitem>
 
44
            </varlistentry>
 
45
            <varlistentry>
 
46
                <term>vp</term>
 
47
                <listitem>
 
48
                    <para>
 
49
                        vetor ou matriz de mesmo tamanho que <literal>xp1, ...,
 
50
                            xpn
 
51
                        </literal>
 
52
                    </para>
 
53
                </listitem>
 
54
            </varlistentry>
 
55
        </variablelist>
 
56
    </refsection>
 
57
    <refsection>
 
58
        <title>Descri��o</title>
 
59
        <para>
 
60
            Dado um grid n-dimensional definido pelos n vetores <literal>x1 ,x2,
 
61
                ..., xn
51
62
            </literal>
52
 
          </para>
53
 
        </listitem>
54
 
      </varlistentry>
55
 
    </variablelist>
56
 
  </refsection>
57
 
  <refsection>
58
 
    <title>Descri��o</title>
59
 
    <para>
60
 
      Dado um grid n-dimensional definido pelos n vetores <literal>x1 ,x2,
61
 
        ..., xn
62
 
      </literal>
63
 
      eos valores <literal>v</literal> de uma fun��o (aqui
64
 
      nomeada <emphasis>f</emphasis>) nos pontos do grid : 
65
 
    </para>
66
 
    <programlisting role=""><![CDATA[ 
 
63
            eos valores <literal>v</literal> de uma fun��o (aqui
 
64
            nomeada <emphasis>f</emphasis>) nos pontos do grid : 
 
65
        </para>
 
66
        <programlisting role=""><![CDATA[ 
67
67
v(i1,i2,...,in) = f(x1(i1),x2(i2), ..., xn(in))
68
68
 ]]></programlisting>
69
 
    <para>
70
 
      esta fun��o computa o interpolante linear de <emphasis>f</emphasis>
71
 
      do grid (chamado de s a partir daqui) nos pontos nos quais as coordenadas
72
 
      s�o definidas pelos vetores (ou matrizes) <literal>xp1, xp2, ...,
73
 
        xpn
74
 
      </literal>
75
 
      :
76
 
    </para>
77
 
    <programlisting role=""><![CDATA[ 
 
69
        <para>
 
70
            esta fun��o computa o interpolante linear de <emphasis>f</emphasis>
 
71
            do grid (chamado de s a partir daqui) nos pontos nos quais as coordenadas
 
72
            s�o definidas pelos vetores (ou matrizes) <literal>xp1, xp2, ...,
 
73
                xpn
 
74
            </literal>
 
75
            :
 
76
        </para>
 
77
        <programlisting role=""><![CDATA[ 
78
78
vp(i) = s(xp1(i),xp2(i), ..., xpn(i))
79
79
 
80
80
or vp(i,j) = s(xp1(i,j),xp2(i,j), ..., xpn(i,j)) caso xpk sejam matrizes
81
81
 ]]></programlisting>
82
 
    <para>
83
 
      O par�metro <literal>out_mode</literal> ajusta a regra para
84
 
      extrapola��o: se notarmos
85
 
      <emphasis>Pi=(xp1(i),xp2(i),...,xpn(i))</emphasis> , ent�o
86
 
      <literal>out_mode</literal> define a regra de avalia��o quando: 
87
 
    </para>
88
 
    <programlisting role=""><![CDATA[ 
 
82
        <para>
 
83
            O par�metro <literal>out_mode</literal> ajusta a regra para
 
84
            extrapola��o: se notarmos
 
85
            <emphasis>Pi=(xp1(i),xp2(i),...,xpn(i))</emphasis> , ent�o
 
86
            <literal>out_mode</literal> define a regra de avalia��o quando: 
 
87
        </para>
 
88
        <programlisting role=""><![CDATA[ 
89
89
P(i) est� fora de  [x1(1) x1($)] x [x2(1) x2($)] x ... x [xn(1) xn($)]
90
90
 ]]></programlisting>
91
 
    <para>As escolhas s�o: </para>
92
 
    <variablelist>
93
 
      <varlistentry>
94
 
        <term>"by_zero"</term>
95
 
        <listitem>
96
 
          <para>uma extrapola��o por zero � feita </para>
97
 
        </listitem>
98
 
      </varlistentry>
99
 
      <varlistentry>
100
 
        <term>"by_nan"</term>
101
 
        <listitem>
102
 
          <para>uma extrapola��o por NaN </para>
103
 
        </listitem>
104
 
      </varlistentry>
105
 
      <varlistentry>
106
 
        <term>"C0"</term>
107
 
        <listitem>
108
 
          <para>a extrapola��o � definida como segue: </para>
109
 
          <programlisting role=""><![CDATA[ 
 
91
        <para>As escolhas s�o: </para>
 
92
        <variablelist>
 
93
            <varlistentry>
 
94
                <term>"by_zero"</term>
 
95
                <listitem>
 
96
                    <para>uma extrapola��o por zero � feita </para>
 
97
                </listitem>
 
98
            </varlistentry>
 
99
            <varlistentry>
 
100
                <term>"by_nan"</term>
 
101
                <listitem>
 
102
                    <para>uma extrapola��o por NaN </para>
 
103
                </listitem>
 
104
            </varlistentry>
 
105
            <varlistentry>
 
106
                <term>"C0"</term>
 
107
                <listitem>
 
108
                    <para>a extrapola��o � definida como segue: </para>
 
109
                    <programlisting role=""><![CDATA[ 
110
110
s(P) = s(proj(P)) onde  proj(P) � o ponto mais pr�ximo de P 
111
111
                  localizado na fronteira do grid.
112
112
 ]]></programlisting>
113
 
        </listitem>
114
 
      </varlistentry>
115
 
      <varlistentry>
116
 
        <term>"natural"</term>
117
 
        <listitem>
118
 
          <para>a extrapola��o � feita usando o remendo n-linear mais pr�ximo
119
 
            do ponto.
120
 
          </para>
121
 
        </listitem>
122
 
      </varlistentry>
123
 
      <varlistentry>
124
 
        <term>"periodic"</term>
125
 
        <listitem>
126
 
          <para>
127
 
            <literal>s</literal> � estendido por periodicidade.
128
 
          </para>
129
 
        </listitem>
130
 
      </varlistentry>
131
 
    </variablelist>
132
 
  </refsection>
133
 
  <refsection>
134
 
    <title>Exemplos </title>
135
 
    <programlisting role="example"><![CDATA[ 
 
113
                </listitem>
 
114
            </varlistentry>
 
115
            <varlistentry>
 
116
                <term>"natural"</term>
 
117
                <listitem>
 
118
                    <para>a extrapola��o � feita usando o remendo n-linear mais pr�ximo
 
119
                        do ponto.
 
120
                    </para>
 
121
                </listitem>
 
122
            </varlistentry>
 
123
            <varlistentry>
 
124
                <term>"periodic"</term>
 
125
                <listitem>
 
126
                    <para>
 
127
                        <literal>s</literal> � estendido por periodicidade.
 
128
                    </para>
 
129
                </listitem>
 
130
            </varlistentry>
 
131
        </variablelist>
 
132
    </refsection>
 
133
    <refsection>
 
134
        <title>Exemplos </title>
 
135
        <programlisting role="example"><![CDATA[ 
136
136
// exemplo 1 : interpola��o linear 1d
137
137
x = linspace(0,2*%pi,11);
138
138
y = sin(x);
232
232
xtitle("Interpola��o trilinear de"+func)
233
233
show_window()
234
234
 ]]></programlisting>
235
 
  </refsection>
236
 
  <refsection role="see also">
237
 
    <title>Ver Tamb�m</title>
238
 
    <simplelist type="inline">
239
 
      <member>
240
 
        <link linkend="interpln">interpln</link>
241
 
      </member>
242
 
      <member>
243
 
        <link linkend="splin">splin</link>
244
 
      </member>
245
 
      <member>
246
 
        <link linkend="splin2d">splin2d</link>
247
 
      </member>
248
 
      <member>
249
 
        <link linkend="splin3d">splin3d</link>
250
 
      </member>
251
 
    </simplelist>
252
 
  </refsection>
 
235
    </refsection>
 
236
    <refsection role="see also">
 
237
        <title>Ver Tamb�m</title>
 
238
        <simplelist type="inline">
 
239
            <member>
 
240
                <link linkend="interpln">interpln</link>
 
241
            </member>
 
242
            <member>
 
243
                <link linkend="splin">splin</link>
 
244
            </member>
 
245
            <member>
 
246
                <link linkend="splin2d">splin2d</link>
 
247
            </member>
 
248
            <member>
 
249
                <link linkend="splin3d">splin3d</link>
 
250
            </member>
 
251
        </simplelist>
 
252
    </refsection>
253
253
</refentry>