<?xml version="1.0" encoding="UTF-8"?>
<!--
 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) INRIA
 * Copyright (C) 2012 - 2016 - Scilab Enterprises
 * Copyright (C) 2018 - Samuel GOUGEON
 *
 * This file is hereby licensed under the terms of the GNU GPL v2.0,
 * pursuant to article 5.3.4 of the CeCILL v.2.1.
 * This file was originally licensed under the terms of the CeCILL v2.1,
 * and continues to be available under such terms.
 * For more information, see the COPYING file which you should have received
 * along with this program.
 *
 -->
<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="ja" xml:id="evans">
    <refnamediv>
        <refname>evans</refname>
        <refpurpose>エバンス根軌跡</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
        <title>呼び出し手順</title>
        <synopsis>
            evans(H)
            evans(H, kmax)
        </synopsis>
    </refsynopsisdiv>
    <refsection>
        <title>引数</title>
        <variablelist>
            <varlistentry>
                <term>H</term>
                <listitem>
                    <para>
                        伝達関数または状態空間表現で指定した
                        SISO線形システム (参照: <link linkend="syslin">syslin</link>).
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>kmax</term>
                <listitem>
                    <para>実数 (プロットに用いるゲインの最大値)</para>
                </listitem>
            </varlistentry>
        </variablelist>
    </refsection>
    <refsection>
        <title>説明</title>
        <para>
            状態空間または伝達形式 H(s)のSISO線形システム
            (<link linkend="syslin">syslin</link>)のエバンス根軌跡を出力します.
            これは,複素平面における
            <literal>1+k*H(s)=1+k*N(s)/D(s)</literal>の根軌跡です.
            選択された点のゲイン<literal>k &lt;= kmax</literal>に関して,
            <literal>D(s)+k*N(s)</literal>の根の虚部が実部に対してプロットされます.
        </para>
        <para>
            根軌跡の指定した点におけるゲインを得るには,
            <link linkend="datatips">データティップ</link>マネージャを
            アクティブにし,根軌跡の任意の点をクリックします.
        </para>
    </refsection>
    <refsection>
        <title>例</title>
        <programlisting role="example"><![CDATA[
H = syslin('c',352*poly(-5,'s')/poly([0,0,2000,200,25,1],'s','c'));
clf();
evans(H,100);
sgrid()

// Post-tuning graphical elements
ch = gca().children;
curves = ch(2).children;
curves.thickness = 2;
asymptotes = ch(ch.type=="Segs");
asymptotes.segs_color = color("grey70");

// Completing Evans plot:
[Ki,s] = kpure(H) // Gains that give pure imaginary closed loop poles
plot([real(s) real(s)],[imag(s) -imag(s)],'*r')

[Kr,s] = krac2(H)
    ]]></programlisting>
        <para>
            <scilab:image localized="true"><![CDATA[
                H = syslin('c',352*poly(-5,'s')/poly([0,0,2000,200,25,1],'s','c'));
                clf();
                gcf().axes_size = [610 470];
                evans(H,100);
                sgrid()

                // Post-tuning graphical elements
                ch = gca().children;
                curves = ch(2).children;
                curves.thickness = 2;
                asymptotes = ch(ch.type=="Segs");
                asymptotes.segs_color = color("grey70");

                // Completing Evans plot:
                [Ki,s] = kpure(H) // Gains that give pure imaginary closed loop poles
                plot([real(s) real(s)],[imag(s) -imag(s)],'*r')

                [Kr,s] = krac2(H)
        ]]></scilab:image>
        </para>
    </refsection>
    <refsection role="see also">
        <title>参照</title>
        <simplelist type="inline">
            <member>
                <link linkend="sgrid">sgrid</link>
            </member>
            <member>
                <link linkend="zgrid">zgrid</link>
            </member>
            <member>
                <link linkend="syslin">syslin</link>
            </member>
            <member>
                <link linkend="kpure">kpure</link>
            </member>
            <member>
                <link linkend="krac2">krac2</link>
            </member>
            <member>
                <link linkend="datatips">datatips</link>
            </member>
        </simplelist>
    </refsection>
</refentry>
