148270c6999bb7f5c7279c8c00bf852f3705253e
[scilab.git] / scilab / modules / graphics / help / ru_RU / 2d_plot / comet.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) Serge Steer
5  *
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *-->
15 <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="comet">
16     <refnamediv>
17         <refname>comet</refname>
18         <refpurpose>двумерный график с анимированной кометой</refpurpose>
19     </refnamediv>
20     <refsynopsisdiv>
21         <title>Синтаксис</title>
22         <synopsis>
23            comet(y)
24            comet(x, y)
25            comet(x, fun)
26            comet(x, y, p)
27            comet(x, fun, p)
28            comet(...,"colors",c)
29         </synopsis>
30     </refsynopsisdiv>
31     <refsection>
32         <title>Аргументы</title>
33         <variablelist>
34             <varlistentry>
35                 <term>x</term>
36                 <listitem>
37                     <para>
38                         вещественный вектор или матрица. Если не указать, то
39                         предполагается, что это вектор <literal>1:ny</literal>,
40                         где <literal>ny</literal> - это количество точек кривой
41                         (см. ниже).
42                     </para>
43                 </listitem>
44             </varlistentry>
45             <varlistentry>
46                 <term>y</term>
47                 <listitem>
48                     <para>
49                         вещественный вектор или матрица.
50                     </para>
51                 </listitem>
52             </varlistentry>
53             <varlistentry>
54                 <term>p</term>
55                 <listitem>
56                     <para>
57                         вещественный скаляр на интервале <literal>[0 1[</literal>.
58                         Значение по умолчанию <literal>0.1</literal>.
59                     </para>
60                 </listitem>
61             </varlistentry>
62             <varlistentry>
63                 <term>fun</term>
64                 <listitem>
65                     <para>
66                         Scilab-функция с последовательностью вызова
67                         <literal>y=fun(x)</literal>.  <varname>fun</varname>
68                         также может быть полиномом или рациональной дробью.
69                     </para>
70                 </listitem>
71             </varlistentry>
72             <varlistentry>
73                 <term>c</term>
74                 <listitem>
75                     <para>
76                         вектор из <literal>ny</literal> индексов цветов.
77                     </para>
78                 </listitem>
79             </varlistentry>
80         </variablelist>
81     </refsection>
82     <refsection>
83         <title>Описание</title>
84         <para>
85             Если <literal>(x,y)</literal> являются двумя векторами с
86             одинаковым количеством элементов, то эта фукнция нарисует
87             двумерный график с анимированной кометой, показывающей
88             движение кривой <literal>(x(1:k),y(1:k))</literal> для
89             <literal>k</literal>, меняющейся от <literal>1</literal> до
90             <literal>size(x,'*')</literal>.
91         </para>
92         <para>
93             График строится из трёх частей:
94             <variablelist>
95                 <varlistentry>
96                     <term>голова</term>
97                     <listitem>
98                         <para>
99                             метка, которая показыает текущее положение
100                             <literal>(x(i),y(i))</literal>.
101                         </para>
102                     </listitem>
103                 </varlistentry>
104                 <varlistentry>
105                     <term>тело</term>
106                     <listitem>
107                         <para>
108                             показывает бегущую кривую,
109                             следующую за головой:
110                             <literal>(x(i-k:i),y(i-k:i))</literal>
111                             часть кривой.
112                         </para>
113                     </listitem>
114                 </varlistentry>
115                 <varlistentry>
116                     <term>хвост</term>
117                     <listitem>
118                         <para>
119                             показывает часть кривой <literal>(x(1:i-k),y(1:i-k))</literal>.
120                         </para>
121                     </listitem>
122                 </varlistentry>
123             </variablelist>
124             <para>
125                 Инструкция <literal>comet(x, fun,...)</literal>
126                 эквивалентна инструкции <literal>comet(x, feval(x,fun),...)</literal>.
127             </para>
128             <para>
129                 <literal>comet(...,p)</literal> может быть использована для установки
130                 относительной длины тела. <literal>k</literal> определяется как
131                 <code>k = round(p*ny)</code>.
132             </para>
133             <para>
134                 Если <varname>y</varname> является матрицей, то для каждой пары
135                 <literal>(x,y(:,l))</literal> строятся анимированные кривые. В
136                 этом случае <literal>ny</literal> - это количество строк матрицы
137                 <varname>y</varname>.
138             </para>
139             <para>
140                 Если <varname>x</varname> и <varname>y</varname> - матрицы
141                 одинаковых размеров, то анимированные кривые строятся для каждой пары
142                 <literal>(x(:,l),y(:,l))</literal>. В этом случае <literal>ny</literal>
143                 - это количество строк матриц <varname>x</varname> и <varname>y</varname>.
144             </para>
145             <para>
146                 <literal>comet(...,"colors",c)</literal> может быть использована для
147                 установки цвета для каждой из кривых.
148             </para>
149         </para>
150     </refsection>
151     <refsection>
152         <title>Примеры</title>
153         <programlisting role="example"><![CDATA[
154 t = linspace(0,10*%pi,500);
155 isoview("on");  // установка равновеликого масштаба осей
156 comet(t.*sin(t),t.*cos(t))
157     ]]></programlisting>
158         <programlisting role="example"><![CDATA[
159 t = linspace(0,10*%pi,500)';
160 clf();comet(t.*sin(t),[t.*sin(2*t) t.*sin(3*t)])
161     ]]></programlisting>
162         <programlisting role="example"><![CDATA[
163 t = linspace(0,10*%pi,500)';
164 clf();comet(t.*sin(t),[t.*sin(2*t) t.*sin(3*t)],"colors",[3 5])
165     ]]></programlisting>
166         <programlisting role="example"><![CDATA[
167 function y=traj(x),y=1.5*sin(x^2),endfunction
168 clf();comet(linspace(0,5,500),traj)
169     ]]></programlisting>
170         <programlisting role="example"><![CDATA[
171 clf();comet(linspace(-2,4,500),(%s-3)/(%s^3+2*%s^2+1))
172     ]]></programlisting>
173     </refsection>
174     <refsection role="see also">
175         <title>Смотрите также</title>
176         <simplelist type="inline">
177             <member>
178                 <link linkend="color">color</link>
179             </member>
180             <member>
181                 <link linkend="comet3d">comet3d</link>
182             </member>
183             <member>
184                 <link linkend="paramfplot2d">paramfplot2d</link>
185             </member>
186         </simplelist>
187     </refsection>
188     <refsection>
189         <title>История</title>
190         <revhistory>
191             <revision>
192                 <revnumber>5.3.2</revnumber>
193                 <revremark>
194                     Введена функция <function>comet</function>.
195                 </revremark>
196             </revision>
197         </revhistory>
198     </refsection>
199 </refentry>