[graphics] better logarithmic plots
[scilab.git] / scilab / modules / graphics / help / ru_RU / 2d_plot / loglog.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) INRIA - Fabrice Leray
5  * Copyright (C) 2012 - 2016 - Scilab Enterprises
6  * Copyright (C) 2018 - 2019 - Samuel GOUGEON
7  * Copyright (C) 2020 - Stéphane MOTTELET
8  *
9  * This file is hereby licensed under the terms of the GNU GPL v2.0,
10  * pursuant to article 5.3.4 of the CeCILL v.2.1.
11  * This file was originally licensed under the terms of the CeCILL v2.1,
12  * and continues to be available under such terms.
13  * For more information, see the COPYING file which you should have received
14  * along with this program.
15  *
16  -->
17 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
18           xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
19           xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
20           xml:lang="ru" xml:id="loglog">
21     <refnamediv>
22         <refname>loglog</refname>
23         <refpurpose>двумерный график в логарифмическом масштабе</refpurpose>
24     </refnamediv>
25     <refsynopsisdiv>
26         <title>Синтаксис</title>
27         <synopsis>
28             loglog     // пример
29             loglog(y)
30             loglog(x, y)
31             loglog(x, fun)
32             loglog(x, list(fun, param))
33             loglog(.., LineSpec)
34             loglog(.., LineSpec, GlobalProperty)
35             loglog(x1, y1, LineSpec1, x2,y2,LineSpec2,...xN, yN, LineSpecN, GlobalProperty1,.. GlobalPropertyM)
36             loglog(x1,fun1,LineSpec1, x2,y2,LineSpec2,...xN,funN,LineSpecN, GlobalProperty1, ..GlobalPropertyM)
37             loglog(axes_handle,...)
38         </synopsis>
39     </refsynopsisdiv>
40     <refsection>
41         <title>Аргументы</title>
42         <variablelist>
43             <varlistentry>
44                 <term>x</term>
45                 <listitem>
46                     <para>
47                         вектор или матрица строго положительных вещественных чисел или целых
48                         чисел. Если не указано, то предполагается, что это вектор
49                         <literal>1:n</literal>, где <literal>n</literal> - это число точек
50                         кривой, указанных в параметре <literal>y</literal>.
51                     </para>
52                 </listitem>
53             </varlistentry>
54             <varlistentry>
55                 <term>y</term>
56                 <listitem>
57                     <para>
58                         вектор или матрица строго положительных вещественных чисел или целых
59                         чисел.
60                     </para>
61                 </listitem>
62             </varlistentry>
63             <varlistentry>
64                 <term>fun, fun1, ..</term>
65                 <listitem>
66                     <para>
67                         указатель функции, как, например, <literal>loglog(x, gamma)</literal>.
68                     </para>
69                     <para>
70                         Если функции для построения нужны некоторые параметры в качестве входных
71                         аргументов, то функция и её параметры могут быть определены через список,
72                         как например, <literal>loglog(x, list(delip, -0.4))</literal>.
73                     </para>
74                 </listitem>
75             </varlistentry>
76             <varlistentry>
77                 <term>LineSpec</term>
78                 <listitem>
79                     <para>
80                         Этот необязательный аргумент должен быть строковым, который будет
81                         использоваться в качестве сокращения способа построения линии. Мы можем
82                         иметь один аргумент <literal>LineSpec</literal> на <literal>y</literal>
83                         или <literal>{x,y}</literal> ранее введённые. Опции
84                         <literal>LineSpec</literal> работают с указателями
85                         <literal>LineStyle</literal>, <literal>Marker</literal> и
86                         <literal>Color</literal> (см. <link linkend="LineSpec">LineSpec</link>).
87                         Эти указатели определяют стиль линии, стиль маркера и цвет линий графика.
88                     </para>
89                 </listitem>
90             </varlistentry>
91             <varlistentry>
92                 <term>GlobalProperty</term>
93                 <listitem>
94                     <para>
95                         Этот необязательный аргумент представляет последовательность пар
96                         операторов <literal>{PropertyName,PropertyValue}</literal>, которая
97                         определяет глобальные свойства объектов, применяемые ко всем кривым,
98                         созданным этим графиком. Полный обозор доступных свойств смотрите в
99                         <link linkend="GlobalProperty">GlobalProperty</link>.
100                     </para>
101                 </listitem>
102             </varlistentry>
103             <varlistentry>
104                 <term>axes_handle</term>
105                 <listitem>
106                     <para>
107                         Этот необязательный аргумент заставляет график строиться внутри выбранных
108                         осей указанных с помощью <literal>axes_handle</literal>, а не в текущих
109                         осях (см. <link linkend="gca">gca</link>).
110                     </para>
111                 </listitem>
112             </varlistentry>
113         </variablelist>
114     </refsection>
115     <refsection>
116         <title>Описание</title>
117         <para>
118             <literal>loglog</literal> строит данные, используя логарифмическую шкалу по основанию
119             10 как по оси x, так и по оси y. Возможные синтаксисы и аргументы те же, что и у
120             функции <link linkend="plot">plot</link> при условии, что значения в агрументах
121             <term>x</term> и <term>y</term> будут строго положительными.
122         </para>
123         <para>
124             Если текущие оси не пусты и ось x или ось y имеют нижнюю отрицательную границу
125             диапазона, то масштаб графика останется линейным после построения.
126         </para>
127         <para>
128             Введите команду <literal>loglog</literal>, чтобы увидеть пример.
129         </para>
130     </refsection>
131     <refsection>
132         <title>Примеры</title>
133         <programlisting role="example"><![CDATA[
134             w=logspace(-2,2,1000);
135             s=%i*w;
136             g=[];
137             for alpha=logspace(-2,1,4);
138               g=[g;(1)./(s.^2+alpha*s+1)];
139             end
140             clf("reset")
141
142             loglog(w,abs(g));
143
144             legend(leg)
145             title("$\LARGE \left|s^2/(s^2+\alpha s+1)\right|\mbox{ for }s=i\omega$")
146             xlabel("$\LARGE \omega$") ]]></programlisting>
147         <scilab:image>
148             w=logspace(-2,2,1000);
149             s=%i*w;
150             g=[];
151             for alpha=logspace(-2,1,4);
152               g=[g;(1)./(s.^2+alpha*s+1)];
153             end
154             clf("reset")
155
156             loglog(w,abs(g));
157
158             title("$\LARGE \left|s^2/(s^2+\alpha s+1)\right|\mbox{ for }s=i\omega$")
159             xlabel("$\LARGE \omega$")        </scilab:image>
160     </refsection>
161     <refsection role="see also">
162         <title>Смотрите также</title>
163         <simplelist type="inline">
164             <member>
165                 <link linkend="plot">plot</link>
166             </member>
167             <member>
168                 <link linkend="semilogx">semilogx</link>
169             </member>
170             <member>
171                 <link linkend="semilogy">semilogy</link>
172             </member>
173             <member>
174                 <link linkend="LineSpec">LineSpec</link>
175             </member>
176             <member>
177                 <link linkend="GlobalProperty">GlobalProperty</link>
178             </member>
179         </simplelist>
180     </refsection>
181     <refsection role="history">
182         <title>История</title>
183         <revhistory>
184             <revision>
185                 <revnumber>6.1.1</revnumber>
186                 <revdescription>
187                     Добавлена функция loglog.
188                 </revdescription>
189             </revision>
190         </revhistory>
191     </refsection>
192 </refentry>