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