← Back to branch summary

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

« back to all changes in this revision

Viewing changes to modules/differential_equations/help/pt_BR/int2d.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:
modules/differential_equations/help/pt_BR/int2d.xml
12
12
 *
13
13
 -->
14
14
<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="int2d" xml:lang="en">
15
 
  <refnamediv>
16
 
    <refname>int2d</refname>
17
 
    <refpurpose>integral definida 2d por quadratura e cubatura</refpurpose>
18
 
  </refnamediv>
19
 
  <refsynopsisdiv>
20
 
    <title>Seq��ncia de Chamamento</title>
21
 
    <synopsis>[I,err]=int2d(X,Y,f [,params])</synopsis>
22
 
  </refsynopsisdiv>
23
 
  <refsection>
24
 
    <title>Par�metros</title>
25
 
    <variablelist>
26
 
      <varlistentry>
27
 
        <term>X</term>
28
 
        <listitem>
29
 
          <para>um array 3 por N contendo as abscissas dos vertices dos N
30
 
            tri�ngulos.
31
 
          </para>
32
 
        </listitem>
33
 
      </varlistentry>
34
 
      <varlistentry>
35
 
        <term>Y</term>
36
 
        <listitem>
37
 
          <para>um array 3 por N contendo as ordenadas dos vertices dos N
38
 
            tri�ngulos.
39
 
          </para>
40
 
        </listitem>
41
 
      </varlistentry>
42
 
      <varlistentry>
43
 
        <term>f</term>
44
 
        <listitem>
45
 
          <para>fun��o externa (fun��o, string ou lista) definindo o
46
 
            integrando <literal>f(u,v)</literal>;
47
 
          </para>
48
 
        </listitem>
49
 
      </varlistentry>
50
 
      <varlistentry>
51
 
        <term>params</term>
52
 
        <listitem>
53
 
          <para>
54
 
            vetor de reais <literal>[tol, iclose, maxtri, mevals,
55
 
              iflag]
56
 
            </literal>
57
 
            .O valor padr�o � <literal>[1.d-10, 1, 50, 4000,
58
 
              1]
59
 
            </literal>
60
 
            .
61
 
          </para>
62
 
          <variablelist>
63
 
            <varlistentry>
64
 
              <term>tol</term>
65
 
              <listitem>
66
 
                <para>o limite desejado do erro. Se
67
 
                  <literal>iflag=0</literal>, <literal>tol</literal> �
68
 
                  interpretado como um limite de erro relativo; se
69
 
                  <literal>iflag=</literal>1, o limite � de erro
70
 
                  absoluto.
71
 
                </para>
72
 
              </listitem>
73
 
            </varlistentry>
74
 
            <varlistentry>
75
 
              <term>iclose</term>
76
 
              <listitem>
77
 
                <para>um inteiro que determina a sele��o dos m�todos LQM0 ou
78
 
                  LQM. Se <literal>iclose=1</literal> , ent�o LQM1 � utilizado.
79
 
                  Qualquer outro valor de <literal>iclose</literal> faz com que
80
 
                  LQM0 seja usado. LQM0 utiliza valores da fun��o apenas em
81
 
                  pontos interiores ao tri�ngulo. LQM1 geralmente � mais preciso
82
 
                  que LQM0 mas envolve a avalia��o do integrando em mais pontos,
83
 
                  incluindo em alguns pontos da fronteira do tri�ngulo.
84
 
                  Geralmente � melhor utilizar LQM1 a n�o ser que o integrando
85
 
                  possuia singularidades nas bordas do tri�ngulo.
86
 
                </para>
87
 
              </listitem>
88
 
            </varlistentry>
89
 
            <varlistentry>
90
 
              <term>maxtri</term>
91
 
              <listitem>
92
 
                <para>o n�mero m�ximo de tri�ngulos na triangulariza��o final
93
 
                  da regi�o
94
 
                </para>
95
 
              </listitem>
96
 
            </varlistentry>
97
 
            <varlistentry>
98
 
              <term>mevals</term>
99
 
              <listitem>
