← 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/int3d.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/int3d.xml
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:ns3="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="int3d" xml:lang="en">
3
 
  <refnamediv>
4
 
    <refname>int3d</refname>
5
 
    <refpurpose>integral definida 3d pelo m�todo da quadratura e
6
 
      cubatura
7
 
    </refpurpose>
8
 
  </refnamediv>
9
 
  <refsynopsisdiv>
10
 
    <title>Seq��ncia de Chamamento</title>
11
 
    <synopsis>[result,err]=int3d(X,Y,Z,f [,nf[,params]])</synopsis>
12
 
  </refsynopsisdiv>
13
 
  <refsection>
14
 
    <title>Par�metros</title>
15
 
    <variablelist>
16
 
      <varlistentry>
17
 
        <term>X</term>
18
 
        <listitem>
19
 
          <para>
20
 
            um array 4 por <literal>NUMTET</literal> contendo as abscissas
21
 
            dos v�rtices dos <literal>NUMTET</literal> tetraedros.
22
 
          </para>
23
 
        </listitem>
24
 
      </varlistentry>
25
 
      <varlistentry>
26
 
        <term>Y</term>
27
 
        <listitem>
28
 
          <para>
29
 
            um array 4 por <literal>NUMTET</literal> contendo as ordenadas
30
 
            dos v�rtices dos <literal>NUMTET</literal> tetraedros.
31
 
          </para>
32
 
        </listitem>
33
 
      </varlistentry>
34
 
      <varlistentry>
35
 
        <term>Z</term>
36
 
        <listitem>
37
 
          <para>
38
 
            um array 4 por <literal>NUMTET</literal> contendo as terceiras
39
 
            coordenadas dos v�rtices dos <literal>NUMTET</literal>
40
 
            tetraedros.
41
 
          </para>
42
 
        </listitem>
43
 
      </varlistentry>
44
 
      <varlistentry>
45
 
        <term>f</term>
46
 
        <listitem>
47
 
          <para>fun��o externa (function, string ou lista) definindo o
48
 
            integrando <literal>f(xyz,nf)</literal>, onde <literal>xyz</literal>
49
 
            � o vetor das coordenadas de um ponto e nf os n�meros das
50
 
            fun��es
51
 
          </para>
52
 
        </listitem>
53
 
      </varlistentry>
54
 
      <varlistentry>
55
 
        <term>nf</term>
56
 
        <listitem>
57
 
          <para>o n�mero da fun��o a ser integrada (o padr�o � 1)</para>
58
 
        </listitem>
59
 
      </varlistentry>
60
 
      <varlistentry>
61
 
        <term>params</term>
62
 
        <listitem>
63
 
          <para>
64
 
            vetor de reais <literal>[minpts, maxpts, epsabs,
65
 
              epsrel]
66
 
            </literal>
67
 
            .O valor padr�o � <literal>[0, 1000, 0.0,
68
 
              1.d-5]
69
 
            </literal>
70
 
            .
71
 
          </para>
72
 
          <variablelist>
73
 
            <varlistentry>
74
 
              <term>epsabs</term>
75
 
              <listitem>
76
 
                <para>limite do erro absoluto desejado</para>
77
 
              </listitem>
78
 
            </varlistentry>
79
 
            <varlistentry>
80
 
              <term>epsrel</term>
81
 
              <listitem>
82
 
                <para>limite do erro relativo desejado</para>
83
 
              </listitem>
84
 
            </varlistentry>
85
 
            <varlistentry>
86
 
              <term>minpts</term>
87
 
              <listitem>
88
 
                <para>n�mero m�nimo de avalia��es da fun��o</para>
89
 
              </listitem>
90
 
            </varlistentry>
91
 
            <varlistentry>
92
 
              <term>maxpts</term>
93
 
              <listitem>
94
 
                <para>n�mero m�ximo de avalia��es da fun��o. O n�mero de
95
 
                  avalia��es da fun��o sobre cada subregi�o � 43
96
 
                </para>
97
 
              </listitem>
98
 
            </varlistentry>
99
 
          </variablelist>
100
 
        </listitem>
101
 
      </varlistentry>
102
 
      <varlistentry>
103
 
        <term>result</term>
104
 
        <listitem>
105
 
          <para>o valor da integral, ou vetor de valores da integral.</para>
106
 
        </listitem>
107
 
      </varlistentry>
108
 
      <varlistentry>
109
 
        <term>err</term>
110
 
        <listitem>
111
 
          <para>estimativas do erro absoluto</para>
112
 
        </listitem>
