<?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_isEqual">
  <info>
    <pubdate>14-May-2010</pubdate>
  </info>

  <refnamediv>
    <refname>gph_isEqual</refname>
    <refpurpose>Graph-matrix calculus (GPH), Model equivalence test</refpurpose>
  </refnamediv>

   <refsynopsisdiv>
     <title>Calling Sequence</title>
     <synopsis>b = gph_isEqual(gph1, gph2)</synopsis>
   </refsynopsisdiv>

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

       <varlistentry>
         <term>gph1</term>
         <listitem>
           <para>matrix.  A function in GPH matrix form.</para>
         </listitem>
       </varlistentry>

       <varlistentry>
         <term>gph2</term>
         <listitem>
           <para>matrix.  A function in GPH matrix form.</para>
         </listitem>
       </varlistentry>

       <varlistentry>
         <term>b</term>
         <listitem>
           <para>boolean.  Whether or not the models are equivalent.</para>
         </listitem>
       </varlistentry>

     </variablelist>
   </refsection>

   <refsection>
     <title>Description</title>

     <para>
       Accepts two GPH matrices, and returns true if and only if both
       models represent the same PLQ function, ignoring rounding error
       and redundant points.
     </para>
   </refsection>

   <refsection>
     <title>Examples</title>
     <programlisting role="example"><![CDATA[
gph1 = [0 1; 0 2; 0 1];
gph2 = [-1 -0.5; -2 -1; 1 0.25];
b = gph_isEqual(gph1, 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>
