3870759f5a5db6fb46be4547b1ec049f24799246
[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             show_window()
170         </scilab:image>
171         <programlisting role="example"><![CDATA[ 
172 // Пример №2: построение surf3 и добавление некоторых контурных линий
173 function z=surf3(x,y), z=x^3+y^2, endfunction
174 clf()
175 x = linspace(-1,1,60);
176 y = linspace(-1,1,60);
177 set(gcf(),"color_map",hotcolormap(128))
178 drawlater() ;
179 colorbar(-1,2)
180 Sfgrayplot(x,y,surf3,strf="041")
181 contour2d(x,y,surf3,[-0.1, 0.025, 0.4],style=[1 1 1],strf="000")
182 xtitle("f(x,y) = x^3+y^2")
183 drawnow() ;
184 show_window()
185  ]]></programlisting>
186         <scilab:image>
187             function z=surf3(x,y), z=x^3+y^2, endfunction
188             clf()
189             x = linspace(-1,1,60);
190             y = linspace(-1,1,60);
191             set(gcf(),"color_map",hotcolormap(128))
192             drawlater() ;
193             colorbar(-1,2)
194             Sfgrayplot(x,y,surf3,strf="041")
195             contour2d(x,y,surf3,[-0.1, 0.025, 0.4],style=[1 1 1],strf="000")
196             xtitle("f(x,y) = x^3+y^2")
197             drawnow() ;
198             show_window()
199         </scilab:image>
200         <programlisting role="example"><![CDATA[ 
201 // Пример №3: построение surf3 и использование необязательных аргументов
202 //            zminmax и colout для ограничения графика в -0.5 <= z <= 1
203 function z=surf3(x,y), z=x^3+y^2, endfunction
204 clf()
205 x = linspace(-1,1,60);
206 y = linspace(-1,1,60);
207 set(gcf(),"color_map",jetcolormap(128))
208 drawlater() ;
209 zminmax = [-0.5 1]; colors=[32 96];
210 colorbar(zminmax(1),zminmax(2),colors)
211 Sfgrayplot(x, y, surf3, strf="041", zminmax=zminmax, colout=[0 0], colminmax=colors)
212 contour2d(x,y,surf3,[-0.5, 1],style=[1 1 1],strf="000")
213 xtitle("f(x,y) = x^3+y^2, с удалёнными частями ниже z = -0.5 и выше z = 1")
214 drawnow() ;
215 show_window()
216  ]]></programlisting>
217         <scilab:image localized="true">
218             function z=surf3(x,y), z=x^3+y^2, endfunction
219             clf()
220             x = linspace(-1,1,60);
221             y = linspace(-1,1,60);
222             set(gcf(),"color_map",jetcolormap(128))
223             drawlater() ;
224             zminmax = [-0.5 1]; colors=[32 96];
225             colorbar(zminmax(1),zminmax(2),colors)
226             Sfgrayplot(x, y, surf3, strf="041", zminmax=zminmax, colout=[0 0], colminmax=colors)
227             contour2d(x,y,surf3,[-0.5, 1],style=[1 1 1],strf="000")
228             xtitle("f(x,y) = x^3+y^2, с удалёнными частями ниже z = -0.5 и выше z = 1")
229             drawnow() ;
230             show_window()
231         </scilab:image>
232     </refsection>
233     <refsection role="see also">
234         <title>Смотрите также</title>
235         <simplelist type="inline">
236             <member>
237                 <link linkend="fec">fec</link>
238             </member>
239             <member>
240                 <link linkend="fgrayplot">fgrayplot</link>
241             </member>
242             <member>
243                 <link linkend="grayplot">grayplot</link>
244             </member>
245             <member>
246                 <link linkend="Sgrayplot">Sgrayplot</link>
247             </member>
248         </simplelist>
249     </refsection>
250 </refentry>