[graphics] better logarithmic plots
[scilab.git] / scilab / modules / graphics / help / ru_RU / 2d_plot / semilogx.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="semilogx">
21     <refnamediv>
22         <refname>semilogx</refname>
23         <refpurpose>двумерный полулогарифмический график</refpurpose>
24     </refnamediv>
25     <refsynopsisdiv>
26         <title>Синтаксис</title>
27         <synopsis>
28             semilogx     // пример
29             semilogx(y)
30             semilogx(x, y)
31             semilogx(x, fun)
32             semilogx(x, list(fun, param))
33             semilogx(.., LineSpec)
34             semilogx(.., LineSpec, GlobalProperty)
35             semilogx(x1, y1, LineSpec1, x2,y2,LineSpec2,...xN, yN, LineSpecN, GlobalProperty1,.. GlobalPropertyM)
36             semilogx(x1,fun1,LineSpec1, x2,y2,LineSpec2,...xN,funN,LineSpecN, GlobalProperty1, ..GlobalPropertyM)
37             semilogx(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                     </para>
60                 </listitem>
61             </varlistentry>
62             <varlistentry>
63                 <term>fun, fun1, ..</term>
64                 <listitem>
65                     <para>
66                         указатель функции, как, например, <literal>semilogx(x, sin)</literal>.
67                     </para>
68                     <para>
69                         Если функции для построения нужны некоторые параметры в качестве входных
70                         аргументов, то функция и её параметры могут быть определены через список,
71                         как например, <literal>semilogx(x, list(delip, -0.4))</literal>.
72                     </para>
73                 </listitem>
74             </varlistentry>
75             <varlistentry>
76                 <term>LineSpec</term>
77                 <listitem>
78                     <para>
79                         Этот необязательный аргумент должен быть строковым, который будет
80                         использоваться в качестве сокращения способа построения линии. Мы можем
81                         иметь один аргумент <literal>LineSpec</literal> на <literal>y</literal>
82                         или <literal>{x,y}</literal> ранее введённые. Опции
83                         <literal>LineSpec</literal> работают с указателями
84                         <literal>LineStyle</literal>, <literal>Marker</literal> и
85                         <literal>Color</literal> (см. <link linkend="LineSpec">LineSpec</link>).
86                         Эти указатели определяют стиль линии, стиль маркера и цвет линий графика.
87                     </para>
88                 </listitem>
89             </varlistentry>
90             <varlistentry>
91                 <term>GlobalProperty</term>
92                 <listitem>
93                     <para>
94                         Этот необязательный аргумент представляет последовательность пар
95                         операторов <literal>{PropertyName,PropertyValue}</literal>, которая
96                         определяет глобальные свойства объектов, применяемые ко всем кривым,
97                         созданным этим графиком. Полный обозор доступных свойств смотрите в
98                         <link linkend="GlobalProperty">GlobalProperty</link>.
99                     </para>
100                 </listitem>
101             </varlistentry>
102             <varlistentry>
103                 <term>axes_handle</term>
104                 <listitem>
105                     <para>
106                         Этот необязательный аргумент заставляет график строиться внутри выбранных
107                         осей указанных с помощью <literal>axes_handle</literal>, а не в текущих
108                         осях (см. <link linkend="gca">gca</link>).
109                     </para>
110                 </listitem>
111             </varlistentry>
112         </variablelist>
113     </refsection>
114     <refsection>
115         <title>Описание</title>
116         <para>
117             <literal>semilogx</literal> строит данные, используя логарифмическую шкалу по
118             основанию 10 по оси x и нормальную (линейную) шкалу по оси y. Возможные синтаксисы и
119             аргументы те же, что и у функции <link linkend="plot">plot</link> при условии, что
120             значения абсциссы в агрументе <term>x</term> будут строго положительными.
121         </para>
122         <para>
123             Если текущие оси не пусты и ось x имеет нижнюю отрицательную границу
124             диапазона, то масштаб графика останется линейным после построения.
125         </para>
126         <para>
127             Введите команду <literal>semilogx</literal>, чтобы увидеть пример.
128         </para>
129     </refsection>
130     <refsection>
131         <title>Примеры</title>
132         <programlisting role="example"><![CDATA[
133             w=logspace(-2,2,1000);
134             s=%i*w;
135             g=1../(s.^2+s+1);
136             clf("reset")
137
138             semilogx(w,abs(g));
139
140             title("$\LARGE \left|1/(s^2+s+1)\right|\mbox{ for }s=i\omega$")
141             xlabel("$\LARGE \omega$")
142  ]]></programlisting>
143         <scilab:image>
144             w=logspace(-2,2,1000);
145             s=%i*w;
146             g=1../(s.^2+s+1);
147             clf("reset")
148
149             semilogx(w,abs(g));
150
151             title("$\LARGE \left|1/(s^2+s+1)\right|\mbox{ for }s=i\omega$")
152             xlabel("$\LARGE \omega$")
153         </scilab:image>
154     </refsection>
155     <refsection role="see also">
156         <title>Смотрите также</title>
157         <simplelist type="inline">
158             <member>
159                 <link linkend="plot">plot</link>
160             </member>
161             <member>
162                 <link linkend="semilogy">semilogy</link>
163             </member>
164             <member>
165                 <link linkend="loglog">loglog</link>
166             </member>
167             <member>
168                 <link linkend="LineSpec">LineSpec</link>
169             </member>
170             <member>
171                 <link linkend="GlobalProperty">GlobalProperty</link>
172             </member>
173         </simplelist>
174     </refsection>
175     <refsection role="history">
176         <title>История</title>
177         <revhistory>
178             <revision>
179                 <revnumber>6.1.1</revnumber>
180                 <revdescription>
181                     Добавлена функция semilogx.
182                 </revdescription>
183             </revision>
184         </revhistory>
185     </refsection>
186 </refentry>