Fix the documentation. If the examples are the same, they should have the same syntax...
[scilab.git] / scilab / modules / graphics / help / ru_RU / 2d_plot / Sfgrayplot.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="Sfgrayplot">
14     <refnamediv>
15         <refname>Sfgrayplot</refname>
16         <refpurpose>
17             сглаженный двумерный график поверхности, определённой через функцию, с использованием цветов
18         </refpurpose>
19     </refnamediv>
20     <refsynopsisdiv>
21         <title>Последовательность вызова</title>
22         <synopsis>
23             Sfgrayplot(x, y, f, &lt;opt_args&gt;)
24             Sfgrayplot(x, y, f [,strf, rect, nax, zminmax, colminmax, mesh, colout])
25         </synopsis>
26     </refsynopsisdiv>
27     <refsection>
28         <title>Аргументы</title>
29         <variablelist>
30             <varlistentry>
31                 <term>x, y</term>
32                 <listitem>
33                     <para>
34                         вещественные векторы-строки размером <literal>n1</literal> и <literal>n2</literal>.
35                     </para>
36                 </listitem>
37             </varlistentry>
38             <varlistentry>
39                 <term>f</term>
40                 <listitem>
41                     <para>
42                         Scilab-функция (<literal>z=f(x,y)</literal>).
43                     </para>
44                 </listitem>
45             </varlistentry>
46             <varlistentry>
47                 <term>&lt;opt_args&gt;</term>
48                 <listitem>
49                     <para>
50                         представляет последовательность инструкций
51                         <literal>key1=value1, key2=value2, ...</literal>,
52                         где <literal>key1</literal>, <literal>key2, ...</literal>
53                         может быть одним из следующих: <varname>strf</varname>,
54                          <varname>rect</varname>, <varname>nax</varname>,
55                          <varname>zminmax</varname>, <varname>colminmax</varname>,
56                          <varname>mesh</varname>, <varname>colout</varname>
57                         (о первых трёх см. <link linkend="plot2d">plot2d</link>, а
58                         о последних четырёх см. <link linkend="fec">fec</link>).
59                     </para>
60                 </listitem>
61             </varlistentry>
62             <varlistentry>
63                 <term>strf, rect, nax</term>
64                 <listitem>
65                     <para>
66                         см. <link linkend="plot2d">plot2d</link>.
67                     </para>
68                 </listitem>
69             </varlistentry>
70             <varlistentry>
71                 <term>zminmax, colminmax, mesh, colout</term>
72                 <listitem>
73                     <para>
74                         см. <link linkend="fec">fec</link>.
75                     </para>
76                 </listitem>
77             </varlistentry>
78         </variablelist>
79     </refsection>
80     <refsection>
81         <title>Описание</title>
82         <para>
83             Функция <function>Sfgrayplot</function> - это то же самое, что и 
84             <function>fgrayplot</function>, но график сглажен. Для сглаживания
85             используется функция <function>fec</function>. Поверхность строится
86             в предположении, что она линейна на множестве треугольников, 
87             построенных из сетки (здесь с <literal>n1=5</literal>, <literal>n2=3</literal>):
88         </para>
89         <screen><![CDATA[ 
90 _____________
91 | /| /| /| /|
92 |/_|/_|/_|/_| 
93 | /| /| /| /| 
94 |/_|/_|/_|/_|
95  ]]></screen>
96         <para>
97             Чтобы увидеть цветовую шкалу, может быть использована функция
98             <link linkend="colorbar">colorbar</link> (но вы должны знать
99             (или вычислить) минимальное и максимальное значения).
100         </para>
101         <para>
102             Вместо функции <function>Sfgrayplot</function>, вы можете
103             использовать функцию <link linkend="Sgrayplot">Sgrayplot</link>,
104             и это может быть несколько быстрее.
105         </para>
106         <para>
107             Введите команду <code>Sfgrayplot()</code>, чтобы посмотреть наглядную иллюстрацию.
108         </para>
109     </refsection>
110     <refsection>
111         <title>Примеры</title>
112         <programlisting role="example"><![CDATA[ 
113 // Пример №1: построение 4 поверхностей
114 function z=surf1(x,y), z=x*y, endfunction
115 function z=surf2(x,y), z=x^2-y^2, endfunction
116 function z=surf3(x,y), z=x^3+y^2, endfunction
117 function z=surf4(x,y), z=x^2+y^2, endfunction
118 clf()
119 set(gcf(),"color_map",[jetcolormap(64);hotcolormap(64)])
120 x = linspace(-1,1,60);
121 y = linspace(-1,1,60);
122 drawlater() ;
123 subplot(2,2,1)
124   colorbar(-1,1,[1,64])
125   Sfgrayplot(x,y,surf1,strf="041",colminmax=[1,64])
126   xtitle("f(x,y) = x*y")
127 subplot(2,2,2)
128   colorbar(-1,1,[65,128])
129   Sfgrayplot(x,y,surf2,strf="041",colminmax=[65,128])
130   xtitle("f(x,y) = x^2-y^2")
131 subplot(2,2,3)
132   colorbar(-1,2,[65,128])
133   Sfgrayplot(x,y,surf3,strf="041",colminmax=[65,128])
134   xtitle("f(x,y) = x^3+y^2")
135 subplot(2,2,4)
136   colorbar(0,2,[1,64])
137   Sfgrayplot(x,y,surf4,strf="041",colminmax=[1,64])
138   xtitle("f(x,y) = x^2+y^2")
139 drawnow() ;
140 show_window()
141  ]]></programlisting>
142         <scilab:image>
143             function z=surf1(x,y), z=x*y, endfunction
144             function z=surf2(x,y), z=x^2-y^2, endfunction
145             function z=surf3(x,y), z=x^3+y^2, endfunction
146             function z=surf4(x,y), z=x^2+y^2, endfunction
147             clf()
148             set(gcf(),"color_map",[jetcolormap(64);hotcolormap(64)])
149             x = linspace(-1,1,60);
150             y = linspace(-1,1,60);
151             drawlater();
152             subplot(2,2,1)
153             colorbar(-1,1,[1,64])
154             Sfgrayplot(x,y,surf1,strf="041",colminmax=[1,64])
155             xtitle("f(x,y) = x*y")
156             subplot(2,2,2)
157             colorbar(-1,1,[65,128])
158             Sfgrayplot(x,y,surf2,strf="041",colminmax=[65,128])
159             xtitle("f(x,y) = x^2-y^2")
160             subplot(2,2,3)
161             colorbar(-1,2,[65,128])
162             Sfgrayplot(x,y,surf3,strf="041",colminmax=[65,128])
163             xtitle("f(x,y) = x^3+y^2")
164             subplot(2,2,4)
165             colorbar(0,2,[1,64])
166             Sfgrayplot(x,y,surf4,strf="041",colminmax=[1,64])
167             xtitle("f(x,y) = x^2+y^2")
168             drawnow();
169         </scilab:image>
170         <programlisting role="example"><![CDATA[ 
171 // Пример №2: построение surf3 и добавление некоторых контурных линий
172 function z=surf3(x,y), z=x^3+y^2, endfunction
173 clf()
174 x = linspace(-1,1,60);
175 y = linspace(-1,1,60);
176 set(gcf(),"color_map",hotcolormap(128))
177 drawlater() ;
178 colorbar(-1,2)
179 Sfgrayplot(x,y,surf3,strf="041")
180 contour2d(x,y,surf3,[-0.1, 0.025, 0.4],style=[1 1 1],strf="000")
181 xtitle("f(x,y) = x^3+y^2")
182 drawnow() ;
183 show_window()
184  ]]></programlisting>
185         <scilab:image>
186             function z=surf3(x,y), z=x^3+y^2, endfunction
187             clf()
188             x = linspace(-1,1,60);
189             y = linspace(-1,1,60);
190             set(gcf(),"color_map",hotcolormap(128))
191             drawlater();
192             colorbar(-1,2)
193             Sfgrayplot(x,y,surf3,strf="041")
194             contour2d(x,y,surf3,[-0.1, 0.025, 0.4],style=[1 1 1],strf="000")
195             xtitle("f(x,y) = x^3+y^2")
196             drawnow() ;
197             show_window()
198         </scilab:image>
199         <programlisting role="example"><![CDATA[ 
200 // Пример №3: построение surf3 и использование необязательных аргументов
201 //            zminmax и colout для ограничения графика в -0.5 <= z <= 1
202 function z=surf3(x,y), z=x^3+y^2, endfunction
203 clf()
204 x = linspace(-1,1,60);
205 y = linspace(-1,1,60);
206 set(gcf(),"color_map",jetcolormap(128))
207 drawlater() ;
208 zminmax = [-0.5 1]; colors=[32 96];
209 colorbar(zminmax(1),zminmax(2),colors)
210 Sfgrayplot(x, y, surf3, strf="041", zminmax=zminmax, colout=[0 0], colminmax=colors)
211 contour2d(x,y,surf3,[-0.5, 1],style=[1 1 1],strf="000")
212 xtitle("f(x,y) = x^3+y^2, с удалёнными частями ниже z = -0.5 и выше z = 1")
213 drawnow() ;
214 show_window()
215  ]]></programlisting>
216         <scilab:image localized="true">
217             function z=surf3(x,y), z=x^3+y^2, endfunction
218             clf()
219             x = linspace(-1,1,60);
220             y = linspace(-1,1,60);
221             set(gcf(),"color_map",jetcolormap(128))
222             drawlater() ;
223             zminmax = [-0.5 1]; colors=[32 96];
224             colorbar(zminmax(1),zminmax(2),colors)
225             Sfgrayplot(x, y, surf3, strf="041", zminmax=zminmax, colout=[0 0], colminmax=colors)
226             contour2d(x,y,surf3,[-0.5, 1],style=[1 1 1],strf="000")
227             xtitle("f(x,y) = x^3+y^2, с удалёнными частями ниже z = -0.5 и выше z = 1")
228             drawnow() ;
229             show_window()
230         </scilab:image>
231     </refsection>
232     <refsection role="see also">
233         <title>Смотрите также</title>
234         <simplelist type="inline">
235             <member>
236                 <link linkend="fec">fec</link>
237             </member>
238             <member>
239                 <link linkend="fgrayplot">fgrayplot</link>
240             </member>
241             <member>
242                 <link linkend="grayplot">grayplot</link>
243             </member>
244             <member>
245                 <link linkend="Sgrayplot">Sgrayplot</link>
246             </member>
247         </simplelist>
248     </refsection>
249 </refentry>