Translation of help page for contour2di function into Russian.
[scilab.git] / scilab / modules / graphics / help / ru_RU / 2d_plot / contour2di.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) ENPC - Jean-Philippe Chancelier
5  * 
6  * This file must be used under the terms of the CeCILL.
7  * This source file is licensed as described in the file COPYING, which
8  * you should have received as part of this distribution.  The terms
9  * are also available at    
10  * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
11  *
12  -->
13 <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="contour2di">
14     <refnamediv>
15         <refname>contour2di</refname>
16         <refpurpose>
17             вычисляет кривые уровней поверхности на двумерном графике
18         </refpurpose>
19     </refnamediv>
20     <refsynopsisdiv>
21         <title>Последовательность вызова</title>
22         <synopsis>[xc, yc] = contour2di(x, y, z, nz)</synopsis>
23     </refsynopsisdiv>
24     <refsection>
25         <title>Аргументы</title>
26         <variablelist>
27             <varlistentry>
28                 <term>x, y</term>
29                 <listitem>
30                     <para>
31                         два вещественных вектора размерами <literal>n1</literal> и <literal>n2</literal>: сетка.
32                     </para>
33                 </listitem>
34             </varlistentry>
35             <varlistentry>
36                 <term>z</term>
37                 <listitem>
38                     <para>
39                         вещественная матрица размером <literal>(n1,n2)</literal>,
40                         значения функции.
41                     </para>
42                 </listitem>
43             </varlistentry>
44             <varlistentry>
45                 <term>nz</term>
46                 <listitem>
47                     <para>
48                         значения уровней, либо число уровней.
49                     </para>
50                     <variablelist>
51                         <varlistentry>
52                             <term>
53                                 Если <literal>nz</literal> - целое число
54                             </term>
55                             <listitem>
56                                 <para>
57                                     его значение указывает количество кривых
58                                     уровня, равномерно распределённых от
59                                     <literal>zmin</literal> до <literal>zmax</literal>,
60                                     как показано ниже:
61                                 </para>
62                                 <programlisting role="no-scilab-exec"><![CDATA[ 
63 z= zmin + (1:nz)*(zmax-zmin)/(nz+1)
64  ]]></programlisting>
65                                 <para>
66                                     <note>
67                                     Заметьте, что уровни <literal>zmin</literal>
68                                     и <literal>zmax</literal> не рисуются (вообще, они сводятся в точку), но их можно
69                                     добавить следующим образом:
70                                     </note>
71                                 </para>
72                                 <programlisting role="no-scilab-exec"><![CDATA[ 
73 [im,jm] = find(z == zmin);     // или zmax
74 plot2d(x(im)',y(jm)',-9,"000")
75  ]]></programlisting>
76                             </listitem>
77                         </varlistentry>
78                         <varlistentry>
79                             <term>
80                                 Если <literal>nz</literal> - вектор
81                             </term>
82                             <listitem>
83                                 <para>
84                                     <literal>nz(i)</literal> указывает значение
85                                     <literal>i</literal>-той кривой уровня.
86                                 </para>
87                             </listitem>
88                         </varlistentry>
89                     </variablelist>
90                 </listitem>
91             </varlistentry>
92             <varlistentry>
93                 <term>xc, yc</term>
94                 <listitem>
95                     <para>
96                         векторы одинаковых размеров, содержащие определения
97                         контуров. Подробности указаны ниже.
98                     </para>
99                 </listitem>
100             </varlistentry>
101         </variablelist>
102     </refsection>
103     <refsection>
104         <title>Описание</title>
105         <para>
106             Функция <function>contour2di</function> вычисляет кривые уровней
107             поверхности <literal>z = f(x, y)</literal> на двумерном графике.
108             Значения <literal>f(x,y)</literal> задаются матрицей
109             <varname>z</varname> в точках сетки, определённой через
110             <varname>x</varname> и <varname>y</varname>.
111         </para>
112         <para>
113             <literal>xc(1)</literal> содержит уровень, связанный с траекторией
114             первого контура, <literal>yc(1)</literal> содержит количество
115             <literal>N1</literal> точек, определяющих траекторию этого контура,
116             а (<literal>xc(1+(1:N1))</literal>, <literal>yc(1+(1:N1))</literal>)
117             содержат координаты точек траекторий. Вторая траектория начинается в
118             <literal>xc(2+N1)</literal> и <literal>yc(2+N1)</literal> и так далее.
119         </para>
120     </refsection>
121     <refsection>
122         <title>Примеры</title>
123         <programlisting role="example"><![CDATA[ 
124 [xc,yc]=contour2di(1:10,1:10,rand(10,10),5);
125 k=1;n=yc(k);c=1;
126 while k+yc(k)<size(xc,'*')
127   n=yc(k);
128   plot2d(xc(k+(1:n)),yc(k+(1:n)),c)
129   c=c+1;
130   k=k+n+1;
131 end
132  ]]></programlisting>
133     </refsection>
134     <refsection role="see also">
135         <title>Смотрите также</title>
136         <simplelist type="inline">
137             <member>
138                 <link linkend="contour">contour</link>
139             </member>
140             <member>
141                 <link linkend="contour2d">contour2d</link>
142             </member>
143             <member>
144                 <link linkend="plot2d">plot2d</link>
145             </member>
146         </simplelist>
147     </refsection>
148 </refentry>