File: sparse.xml

package info (click to toggle)
scilab 5.2.2-9
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 334,832 kB
  • ctags: 52,586
  • sloc: xml: 526,945; ansic: 223,590; fortran: 163,080; java: 56,934; cpp: 33,840; tcl: 27,936; sh: 20,397; makefile: 9,908; ml: 9,451; perl: 1,323; cs: 614; lisp: 30
file content (139 lines) | stat: -rw-r--r-- 4,179 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
<?xml version="1.0" encoding="UTF-8"?>
<!--
 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) XXXX-2008 - INRIA
 * 
 * This file must be used under the terms of the CeCILL.
 * This source file is licensed as described in the file COPYING, which
 * you should have received as part of this distribution.  The terms
 * are also available at    
 * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
 *
 -->
<refentry version="5.0-subset Scilab" xml:id="sparse" 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:ns4="http://www.w3.org/1999/xhtml"
          xmlns:mml="http://www.w3.org/1998/Math/MathML"
          xmlns:db="http://docbook.org/ns/docbook">
  <info>
    <pubdate>$LastChangedDate$</pubdate>
  </info>

  <refnamediv>
    <refname>sparse</refname>

    <refpurpose>definição de matriz esparsa</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <title>Seqüência de Chamamento</title>

    <synopsis>sp=sparse(X)
sp=sparse(ij,v [,mn])</synopsis>
  </refsynopsisdiv>

  <refsection>
    <title>Parâmetros</title>

    <variablelist>
      <varlistentry>
        <term>X</term>

        <listitem>
          <para>matriz completa (ou esparsa) de reais ou complexos </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>ij</term>

        <listitem>
          <para>matriz de inteiros de duas colunas (índices das entradas não
          nulas) </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>v</term>

        <listitem>
          <para>vetor</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>mn</term>

        <listitem>
          <para>vetor de inteiros com duas entradas (dimensão de linha,
          dimensão de coluna) </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>sp</term>

        <listitem>
          <para>matriz esparsa </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsection>

  <refsection>
    <title>Descrição</title>

    <para><literal>sparse</literal> é usado para construir uma matriz esparsa.
    Apenas entradas não-nulas são armazenadas.</para>

    <para><literal>sp = sparse(X)</literal> converte uma matriz completa para
    sua forma esparsa retirando qualquer elemento nulo. (Se
    <literal>X</literal> já é esparsa <literal>sp</literal> é
    <literal>X</literal>).</para>

    <para><literal>sp=sparse(ij,v [,mn])</literal> constrói uma matriz esparsa
    <literal>mn(1)</literal>-por-<literal>mn(2)</literal> sparse matrix com
    <literal>sp(ij(k,1),ij(k,2))=v(k)</literal>. <literal>ij</literal> e
    <literal>v</literal> devem ter a mesma dimensão de coluna. Se o parâmetro
    opcional <literal>mn</literal> não for dado, as dimensões da matriz
    <literal>sp</literal> são os valores máximos de <literal>ij(:,1)</literal>
    e <literal>ij(:,2)</literal> respectivamente.</para>

    <para>Operações (concatenação, adição, etc,) com matrizes esparsas são
    feitas usando a mesma sintaxe para matrizes completas.</para>

    <para>Funções elementares também estão disponíveis
    (<literal>abs,maxi,sum,diag,...</literal>) para matrizes esparsas.</para>

    <para>Operações mistas (completas-esparsas) são permitidas. Os resultados
    são completos ou esparsos dependendo das operações.</para>
  </refsection>

  <refsection>
    <title>Exemplos</title>

    <programlisting role="example"><![CDATA[ 
sp=sparse([1,2;4,5;3,10],[1,2,3])
size(sp)
x=rand(2,2);abs(x)-full(abs(sparse(x)))
 ]]></programlisting>
  </refsection>

  <refsection>
    <title>Ver Também</title>

    <simplelist type="inline">
      <member><link linkend="full">full</link></member>

      <member><link linkend="spget">spget</link></member>

      <member><link linkend="sprand">sprand</link></member>

      <member><link linkend="speye">speye</link></member>

      <member><link linkend="lufact">lufact</link></member>
    </simplelist>
  </refsection>
</refentry>