<?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) 1996 by CNRS (France).
-->

<refentry xml:id="noisecu" 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>noisecu</refname>
	<refpurpose>Analytic complex uniform white noise</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <title>Calling Sequence</title>
    <synopsis>
      NOISE = noisecu(N)
    </synopsis>
  </refsynopsisdiv>

  <refsection>
    <title>Parameters</title>
    <variablelist>
      <varlistentry>
        <term>N:</term>
        <listitem>
          <para>a positive integer: the length of the noise signal.</para>
        </listitem>
      </varlistentry>
      
      <varlistentry>
        <term>NOISE:</term>
        <listitem>
          <para>a complex column vector of size N: the noise signal.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsection>
  <refsection>
    <title>Description</title>
    <para>
      noisecu computes an analytic complex white uniform noise of length N with mean 0.0 and variance 1.0.
    </para>
  </refsection>

  <refsection>
    <title>Examples</title>
    <programlisting role="example"><![CDATA[
    N = 512; noise = noisecu(N);
    m = mean(noise)
	sigma2 = sum((noise-m).^2)
    subplot(211); plot(real(noise)); a=gca(); a.data_bounds = ([1 N -1.5 1.5]);
    f = linspace(-0.5,0.5,N);
	subplot(212); plot(f,abs(fftshift(fft(noise))).^2);
    ]]></programlisting>
    <scilab:image><![CDATA[
    N=512;noise=noisecu(N);
    m=mean(noise),sigma2=sum((noise-m).^2)
    subplot(211); plot(real(noise)); a=gca();a.data_bounds=([1 N -1.5 1.5]);
    subplot(212); f=linspace(-0.5,0.5,N);
    plot(f,abs(fftshift(fft(noise))).^2);
    ]]></scilab:image>
  </refsection>

  <refsection role="see also">
    <title>See also</title>
    <simplelist type="inline">
      <member><link linkend="noisecg">noisecg</link></member>
    </simplelist>
  </refsection>

  <refsection>
    <title>Authors</title>
    <simplelist type="vert">
      <member>H. Nahrstaedt - Aug 2010</member>
      <member>O. Lemoine, June 95/May 96 - F. Auger, August 95.</member>
    </simplelist>
  </refsection>
</refentry>