113
 
      </varlistentry>
114
 
    </variablelist>
115
 
  </refsection>
116
 
  <refsection>
117
 
    <title>Descri��o</title>
118
 
    <para>A fun��o calcula uma aproxima��o a um dado vetor de integrais
119
 
      definidas
120
 
    </para>
121
 
    <programlisting role="no-scilab-exec"><![CDATA[ 
 
3
    <refnamediv>
 
4
        <refname>int3d</refname>
 
5
        <refpurpose>integral definida 3d pelo m�todo da quadratura e
 
6
            cubatura
 
7
        </refpurpose>
 
8
    </refnamediv>
 
9
    <refsynopsisdiv>
 
10
        <title>Seq��ncia de Chamamento</title>
 
11
        <synopsis>[result,err]=int3d(X,Y,Z,f [,nf[,params]])</synopsis>
 
12
    </refsynopsisdiv>
 
13
    <refsection>
 
14
        <title>Par�metros</title>
 
15
        <variablelist>
 
16
            <varlistentry>
 
17
                <term>X</term>
 
18
                <listitem>
 
19
                    <para>
 
20
                        um array 4 por <literal>NUMTET</literal> contendo as abscissas
 
21
                        dos v�rtices dos <literal>NUMTET</literal> tetraedros.
 
22
                    </para>
 
23
                </listitem>
 
24
            </varlistentry>
 
25
            <varlistentry>
 
26
                <term>Y</term>
 
27
                <listitem>
 
28
                    <para>
 
29
                        um array 4 por <literal>NUMTET</literal> contendo as ordenadas
 
30
                        dos v�rtices dos <literal>NUMTET</literal> tetraedros.
 
31
                    </para>
 
32
                </listitem>
 
33
            </varlistentry>
 
34
            <varlistentry>
 
35
                <term>Z</term>
 
36
                <listitem>
 
37
                    <para>
 
38
                        um array 4 por <literal>NUMTET</literal> contendo as terceiras
 
39
                        coordenadas dos v�rtices dos <literal>NUMTET</literal>
 
40
                        tetraedros.
 
41
                    </para>
 
42
                </listitem>
 
43
            </varlistentry>
 
44
            <varlistentry>
 
45
                <term>f</term>
 
46
                <listitem>
 
47
                    <para>fun��o externa (function, string ou lista) definindo o
 
48
                        integrando <literal>f(xyz,nf)</literal>, onde <literal>xyz</literal>
 
49
                        � o vetor das coordenadas de um ponto e nf os n�meros das
 
50
                        fun��es
 
51
                    </para>
 
52
                </listitem>
 
53
            </varlistentry>
 
54
            <varlistentry>
 
55
                <term>nf</term>
 
56
                <listitem>
 
57
                    <para>o n�mero da fun��o a ser integrada (o padr�o � 1)</para>
 
58
                </listitem>
 
59
            </varlistentry>
 
60
            <varlistentry>
 
61
                <term>params</term>
 
62
                <listitem>
 
63
                    <para>
 
64
                        vetor de reais <literal>[minpts, maxpts, epsabs,
 
65
                            epsrel]
 
66
                        </literal>
 
67
                        .O valor padr�o � <literal>[0, 1000, 0.0,
 
68
                            1.d-5]
 
69
                        </literal>
 
70
                        .
 
71
                    </para>
 
72
                    <variablelist>
 
73
                        <varlistentry>
 
74
                            <term>epsabs</term>
 
75
                            <listitem>
 
76
                                <para>limite do erro absoluto desejado</para>
 
77
                            </listitem>
 
78
                        </varlistentry>
 
79
                        <varlistentry>
 
80
                            <term>epsrel</term>
 
81
                            <listitem>
 
82
                                <para>limite do erro relativo desejado</para>
 
83
                            </listitem>
 
84
                        </varlistentry>
 
85
                        <varlistentry>
 
86
                            <term>minpts</term>
 
87
                            <listitem>
 
88
                                <para>n�mero m�nimo de avalia��es da fun��o</para>
 
89
                            </listitem>
 
90
                        </varlistentry>
 
91
                        <varlistentry>
 
92
                            <term>maxpts</term>
 
93
                            <listitem>
 
94
                                <para>n�mero m�ximo de avalia��es da fun��o. O n�mero de
 
95
                                    avalia��es da fun��o sobre cada subregi�o � 43
 
96
                                </para>
 
97
                            </listitem>
 
98
                        </varlistentry>
 
99
                    </variablelist>
 
100
                </listitem>
 
101
            </varlistentry>
 
102
            <varlistentry>
 
103
                <term>result</term>
 
104
                <listitem>
 
105
                    <para>o valor da integral, ou vetor de valores da integral.</para>
 
106
                </listitem>
 
107
            </varlistentry>
 
108
            <varlistentry>
 
109
                <term>err</term>
 
110
                <listitem>
 
111
                    <para>estimativas do erro absoluto</para>
 
112
                </listitem>
 
113
            </varlistentry>
 
114
        </variablelist>
 
115
    </refsection>
 
116
    <refsection>
 
117
        <title>Descri��o</title>
 
118
        <para>A fun��o calcula uma aproxima��o a um dado vetor de integrais
 
119
            definidas
 
120
        </para>
 
121
        <programlisting role="no-scilab-exec"><![CDATA[ 
122
122
I  I  I (F ,F ,...,F )      dx(3)dx(2)dx(1),
123
123
          1  2      numfun
124
124
 ]]></programlisting>
125
 
    <para>onde a regi�o de integra��o s�o os NUMTET tetraedros e onde</para>
126
 
    <programlisting role="no-scilab-exec"><![CDATA[ 
 
125
        <para>onde a regi�o de integra��o s�o os NUMTET tetraedros e onde</para>
 
126
        <programlisting role="no-scilab-exec"><![CDATA[ 
127
127
F = F (X(1),X(2),X(3)), J = 1,2,...,NUMFUN.
128
128
 J   J
129
129
 ]]></programlisting>
130
 
    <para>uma estrat�gia globalmente adaptativa � aplicada para se computar
131
 
      aproxima��es <literal>result(k)</literal> esperando-se que satisfa�a, para
132
 
      cada componente de I, � seguinte precis�o:
133
 
      <literal>ABS(I(K)-RESULT(K))&lt;=MAX(EPSABS,EPSREL*ABS(I(K)))</literal>
134
 
    </para>
135
 
    <para>
136
 
      <literal>int3d</literal> repetidamente subdivide os tetraedros com
137
 
      maiores erros estimados e estima as integrais e os erros sobre os novos
138
 
      tetraedros at� que a exig�ncia de erro seja encontrada ou
139
 
      <literal>MAXPTS</literal> avalia��es da fun��o tenham sido feitas.
140
 
    </para>
141
 
    <para>Uma regra de 43 pontos de integra��o com todos os pontos de
142
 
      avalia��o dentro dos tetraedros � aplicada. A regra tem grau polinomial
143
 
      8.
144
 
    </para>
145
 
    <para>
146
 
      Se os valores dos par�metros de entrada <literal>EPSABS</literal> ou
147
 
      <literal>EPSREL</literal> s�o suficientemente grandes, uma regra de
148
 
      integra��o � aplicada sobre cada tetraedro e os valores s�o aproximados
149
 
      para se fornecer as aproxima��es <literal>RESULT(K)</literal>. Nenhuma
150
 
      subdivis�o posterior dos tetraedros ser� feita.
151
 
    </para>
152
 
    <para>
153
 
      Quando <literal>int3d</literal> computa estimativas a um vetor de
154
 
      integrais, � dado tratamento igual a todos os componentes do vetor. Isto
155
 
      �, <literal>I(Fj)</literal> e <literal>I(Fk)</literal> para<literal>
156
 
        j
157
 
      </literal>
158
 
      diferente de <literal>k</literal>, s�o estimados com a mesma
159
 
      subdivis�o da regi�o de integra��o. Para integrais suficientemente
160
 
      semelhantes, podemos economizar tempo aplicando <literal>int3d</literal> a
161
 
      todos os integrando em uma chamada. Para integrais que variam
162
 
      continuamente em fun��o de um par�metro, as estimativas produzidas por
163
 
      <literal>int3d</literal> tamb�m ir�o variar continuamente quando a
164
 
      subdivis�o � aplicada a todos os componentes. Este geralmente n�o ser� o
165
 
      caso quando componentes diferentes s�o tratados separadamente.
166
 
    </para>
167
 
    <para>Por outro lado, este recurso deve ser utilizado com cautela quando
168
 
      os componentes diferentes da integral requerem claramente subdivis�es
169
 
      diferentes.
170
 
    </para>
171
 
  </refsection>
172
 
  <refsection>
173
 
    <title>Refer�ncias</title>
174
 
    <para>Rotina FORTRAN dcutet.f</para>
175
 
  </refsection>
176
 
  <refsection>
177
 
    <title>Exemplos</title>
178
 
    <programlisting role="example"><![CDATA[ 
 
130
        <para>uma estrat�gia globalmente adaptativa � aplicada para se computar
 
131
            aproxima��es <literal>result(k)</literal> esperando-se que satisfa�a, para
 
132
            cada componente de I, � seguinte precis�o:
 
133
            <literal>ABS(I(K)-RESULT(K))&lt;=MAX(EPSABS,EPSREL*ABS(I(K)))</literal>
 
134
        </para>
 
135
        <para>
 
136
            <literal>int3d</literal> repetidamente subdivide os tetraedros com
 
137
            maiores erros estimados e estima as integrais e os erros sobre os novos
 
138
            tetraedros at� que a exig�ncia de erro seja encontrada ou
 
139
            <literal>MAXPTS</literal> avalia��es da fun��o tenham sido feitas.
 
140
        </para>
 
141
        <para>Uma regra de 43 pontos de integra��o com todos os pontos de
 
142
            avalia��o dentro dos tetraedros � aplicada. A regra tem grau polinomial
 
143
            8.
 
144
        </para>
 
145
        <para>
 
146
            Se os valores dos par�metros de entrada <literal>EPSABS</literal> ou
 
147
            <literal>EPSREL</literal> s�o suficientemente grandes, uma regra de
 
148
            integra��o � aplicada sobre cada tetraedro e os valores s�o aproximados
 
149
            para se fornecer as aproxima��es <literal>RESULT(K)</literal>. Nenhuma
 
150
            subdivis�o posterior dos tetraedros ser� feita.
 
151
        </para>
 
152
        <para>
 
153
            Quando <literal>int3d</literal> computa estimativas a um vetor de
 
154
            integrais, � dado tratamento igual a todos os componentes do vetor. Isto
 
155
            �, <literal>I(Fj)</literal> e <literal>I(Fk)</literal> para<literal>
 
156
                j
 
157
            </literal>
 
158
            diferente de <literal>k</literal>, s�o estimados com a mesma
 
159
            subdivis�o da regi�o de integra��o. Para integrais suficientemente
 
160
            semelhantes, podemos economizar tempo aplicando <literal>int3d</literal> a
 
161
            todos os integrando em uma chamada. Para integrais que variam
 
162
            continuamente em fun��o de um par�metro, as estimativas produzidas por
 
163
            <literal>int3d</literal> tamb�m ir�o variar continuamente quando a
 
164
            subdivis�o � aplicada a todos os componentes. Este geralmente n�o ser� o
 
165
            caso quando componentes diferentes s�o tratados separadamente.
 
166
        </para>
 
167
        <para>Por outro lado, este recurso deve ser utilizado com cautela quando
 
168
            os componentes diferentes da integral requerem claramente subdivis�es
 
169
            diferentes.
 
170
        </para>
 
171
    </refsection>
 
172
    <refsection>
 
173
        <title>Refer�ncias</title>
 
174
        <para>Rotina FORTRAN dcutet.f</para>
 
175
    </refsection>
 
176
    <refsection>
 
177
        <title>Exemplos</title>
 
178
        <programlisting role="example"><![CDATA[ 
179
179
X=[0;1;0;0];
180
180
Y=[0;0;1;0];
181
181
Z=[0;0;0;1];
205
205
function v=f(xyz,numfun),v=1,endfunction
206
206
[result,err]=int3d(X,Y,Z,f,1,[0,100000,1.d-5,1.d-7])
207
207
 ]]></programlisting>
208
 
  </refsection>
209
 
  <refsection role="see also">
210
 
    <title>Ver Tamb�m</title>
211
 
    <simplelist type="inline">
212
 
      <member>
213
 
        <link linkend="intc">intc</link>
214
 
      </member>
215
 
      <member>
216
 
        <link linkend="intl">intl</link>
217
 
      </member>
218
 
      <member>
219
 
        <link linkend="int2d">int2d</link>
220
 
      </member>
221
 
    </simplelist>
222
 
  </refsection>
 
208
    </refsection>
 
209
    <refsection role="see also">
 
210
        <title>Ver Tamb�m</title>
 
211
        <simplelist type="inline">
 
212
            <member>
 
213
                <link linkend="intc">intc</link>
 
214
            </member>
 
215
            <member>
 
216
                <link linkend="intl">intl</link>
 
217
            </member>
 
218
            <member>
 
219
                <link linkend="int2d">int2d</link>
 
220
            </member>
 
221
        </simplelist>
 
222
    </refsection>
223
223
</refentry>