<?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) 1995 Rice University.
-->



<refentry xml:id="integ" 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>integ</refname><refpurpose>Approximate 1D integral of a discrete signal.</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <title>Calling Sequence</title>
    <synopsis>
      SOM=integ(Y,X)
    </synopsis>
  </refsynopsisdiv>

  <refsection>
    <title>Parameters</title>
    <variablelist>
      <varlistentry>
        <term>	Y   :</term>
        <listitem>
          <para> N-vector (or MxN-matrix)  to be integrated  (along each row).</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>	X   :</term>
        <listitem>
          <para> N-vector containing the integration path of Y	(default : 1:N)</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>	SOM :</term>
        <listitem>
          <para> value (or Mx1 vector) of the integral</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsection>

  <refsection>
    <title>Description</title>
    <para>
      integ approximates the integral of a discrete function given by
      the points (X(k),Y(k)) using trapezoidal approximation.
    </para>
  </refsection>

  <refsection>
    <title>Examples</title>
    <programlisting role="example"><![CDATA[
    Y = altes(256,0.1,0.45,10000)'; X = (0:255);
    SOM = integ(Y,X)
    ]]></programlisting>
  </refsection>

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

  <refsection>
    <title>Authors</title>
    <simplelist type="vert">
      <member>H. Nahrstaedt - Aug 2010</member>
      <member>	P. Goncalves, October 95</member>
    </simplelist>
  </refsection>
</refentry>
