<?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="plq_plotpa"><info><pubdate>16-Jul-2008</pubdate></info><refnamediv><refname>plq_plotpa</refname><refpurpose>Piecewise linear quadratic (plq), plot convex proximal average</refpurpose></refnamediv>
  
   
  
   
  
   
  
   
  
   

  
   <refsynopsisdiv><title>Calling Sequence</title><synopsis>plq_plotpa(plqf1, plqf2, x, lset, rect)
plq_plotpa(plqf1, plqf2, x, lset, rect, isConvex)</synopsis></refsynopsisdiv>

  
   <refsection><title>Parameters</title>
    
      <variablelist>
      
         <varlistentry>
        
            <term>plqf1</term>
        
            <listitem>
          
               <para>matrix.  The first function of the proximal average (lambda=0).
          </para>
        
            </listitem>
      
         </varlistentry>
      
         <varlistentry>
        
            <term>plqf2</term>
        
            <listitem>
          
               <para>matrix.  The second function of the proximal average (lambda=1).
          </para>
        
            </listitem>
      
         </varlistentry>
      
         <varlistentry>
        
            <term>x</term>
        
            <listitem>
          
               <para>column vector.  The points at which to evaluate the proximal average.
          </para>
        
            </listitem>
      
         </varlistentry>
      
         <varlistentry>
        
            <term>lset</term>
        
            <listitem>
          
               <para>column vector.  The lambda values at which to plot the proximal average.
          </para>
        
            </listitem>
      
         </varlistentry>
      
         <varlistentry>
        
            <term>rect</term>
        
            <listitem>
          
               <para>row vector.  [xmin,ymin,xmax,ymax] for the plot window as with plot2d.
          </para>
        
            </listitem>
      
         </varlistentry>
      
         <varlistentry>
        
            <term>isConvex</term>
        
            <listitem>
          
               <para>boolean, optional.  Whether or not plqf1 and plqf2 are both convex.  Defaults to %t.
          </para>
        
            </listitem>
      
         </varlistentry>
    
      </variablelist>
  
   </refsection>

  
   <refsection><title>Description</title>
      
         <para>
        For each lambda in lset, plots the proximal average of two PLQ functions over the provided x values.  The rect argument bounds the plot's visible region and is required.  All of the proximal averages are plotted on the same graph, and the colours of successive PA's fade from blue (lambda=0) to red (lambda=1) via jetcolormap.
      </para>
    
   </refsection>

  
   <refsection><title>Examples</title><programlisting role="example"><![CDATA[
plqf1 = [2,1,0,0;%inf,0,0,%inf];
plqf2 = [3,0,0,%inf;4,0,-1,4;%inf,0,1,-4];
x = linspace(-3, 7, 100)';
lset = 0:0.01:1;
rect = [-3,0,7,10];
plq_plotpa(plqf1, plqf2, x, lset, rect);
plot2d(x, [plq_eval(plqf1, x), plq_eval(plqf2, x)]);
a = gca();
a.children(1).children(1).thickness = 5;
a.children(1).children(2).thickness = 5;
  ]]></programlisting></refsection>

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

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

</refentry>