<?xml version="1.0" encoding="ISO-8859-1"?>
<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" version="5.0-subset Scilab" xml:lang="en" xml:id="gph_plot">
  <info>
    <pubdate>17-May-2010</pubdate>
  </info>

  <refnamediv>
    <refname>gph_plot</refname>
    <refpurpose>Graph-matrix calculus (GPH), Subdifferential plot</refpurpose>
  </refnamediv>

   <refsynopsisdiv>
     <title>Calling Sequence</title>
     <synopsis>gph_plot(gph1, ..., gphN)</synopsis>
   </refsynopsisdiv>

   <refsection>
     <title>Parameters</title>
     <variablelist>

       <varlistentry>
         <term>gph1, ..., gphN</term>
         <listitem>
           <para>matrices.  Functions in GPH matrix form, whose subdifferentials will be plotted.</para>
         </listitem>
       </varlistentry>

     </variablelist>
   </refsection>

   <refsection>
     <title>Description</title>

     <para>
       Plots the subdifferential of each of the functions gph1, ...,
       gphN in turn, on the current graphics window.  Plots the
       piecewise linear interpolation of the points stored in the ith
       matrix with colour i, and puts a mark at each of the points
       with style -i (via plot2d).
     </para>
   </refsection>

   <refsection>
     <title>Examples</title>
     <programlisting role="example"><![CDATA[
gph1 = [-1,  0, 0, 1, 2; ..
        -1, -1, 0, 0, 2; ..
         1,  0, 0, 0, 1];
gph2 = [ 0.5, 0.5,   1; ..
          -1,   1,   1; ..
        %inf,   5, 5.5];

// Plot the subdifferentials.
scf();
gph_plot(gph1, gph2);

// Plot the functions.
scf();
plq_plot(plq_gph(gph1), plq_gph(gph2));
]]></programlisting>
   </refsection>

   <refsection>
     <title>See Also</title>
     <simplelist type="inline">
       <member><link linkend="gph_function">gph_function</link></member>
   </simplelist></refsection>

   <refsection>
     <title>Authors</title>
     <para>
       <literal>Bryan Gardiner</literal>, University of British Columbia, BC, Canada
     </para>
   </refsection>

</refentry>
