help pages: toeplitz overhauled. diag, sparse, speye improved
[scilab.git] / scilab / modules / sparse / help / pt_BR / matrixmanip / sprand.xml
1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) 2008 - INRIA
5  *
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="sprand" xml:lang="pt">
17     <refnamediv>
18         <refname>sprand</refname>
19         <refpurpose>matriz esparsa randômica</refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>Seqüência de Chamamento</title>
23         <synopsis>sp=sprand(nrows,ncols,fill [,typ])</synopsis>
24     </refsynopsisdiv>
25     <refsection>
26         <title>Parâmetros</title>
27         <variablelist>
28             <varlistentry>
29                 <term>nrows</term>
30                 <listitem>
31                     <para>inteiro (número de linhas) </para>
32                 </listitem>
33             </varlistentry>
34             <varlistentry>
35                 <term>ncols</term>
36                 <listitem>
37                     <para>inteiro (número de colunas)</para>
38                 </listitem>
39             </varlistentry>
40             <varlistentry>
41                 <term>fill</term>
42                 <listitem>
43                     <para>coeficiente de preenchimento (densidade) </para>
44                 </listitem>
45             </varlistentry>
46             <varlistentry>
47                 <term>typ</term>
48                 <listitem>
49                     <para>
50                         string (<literal>'uniform'</literal> (padrão) ou
51                         <literal>'normal'</literal>)
52                     </para>
53                 </listitem>
54             </varlistentry>
55             <varlistentry>
56                 <term>sp</term>
57                 <listitem>
58                     <para>matriz esparsa</para>
59                 </listitem>
60             </varlistentry>
61         </variablelist>
62     </refsection>
63     <refsection>
64         <title>Descrição</title>
65         <para>
66             <literal>sp=sprand(nrows,ncols,fill)</literal> retorna uma matriz
67             esparsa <literal>sp</literal> com <literal>nrows</literal> linhas e
68             <literal>ncols</literal> colunas e aproximadamente
69             <literal>fill*nrows*ncols</literal> entradas não-nulas.
70         </para>
71         <para>
72             Se <literal>typ='uniform'</literal> valores uniformemente
73             distribuídos em [0,1] são gerados. Se <literal>typ='normal'</literal>
74             valores normalmente distribuídos são gerados (média=0 e desvio
75             padrão=1).
76         </para>
77     </refsection>
78     <refsection>
79         <title>Exemplos</title>
80         <programlisting role="example"><![CDATA[
81 W=sprand(100,1000,0.001);
82  ]]></programlisting>
83     </refsection>
84     <refsection role="see also">
85         <title>Ver Também</title>
86         <simplelist type="inline">
87             <member>
88                 <link linkend="sparse">sparse</link>
89             </member>
90             <member>
91                 <link linkend="full">full</link>
92             </member>
93             <member>
94                 <link linkend="rand">rand</link>
95             </member>
96             <member>
97                 <link linkend="speye">speye</link>
98             </member>
99         </simplelist>
100     </refsection>
101 </refentry>