100
 
                <para>o n�mero m�ximo de avalia��es da fun��o permitido. Este
101
 
                  n�mero ter� efeito na limita��o da computa��o se for menor que
102
 
                  94*<literal>maxtri</literal> quando LQM1 � especificado ou
103
 
                  56*<literal>maxtri</literal> quando LQM0 �
104
 
                  especificado.
105
 
                </para>
106
 
              </listitem>
107
 
            </varlistentry>
108
 
            <varlistentry>
109
 
              <term>iflag</term>
110
 
              <listitem>
111
 
                <para/>
112
 
              </listitem>
113
 
            </varlistentry>
114
 
          </variablelist>
115
 
        </listitem>
116
 
      </varlistentry>
117
 
      <varlistentry>
118
 
        <term>I</term>
119
 
        <listitem>
120
 
          <para>o valor da integral</para>
121
 
        </listitem>
122
 
      </varlistentry>
123
 
      <varlistentry>
124
 
        <term>err</term>
125
 
        <listitem>
126
 
          <para>o erro estimado</para>
127
 
        </listitem>
128
 
      </varlistentry>
129
 
    </variablelist>
130
 
  </refsection>
131
 
  <refsection>
132
 
    <title>Descri��o</title>
133
 
    <para>
134
 
      <literal>int2d</literal> computa a integral bidimensional de uma
135
 
      fun��o <literal>f</literal> sobre uma regi�o que consiste de
136
 
      <literal>n</literal> tri�ngulos. Um estimativa de erro total � obtida e
137
 
      comparada a - <literal>tol</literal> - que � fornecida como entrada para a
138
 
      subrotina. A toler�ncia de erro � tratada como relativa ou absoluta
139
 
      dependendo do valor de entrada de <literal>iflag</literal>. Um "m�dulo de
140
 
      quadratura local" ("Local Quadrature Module") � aplicado para cada
141
 
      tri�ngulo de entrada e estimativas da integral total e do erro total s�o
142
 
      computadas. O m�dulo de quadratura local � a subrotina LQM0 ou a subrotina
143
 
      LQM1 e a escolha entre elas � determinada pelo valor da vari�vel
144
 
      <literal>iclose</literal>.
145
 
    </para>
146
 
    <para>Se a estimativa de erro total excede a toler�ncia, o tri�ngulo com
147
 
      maior erro absoluto � dividio em dois outro tri�ngulos tra�ando-se uma
148
 
      mediana por seu maior lado. O m�dulo de quadratura local � ent�o aplicado
149
 
      a cada um dos subtri�ngulos para se obter novas estimativas da integral e
150
 
      do erro. Este processo � repetido at� que um dos seguintes (1) a
151
 
      toler�ncia � satisfeita, (2) o n�mero de tri�ngulos gerados excede o
152
 
      par�metro <literal>maxtri</literal>, (3) o n�mero de avalia��es do
153
 
      integrando excede o par�metro <literal>mevals</literal>, ou (4) a fun��o
154
 
      sente que um erro de arredondamento est� come�ando a contaminar o
155
 
      resultado.
156
 
    </para>
157
 
  </refsection>
158
 
  <refsection>
159
 
    <title>Exemplos</title>
