scilab/modules/graphics/help/ru_RU/2d_plot/semilogy.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="semilogy">
  21     <refnamediv>
  22         <refname>semilogy</refname>
  23         <refpurpose>2D semilogarithmic plot</refpurpose>
  24     </refnamediv>
  25     <refsynopsisdiv>
  26         <title>Синтаксис</title>
  27         <synopsis>
  28             semilogy     // demo
  29             semilogy(y)
  30             semilogy(x, y)
  31             semilogy(x, fun)
  32             semilogy(x, list(fun, param))
  33             semilogy(.., LineSpec)
  34             semilogy(.., LineSpec, GlobalProperty)
  35             semilogy(x1, y1, LineSpec1, x2,y2,LineSpec2,...xN, yN, LineSpecN, GlobalProperty1,.. GlobalPropertyM)
  36             semilogy(x1,fun1,LineSpec1, x2,y2,LineSpec2,...xN,funN,LineSpecN, GlobalProperty1, ..GlobalPropertyM)
  37             semilogy(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>semilogy(x, gamma)</literal>.
  68                     </para>
  69                     <para>
  70                         Если функции для построения нужны некоторые параметры в качестве входных
  71                         аргументов, то функция и её параметры могут быть определены через список,
  72                         как например, <literal>semilogy(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>semilogy</literal> строит данные, используя логарифмическую шкалу по
 119             основанию 10 по оси y и нормальную (линейную) шкалу по оси x. Возможные синтаксисы и
 120             аргументы те же, что и у функции <link linkend="plot">plot</link> при условии, что
 121             значения ординаты в агрументе <term>y</term> будут строго положительными.
 122         </para>
 123         <para>
 124             Если текущие оси не пусты и ось y имеет нижнюю отрицательную границу
 125             диапазона, то масштаб графика останется линейным после построения.
 126         </para>
 127         <para>
 128             Введите команду <literal>semilogy</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=1../(s.^2+s+1);
 137             clf("reset")
 138
 139             semilogy(w,abs(g));
 140
 141             title("$\LARGE \left|1/(s^2+s+1)\right|\mbox{ for }s=i\omega$")
 142             xlabel("$\LARGE \omega$")
 143     ]]></programlisting>
 144         <scilab:image>
 145             w=logspace(-2,2,1000);
 146             s=%i*w;
 147             g=1../(s.^2+s+1);
 148             clf("reset")
 149
 150             semilogy(w,abs(g));
 151
 152             title("$\LARGE \left|1/(s^2+s+1)\right|\mbox{ for }s=i\omega$")
 153             xlabel("$\LARGE \omega$")
 154          </scilab:image>
 155     </refsection>
 156     <refsection role="see also">
 157         <title>Смотрите также</title>
 158         <simplelist type="inline">
 159             <member>
 160                 <link linkend="plot">plot</link>
 161             </member>
 162             <member>
 163                 <link linkend="semilogx">semilogx</link>
 164             </member>
 165             <member>
 166                 <link linkend="loglog">loglog</link>
 167             </member>
 168             <member>
 169                 <link linkend="LineSpec">LineSpec</link>
 170             </member>
 171             <member>
 172                 <link linkend="GlobalProperty">GlobalProperty</link>
 173             </member>
 174         </simplelist>
 175     </refsection>
 176     <refsection role="history">
 177         <title>История</title>
 178         <revhistory>
 179             <revision>
 180                 <revnumber>6.1.1</revnumber>
 181                 <revdescription>
 182                     Добавлена функция semilogy.
 183                 </revdescription>
 184             </revision>
 185         </revhistory>
 186     </refsection>
 187 </refentry>