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" version="5.0-subset Scilab" xml:id="external" xml:lang="en">
4
<refname>external</refname>
5
<refpurpose>objeto Scilab, fun��o ou rotina externa</refpurpose>
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>...).
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
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:
23
<programlisting role=""><![CDATA[
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>).
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
37
<programlisting role=""><![CDATA[
38
[f,g,ind]=costfunc(x,ind,a,b,c)
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:
45
<programlisting role=""><![CDATA[
46
optim(list(costfunc,a1,b1,c1),....
48
<para>Um external tamb�m pode ser uma rotina FORTRAN ou C: isto �
49
conveniente para acelerar computa��es.
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.
54
<para>Rotinas FORTRAN ou C podem ser dinamicamente linkadas ("ligadas,
55
conectadas") (ver <literal>link</literal>)
58
<refsection role="see also">
59
<title>Ver Tamb�m</title>
60
<simplelist type="inline">
62
<link linkend="ode">ode</link>
65
<link linkend="optim">optim</link>
68
<link linkend="impl">impl</link>
71
<link linkend="dassl">dassl</link>
74
<link linkend="intg">intg</link>
77
<link linkend="schur">schur</link>
80
<link linkend="gschur">gschur</link>