Fix some typos.
[scilab.git] / scilab / modules / graphics / help / ru_RU / 2d_plot / contour2d.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="contour2d">
14     <refnamediv>
15         <refname>contour2d</refname>
16         <refpurpose>
17             кривые уровней поверхности на двумерном графике
18         </refpurpose>
19     </refnamediv>
20     <refsynopsisdiv>
21         <title>Последовательность вызова</title>
22         <synopsis>
23             contour2d(x, y, z, nz, [style, strf, leg, rect, nax])
24             contour2d(x, y, z, nz, &lt;opt_args&gt;)
25         </synopsis>
26     </refsynopsisdiv>
27     <refsection>
28         <title>Аргументы</title>
29         <variablelist>
30             <varlistentry>
31                 <term>x, y</term>
32                 <listitem>
33                     <para>
34                         два вещественных вектора-строки размером
35                         <literal>n1</literal> и <literal>n2</literal>: сетка.
36                     </para>
37                 </listitem>
38             </varlistentry>
39             <varlistentry>
40                 <term>z</term>
41                 <listitem>
42                     <para>
43                         вещественная матрица размером <literal>(n1,n2)</literal>,
44                         значение функции в сетке, либо Scilab-функция, которая
45                         определяет поверхность <literal>z=f(x,y)</literal>.
46                     </para>
47                 </listitem>
48             </varlistentry>
49             <varlistentry>
50                 <term>nz</term>
51                 <listitem>
52                     <para>
53                         значения уровней или число уровней.
54                     </para>
55                     <variablelist>
56                         <varlistentry>
57                             <term>
58                                 Если <literal>nz</literal> - целое число
59                             </term>
60                             <listitem>
61                                 <para>
62                                     его значение указывает количество кривых
63                                     уровня равномерно распределённых от <literal>zmin</literal>
64                                     до <literal>zmax</literal>, как показано
65                                     ниже:
66                                 </para>
67                                 <programlisting role="no-scilab-exec"><![CDATA[ 
68 z= zmin + (1:nz)*(zmax-zmin)/(nz+1) 
69  ]]></programlisting>
70                                 <para>
71                                     <note>
72                                     Заметьте, что уровни <literal>zmin</literal>
73                                     и <literal>zmax</literal> не рисуются
74                                     (вообще, они сводятся в точку), но их можно
75                                     добавить следующим образом:
76                                     </note>
77                                 </para>
78                                 <programlisting role="no-scilab-exec"><![CDATA[ 
79 [im,jm] = find(z == zmin); // или zmax
80 plot2d(x(im)',y(jm)',-9,"000")
81  ]]></programlisting>
82                             </listitem>
83                         </varlistentry>
84                         <varlistentry>
85                             <term>
86                                 Если <literal>nz</literal> - вектор
87                             </term>
88                             <listitem>
89                                 <para>
90                                     <literal>nz(i)</literal> указывает значение
91                                     <literal>i</literal>-той кривой уровня.
92                                 </para>
93                             </listitem>
94                         </varlistentry>
95                     </variablelist>
96                 </listitem>
97             </varlistentry>
98             <varlistentry>
99                 <term>&lt;opt_args&gt;</term>
100                 <listitem>
101                     <para>
102                         Это представляет последовательность инструкций
103                         <literal>key1=value1, key2=value2</literal>,... где
104                         <literal>key1</literal>, <literal>key2</literal>,...
105                         могут иметь одно из следующих значений:
106                         <literal>style</literal>, <literal>leg</literal>,
107                         <literal>rect</literal>, <literal>nax</literal>,
108                         <literal>strf</literal> или <literal>axesflag</literal>
109                         и <literal>frameflag</literal> (см. <link linkend="plot2d">plot2d</link>)
110                     </para>
111                 </listitem>
112             </varlistentry>
113             <varlistentry>
114                 <term>style, strf, leg, rect, nax</term>
115                 <listitem>
116                     <para>
117                         см. <link linkend="plot2d">plot2d</link>. Аргумент
118                         <literal>style</literal> указывает стили штриха или
119                         цвета, которые требуется использовать для кривых уровня.
120                         Он должен быть того же самого размера, что и количество
121                         уровней.
122                     </para>
123                 </listitem>
124             </varlistentry>
125         </variablelist>
126     </refsection>
127     <refsection>
128         <title>Описание</title>
129         <para>
130             <function>contour2d</function> рисует кривые уровней поверхности
131             <literal>z=f(x,y)</literal> на двумерном графике. Значения
132             <literal>f(x,y)</literal> указываются в матрице
133             <varname>z</varname> в точках сетки, определённой через
134             <varname>x</varname> и <varname>y</varname>.
135         </para>
136         <para>
137             Вы можете изменить формат чисел с плавающей запятой, печатаемых на
138             уровнях, с помощью <code>xset("fpf",string)</code>, где
139             <varname>string</varname> указывает формат в формате C-синтаксиса
140             (например, <code>string="%.3f"</code>). Используйте
141             <code>string=""</code> для переключения обратно в формат по
142             умолчанию и используйте <code>string=" "</code> для подавления
143             печати. Это последняя возможность очень полезна в сочетании с <link
144             linkend="legends">legends</link> для отображения номеров уровней в
145             легенде, а не прямо на кривых уровней, как обычно (см. раздел
146             "Примеры").
147         </para>
148         <para>
149             Необязательные аргументы <varname>style</varname>,
150             <varname>strf</varname>, <varname>leg</varname>,
151             <varname>rect</varname>, <varname>nax</varname> могут быть переданы
152             в виде последовательности инструкций <literal>key1=value1,
153             key2=value2</literal>,... где ключи <literal>key</literal> могут
154             быть <literal>style</literal>, <literal>strf</literal>,
155             <literal>leg</literal>, <literal>rect</literal>,
156             <literal>nax</literal>. В этом случае порядок не имеет особого значения.
157         </para>
158         <para>
159             Используйте функцию <function>contour</function> для рисования кривых уровней на трёхмерной поверхности.
160         </para>
161     </refsection>
162     <refsection>
163         <title>Примеры</title>
164         <programlisting role="example"><![CDATA[
165 contour2d(1:10,1:10,rand(10,10),5,rect=[0,0,11,11])
166 // Изменение формата печати уровней
167 xset("fpf","%.2f")
168  ]]></programlisting>
169         <scilab:image>
170             contour2d(1:10,1:10,rand(10,10),5,rect=[0,0,11,11]);
171             xset("fpf","%.2f")
172         </scilab:image>
173         <programlisting role="example"><![CDATA[
174 clf()
175 contour2d(1:10,1:10,rand(10,10),5,rect=[0,0,11,11])
176   ]]></programlisting>
177         <scilab:image>
178             contour2d(1:10,1:10,rand(10,10),5,rect=[0,0,11,11])
179         </scilab:image>
180         <programlisting role="example"><![CDATA[
181 // Пример с номерами уровней, печатаемых в легенде.
182 // Предупреждение: есть много уловок...
183 x = linspace(0,4*%pi,80);
184 z = cos(x')*cos(x);
185 clf(); f=gcf();
186 xset("fpf"," ")
187
188 // уловка 1: подразумевается, что номера уровней
189 //           не рисуются на кривых уровней
190 f.color_map=jetcolormap(7);
191
192 // уловка 2: чтобы иметь возможность поместить легенду справа без 
193 //          наложения на кривые уровней, используйте rect с достаточно
194 //          большим значением xmax
195 contour2d(x,x,z,-0.75:0.25:0.75,frameflag=3,rect=[0,0,5*%pi,4*%pi])
196
197 // уловка 3: используйте legends (заметьте, что наиболее практичная функция
198 //          легенды не будет работать, когда один из уровней формируется
199 //          двумя кривыми)
200 legends(string(-0.75:0.25:0.75),1:7,"lr");
201 xtitle("Некоторые уровни кривых функции cos(x)cos(y)")
202  ]]></programlisting>
203         <scilab:image>
204             x = linspace(0,4*%pi,80);
205             z = cos(x')*cos(x);
206             
207             clf(); f=gcf();
208             xset("fpf"," ")
209             
210             f.color_map=jetcolormap(7);
211             
212             contour2d(x,x,z,-0.75:0.25:0.75,frameflag=3,rect=[0,0,5*%pi,4*%pi])
213             
214             legends(string(-0.75:0.25:0.75),1:7,"lr");
215             xtitle("Некоторые уровни кривых функции cos(x)cos(y)")
216         </scilab:image>
217     </refsection>
218     <refsection role="see also">
219         <title>Смотрите также</title>
220         <simplelist type="inline">
221             <member>
222                 <link linkend="contour">contour</link>
223             </member>
224             <member>
225                 <link linkend="contour2di">contour2di</link>
226             </member>
227             <member>
228                 <link linkend="plot2d">plot2d</link>
229             </member>
230         </simplelist>
231     </refsection>
232 </refentry>