160
 
    <programlisting role="example"><![CDATA[ 
 
15
    <refnamediv>
 
16
        <refname>int2d</refname>
 
17
        <refpurpose>integral definida 2d por quadratura e cubatura</refpurpose>
 
18
    </refnamediv>
 
19
    <refsynopsisdiv>
 
20
        <title>Seq��ncia de Chamamento</title>
 
21
        <synopsis>[I,err]=int2d(X,Y,f [,params])</synopsis>
 
22
    </refsynopsisdiv>
 
23
    <refsection>
 
24
        <title>Par�metros</title>
 
25
        <variablelist>
 
26
            <varlistentry>
 
27
                <term>X</term>
 
28
                <listitem>
 
29
                    <para>um array 3 por N contendo as abscissas dos vertices dos N
 
30
                        tri�ngulos.
 
31
                    </para>
 
32
                </listitem>
 
33
            </varlistentry>
 
34
            <varlistentry>
 
35
                <term>Y</term>
 
36
                <listitem>
 
37
                    <para>um array 3 por N contendo as ordenadas dos vertices dos N
 
38
                        tri�ngulos.
 
39
                    </para>
 
40
                </listitem>
 
41
            </varlistentry>
 
42
            <varlistentry>
 
43
                <term>f</term>
 
44
                <listitem>
 
45
                    <para>fun��o externa (fun��o, string ou lista) definindo o
 
46
                        integrando <literal>f(u,v)</literal>;
 
47
                    </para>
 
48
                </listitem>
 
49
            </varlistentry>
 
50
            <varlistentry>
 
51
                <term>params</term>
 
52
                <listitem>
 
53
                    <para>
 
54
                        vetor de reais <literal>[tol, iclose, maxtri, mevals,
 
55
                            iflag]
 
56
                        </literal>
 
57
                        .O valor padr�o � <literal>[1.d-10, 1, 50, 4000,
 
58
                            1]
 
59
                        </literal>
 
60
                        .
 
61
                    </para>
 
62
                    <variablelist>
 
63
                        <varlistentry>
 
64
                            <term>tol</term>
 
65
                            <listitem>
 
66
                                <para>o limite desejado do erro. Se
 
67
                                    <literal>iflag=0</literal>, <literal>tol</literal> �
 
68
                                    interpretado como um limite de erro relativo; se
 
69
                                    <literal>iflag=</literal>1, o limite � de erro
 
70
                                    absoluto.
 
71
                                </para>
 
72
                            </listitem>
 
73
                        </varlistentry>
 
74
                        <varlistentry>
 
75
                            <term>iclose</term>
 
76
                            <listitem>
 
77
                                <para>um inteiro que determina a sele��o dos m�todos LQM0 ou
 
78
                                    LQM. Se <literal>iclose=1</literal> , ent�o LQM1 � utilizado.
 
79
                                    Qualquer outro valor de <literal>iclose</literal> faz com que
 
80
                                    LQM0 seja usado. LQM0 utiliza valores da fun��o apenas em
 
81
                                    pontos interiores ao tri�ngulo. LQM1 geralmente � mais preciso
 
82
                                    que LQM0 mas envolve a avalia��o do integrando em mais pontos,
 
83
                                    incluindo em alguns pontos da fronteira do tri�ngulo.
 
84
                                    Geralmente � melhor utilizar LQM1 a n�o ser que o integrando
 
85
                                    possuia singularidades nas bordas do tri�ngulo.
 
86
                                </para>
 
87
                            </listitem>
 
88
                        </varlistentry>
 
89
                        <varlistentry>
 
90
                            <term>maxtri</term>
 
91
                            <listitem>
 
92
                                <para>o n�mero m�ximo de tri�ngulos na triangulariza��o final
 
93
                                    da regi�o
 
94
                                </para>
 
95
                            </listitem>
 
96
                        </varlistentry>
 
97
                        <varlistentry>
 
98
                            <term>mevals</term>
 
99
                            <listitem>
 
100
                                <para>o n�mero m�ximo de avalia��es da fun��o permitido. Este
 
101
                                    n�mero ter� efeito na limita��o da computa��o se for menor que
 
102
                                    94*<literal>maxtri</literal> quando LQM1 � especificado ou
 
103
                                    56*<literal>maxtri</literal> quando LQM0 �
 
104
                                    especificado.
 
105
                                </para>
 
106
                            </listitem>
 
107
                        </varlistentry>
 
108
                        <varlistentry>
 
109
                            <term>iflag</term>
 
110
                            <listitem>
 
111
                                <para/>
 
112
                            </listitem>
 
113
                        </varlistentry>
 
114
                    </variablelist>
 
115
                </listitem>
 
116
            </varlistentry>
 
117
            <varlistentry>
 
118
                <term>I</term>
 
119
                <listitem>
 
120
                    <para>o valor da integral</para>
 
121
                </listitem>
 
122
            </varlistentry>
 
123
            <varlistentry>
 
124
                <term>err</term>
 
125
                <listitem>
 
126
                    <para>o erro estimado</para>
 
127
                </listitem>
 
128
            </varlistentry>
 
129
        </variablelist>
 
130
    </refsection>
 
131
    <refsection>
 
132
        <title>Descri��o</title>
 
133
        <para>
 
134
            <literal>int2d</literal> computa a integral bidimensional de uma
 
135
            fun��o <literal>f</literal> sobre uma regi�o que consiste de
 
136
            <literal>n</literal> tri�ngulos. Um estimativa de erro total � obtida e
 
137
            comparada a - <literal>tol</literal> - que � fornecida como entrada para a
 
138
            subrotina. A toler�ncia de erro � tratada como relativa ou absoluta
 
139
            dependendo do valor de entrada de <literal>iflag</literal>. Um "m�dulo de
 
140
            quadratura local" ("Local Quadrature Module") � aplicado para cada
 
141
            tri�ngulo de entrada e estimativas da integral total e do erro total s�o
 
142
            computadas. O m�dulo de quadratura local � a subrotina LQM0 ou a subrotina
 
143
            LQM1 e a escolha entre elas � determinada pelo valor da vari�vel
 
144
            <literal>iclose</literal>.
 
145
        </para>
 
146
        <para>Se a estimativa de erro total excede a toler�ncia, o tri�ngulo com
 
147
            maior erro absoluto � dividio em dois outro tri�ngulos tra�ando-se uma
 
148
            mediana por seu maior lado. O m�dulo de quadratura local � ent�o aplicado
 
149
            a cada um dos subtri�ngulos para se obter novas estimativas da integral e
 
150
            do erro. Este processo � repetido at� que um dos seguintes (1) a
 
151
            toler�ncia � satisfeita, (2) o n�mero de tri�ngulos gerados excede o
 
152
            par�metro <literal>maxtri</literal>, (3) o n�mero de avalia��es do
 
153
            integrando excede o par�metro <literal>mevals</literal>, ou (4) a fun��o
 
154
            sente que um erro de arredondamento est� come�ando a contaminar o
 
155
            resultado.
 
156
        </para>
 
157
    </refsection>
 
158
    <refsection>
 
159
        <title>Exemplos</title>
 
160
        <programlisting role="example"><![CDATA[ 
161
161
X=[0,0;1,1;1,0];
162
162
Y=[0,0;0,1;1,1];
163
163
deff('z=f(x,y)','z=cos(x+y)')
164
164
[I,e]=int2d(X,Y,f)
165
165
// computa o integrando sobre o quadrado [0 1]x[0 1]
166
166
 ]]></programlisting>
167
 
  </refsection>
168
 
  <refsection role="see also">
169
 
    <title>Ver Tamb�m</title>
170
 
    <simplelist type="inline">
171
 
      <member>
172
 
        <link linkend="intc">intc</link>
173
 
      </member>
174
 
      <member>
175
 
        <link linkend="intl">intl</link>
176
 
      </member>
177
 
      <member>
178
 
        <link linkend="int3d">int3d</link>
179
 
      </member>
180
 
      <member>
181
 
        <link linkend="intg">intg</link>
182
 
      </member>
183
 
      <member>
184
 
        <link linkend="mesh">mesh</link>
185
 
      </member>
186
 
    </simplelist>
187
 
  </refsection>
 
167
    </refsection>
 
168
    <refsection role="see also">
 
169
        <title>Ver Tamb�m</title>
 
170
        <simplelist type="inline">
 
171
            <member>
 
172
                <link linkend="intc">intc</link>
 
173
            </member>
 
174
            <member>
 
175
                <link linkend="intl">intl</link>
 
176
            </member>
 
177
            <member>
 
178
                <link linkend="int3d">int3d</link>
 
179
            </member>
 
180
            <member>
 
181
                <link linkend="intg">intg</link>
 
182
            </member>
 
183
            <member>
 
184
                <link linkend="mesh">mesh</link>
 
185
            </member>
 
186
        </simplelist>
 
187
    </refsection>
188
188
</refentry>