gschur() was declared obsolete in Scilab 4, now removed
[scilab.git] / scilab / modules / functions / help / pt_BR / built_in / external.xml
1 <?xml version="1.0" encoding="ISO-8859-1"?>
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:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="external" xml:lang="pt">
3     <refnamediv>
4         <refname>external</refname>
5         <refpurpose>objeto Scilab, função ou rotina externa</refpurpose>
6     </refnamediv>
7     <refsection role="description">
8         <title>Descrição</title>
9         <para>Função ou rotina externa para uso com comandos específicos.</para>
10         <para>Uma "external" é uma função ou rotina que é usada como argumento em
11             algumas primitivas de alto nível (tais como <literal>ode</literal>,
12             <literal>optim</literal>, <literal>schur</literal>...).
13         </para>
14         <para>A seqüência de chamamento da "external" (função ou rotina) é imposta
15             pela primitiva de alto nível que configura os argumentos da
16             external.
17         </para>
18         <para>Por exemplo, a função externa costfunc é um argumento da primitiva
19             optim . Sua seqüência de chamamento deve ser:
20             <literal>[f,g,ind]=costfunc(x,ind)</literal> e <literal>optim</literal> (a
21             primitiva de otimização de alto nível) é invocada como segue:
22         </para>
23         <programlisting role=""><![CDATA[
24 optim(costfunc,...)
25  ]]></programlisting>
26         <para>
27             Aqui <literal>costfunc</literal> (a função de custo a ser minimizada
28             pela primitiva <literal>optim</literal>) avalia <literal>f=f(x)</literal>
29             e <literal>g=</literal> gradiente de <literal>f</literal> em
30             <literal>x</literal> (<literal>ind</literal> é um inteiro. Seu uso é
31             esclarecido na ajuda de <literal>optim</literal>).
32         </para>
33         <para>Se a função externa necessita de outros valores, estas variáveis
34             podem ser definidas em seu ambiente. Elas também podem ser colocadas em
35             uma lista. Por exemplo, a função externa
36         </para>
37         <programlisting role=""><![CDATA[
38 [f,g,ind] = costfunc(x,ind,a,b,c)
39  ]]></programlisting>
40         <para>
41             é válida para <literal>optim</literal> se o external (função
42             externa) é <literal>list(costfunc,a,b,c)</literal> e a chamada a
43             <literal>optim</literal> é, então:
44         </para>
45         <programlisting role=""><![CDATA[
46 optim(list(costfunc,a1,b1,c1),....
47  ]]></programlisting>
48         <para>Um external também pode ser uma rotina FORTRAN ou C: isto é
49             conveniente para acelerar computações.
50         </para>
51         <para>TO nome da rotina é fornecido para a primitiva de alto nível como um
52             string. A seqüência de chamamento da rotina também é imposta.
53         </para>
54         <para>Rotinas FORTRAN ou C podem ser dinamicamente linkadas ("ligadas,
55             conectadas") (ver <literal>link</literal>)
56         </para>
57     </refsection>
58     <refsection role="see also">
59         <title>Ver Também</title>
60         <simplelist type="inline">
61             <member>
62                 <link linkend="ode">ode</link>
63             </member>
64             <member>
65                 <link linkend="optim">optim</link>
66             </member>
67             <member>
68                 <link linkend="impl">impl</link>
69             </member>
70             <member>
71                 <link linkend="dassl">dassl</link>
72             </member>
73             <member>
74                 <link linkend="intg">intg</link>
75             </member>
76             <member>
77                 <link linkend="schur">schur</link>
78             </member>
79         </simplelist>
80     </refsection>
81 </refentry>