help pages: toeplitz overhauled. diag, sparse, speye improved
[scilab.git] / scilab / modules / sparse / help / pt_BR / matrixmanip / spzeros.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="spzeros" xml:lang="pt">
17     <refnamediv>
18         <refname>spzeros</refname>
19         <refpurpose>matriz nula esparsa</refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>Seqüência de Chamamento</title>
23         <synopsis>sp=spzeros(nrows,ncols)
24             sp=spzeros(A)
25         </synopsis>
26     </refsynopsisdiv>
27     <refsection>
28         <title>Parâmetros</title>
29         <variablelist>
30             <varlistentry>
31                 <term>nrows</term>
32                 <listitem>
33                     <para>inteiro (número de linhas) </para>
34                 </listitem>
35             </varlistentry>
36             <varlistentry>
37                 <term>ncols</term>
38                 <listitem>
39                     <para>inteiro (número de colunas) </para>
40                 </listitem>
41             </varlistentry>
42             <varlistentry>
43                 <term>A</term>
44                 <listitem>
45                     <para>matriz esparsa </para>
46                 </listitem>
47             </varlistentry>
48             <varlistentry>
49                 <term>sp</term>
50                 <listitem>
51                     <para>matriz nula esparsa </para>
52                 </listitem>
53             </varlistentry>
54         </variablelist>
55     </refsection>
56     <refsection>
57         <title>Descrição</title>
58         <para>
59             <literal>sp=spzeros(nrows,ncols)</literal> retorna uma matriz nula
60             esparsa <literal>sp</literal> com <literal>nrows</literal> linhas e,
61             <literal>ncols</literal> colunas. (Equivalente a
62             <literal>sparse([],[],[nrow,ncols])</literal>)
63         </para>
64         <para>
65             <literal>sp=spzeros(A)</literal> retorna uma matriz nula esparsa com
66             as mesmas dimensões que <literal>A</literal>. Se
67             <literal>[m,n]=size(A)</literal>, <literal>spzeros(m,n)</literal> e
68             <literal>spzeros(A)</literal> são equivalentes. Em particular
69             <literal>spzeros(3)</literal> não é equivalente a
70             <literal>spzeros(3,3)</literal>.
71         </para>
72     </refsection>
73     <refsection>
74         <title>Exemplos</title>
75         <programlisting role="example"><![CDATA[
76 m=spzeros(2,2)
77 a=rand(10,12);
78 m=spzeros(a)
79 sum(spzeros(1000,1000))
80  ]]></programlisting>
81     </refsection>
82     <refsection role="see also">
83         <title>Ver Também</title>
84         <simplelist type="inline">
85             <member>
86                 <link linkend="sparse">sparse</link>
87             </member>
88             <member>
89                 <link linkend="full">full</link>
90             </member>
91             <member>
92                 <link linkend="eye">eye</link>
93             </member>
94             <member>
95                 <link linkend="speye">speye</link>
96             </member>
97             <member>
98                 <link linkend="spones">spones</link>
99             </member>
100         </simplelist>
101     </refsection>
102 </refentry>