gschur() was declared obsolete in Scilab 4, now removed
[scilab.git] / scilab / modules / functions / help / ru_RU / built_in / external.xml
1 <?xml version="1.0" encoding="UTF-8"?>
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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ru" xml:id="external">
3     <refnamediv>
4         <refname>external</refname>
5         <refpurpose>объект Scilab'а, внешняя функция или подпрограмма</refpurpose>
6     </refnamediv>
7     <refsection role="description">
8         <title>Описание</title>
9         <para>
10             Внешняя функция или подпрограмма для использования со специальными командами.
11         </para>
12         <para>
13             "external" -- это функция или подпрограмма, которая используется в качестве
14             аргумента некоторых примитивов высокого уровня (таких как <literal>ode</literal>,
15             <literal>optim</literal>, <literal>schur</literal>...).
16         </para>
17         <para>
18             Последовательность вызова внешней функции или подпрограммы предписывается
19             примитивом высокого уровня, который устанавливает аргументы данной внешней
20             функции или подпрограммы.
21         </para>
22         <para>
23             Например, внешняя функция <literal>costfunc</literal> является аргументом примитива
24             <literal>optim</literal> (примитив оптимизации высокого уровня). Её последовательность
25             вызова должна быть:
26             <literal>[f,g,ind]=costfunc(x,ind)</literal> и
27             <literal>optim</literal> вызывается следующим образом:
28         </para>
29         <programlisting role="no-scilab-exec"><![CDATA[
30 optim(costfunc,...)
31  ]]></programlisting>
32         <para>
33             Здесь <literal>costfunc</literal> (функция цены должна быть минимизирована примитивом
34             <literal>optim</literal>) вычисляет <literal>f=f(x)</literal> и <literal>g</literal> --
35             градиент <literal>f</literal> в <literal>x</literal> (<literal>ind</literal> -- целое
36             число. Его использование уточняется в справке по  <literal>optim</literal>).
37         </para>
38         <para>
39             Если необходимы другие значения для внешней функции, то эти переменные могут быть
40             определены в её окружении. Также они могут быть вложены в список. Например,
41             внешняя функция:
42         </para>
43         <programlisting role="no-scilab-exec"><![CDATA[
44 [f,g,ind] = costfunc(x,ind,a,b,c)
45  ]]></programlisting>
46         <para>
47             является корректной для <literal>optim</literal>, если внешняя функция является списком
48             <literal>list(costfunc,a,b,c)</literal> и тогда вызов <literal>optim</literal>:
49         </para>
50         <programlisting role="no-scilab-exec"><![CDATA[
51 optim(list(costfunc,a1,b1,c1),....
52  ]]></programlisting>
53         <para>
54             Внешняя подпрограмма может быть процедурой Fortran или C: это удобно для быстрых вычислений.
55         </para>
56         <para>
57             Имя подпрограммы указывается примитиву высокого уровня в виде символьной строки.
58             Последовательность подпрограммы также предписывается.
59         </para>
60         <para>
61             Внешние процедуры Fortran или C могут быть также динамически связаны (см.
62             <literal>link</literal>).
63         </para>
64     </refsection>
65     <refsection role="see also">
66         <title>Смотрите также</title>
67         <simplelist type="inline">
68             <member>
69                 <link linkend="ode">ode</link>
70             </member>
71             <member>
72                 <link linkend="optim">optim</link>
73             </member>
74             <member>
75                 <link linkend="impl">impl</link>
76             </member>
77             <member>
78                 <link linkend="dassl">dassl</link>
79             </member>
80             <member>
81                 <link linkend="intg">intg</link>
82             </member>
83             <member>
84                 <link linkend="schur">schur</link>
85             </member>
86         </simplelist>
87     </refsection>
88 </refentry>