<?xml version="1.0" encoding="UTF-8"?>
<!--
This file is part of the Scilab time frequency toolbox.
This file must be used under the terms of the  terms of the GNU General Public License 
as published by the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

Copyright (c) 1996 by CNRS (France).
-->


<refentry xml:id="plotsid" xml:lang="en"
          xmlns="http://docbook.org/ns/docbook"
          xmlns:xlink="http://www.w3.org/1999/xlink"
          xmlns:svg="http://www.w3.org/2000/svg"
          xmlns:scilab="http://www.scilab.org"
          xmlns:ns3="http://www.w3.org/1999/xhtml"
          xmlns:mml="http://www.w3.org/1998/Math/MathML"
          xmlns:db="http://docbook.org/ns/docbook">

  <refnamediv>
    <refname>plotsid</refname><refpurpose>Schematic interference diagram of FM signals.</refpurpose>
  </refnamediv>



  <refsynopsisdiv>
    <title>Calling Sequence</title>
    <synopsis>
      plotsid(T,IFLAWS)
      plotsid(T,IFLAWS,K)
    </synopsis>
  </refsynopsisdiv>

  <refsection>
    <title>Parameters</title>
    <variablelist>
      <varlistentry>
        <term>	T      :</term>
        <listitem>
          <para>a real vector of size M: the time instants,</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>	IFLAWS :</term>
        <listitem>
          <para> an M by P real matrix with values in [-0.5 0.5]: each
          column corresponds to the instantaneous frequency law of a
          signal.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>	K :</term>
        <listitem>
          <para>a real scalar with possible values -1, 0, 1/2, 2 or %inf: the distribution		(default : 2):</para>
          <itemizedlist>
            <listitem><para>K=2: Wigner-Ville</para></listitem>
            <listitem><para>K=1/2: D-Flandrin</para></listitem>
            <listitem><para>K=0: Bertrand (unitary)</para></listitem>
            <listitem><para>K=-1 Unterberger (active)</para></listitem>
            <listitem><para>K=%inf: Margenhau-Hill-Rihaczek</para></listitem>
          </itemizedlist>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsection>

  <refsection>
    <title>Description</title>
    <para>
      plotsid plots the schematic interference diagram of (analytic) FM signals.
    </para>
  </refsection>

  <refsection>
    <title>Examples</title>
    <programlisting role="example"><![CDATA[
    Nt=90; 
    [y,iflaw]=fmlin(Nt,0.05,0.25);
    [y2,iflaw2]=fmconst(50,0.4);
    iflaw(:,2)=[%nan*ones(10,1);iflaw2;%nan*ones(Nt-60,1)];
    plotsid(1:Nt,iflaw,0);
    ]]></programlisting>
    <scilab:image><![CDATA[
    Nt=90; 
    [y,iflaw]=fmlin(Nt,0.05,0.25);
    [y2,iflaw2]=fmconst(50,0.4);
    iflaw(:,2)=[%nan*ones(10,1);iflaw2;%nan*ones(Nt-60,1)];
    plotsid(1:Nt,iflaw,0);
    ]]></scilab:image>
  </refsection>

  <refsection>
    <title>See also</title>
    <simplelist type="inline">
      <member><link linkend="plotifl">plotifl</link></member>
      <member><link linkend="midpoint">midpoint</link></member>
    </simplelist>
  </refsection>

  <refsection>
    <title>Authors</title>
    <simplelist type="vert">
      <member>H. Nahrstaedt - Aug 2010</member>
      <member>	P. Flandrin, September 1995.</member>
    </simplelist>
  </refsection>
</refentry>
