<?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_plq"><info><pubdate>12-Oct-2009</pubdate></info><refnamediv><refname>gph_plq</refname><refpurpose>Convert a standard PLQ model to a Graph-Matrix Calculus (GPH) model.</refpurpose></refnamediv>

  <refsynopsisdiv>
    <title>Calling Sequence</title>
    <synopsis>gph = gph_plq(plq)</synopsis>
  </refsynopsisdiv>

  <refsection>
    <title>Parameters</title>

    <variablelist>
      <varlistentry>
        <term>plq</term>
        <listitem>
          <para>matrix.  A PLQ function.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsection>

  <refsection>
    <title>Description</title>

    <para>
      Converts a PLQ function into a matrix representing its subdifferential by storing points on the subdifferential's graph, as well as the values of the original function, in order to be able to integrate.
    </para>

    <para>
      This function runs in linear time with respect to the number of pieces in the PLQ function.
    </para>

  </refsection>


  <refsection><title>Examples</title><programlisting role="example"><![CDATA[
// The absolute-value function.
plq = [0,0,-1,0; %inf,0,1,0];
gph = gph_plq(plq),
// gph  =
// 
//  - 1.    0.    0.    1.  
//  - 1.  - 1.    1.    1.  
//    1.    0.    0.    1.  

// A "\_/" function.
plq = [0,0,-1,0; 1,0,0,0; %inf,0,1,-1];
gph = gph_plq(plq),
// gph  =
// 
//  - 1.    0.    0.    1.    1.    2.  
//  - 1.  - 1.    0.    0.    1.    1.  
//    1.    0.    0.    0.    0.    1.  
  ]]></programlisting></refsection>


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


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

</refentry>
