help pages: toeplitz overhauled. diag, sparse, speye improved
[scilab.git] / scilab / modules / elementary_functions / help / pt_BR / elementarymatrices / diag.xml
index 14b3117..4169ac5 100644 (file)
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
+<?xml version="1.0" encoding="UTF-8"?>
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) 2008 - INRIA
  * along with this program.
  *
  -->
-<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="diag" xml:lang="pt">
+<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="diag" xml:lang="pt">
     <refnamediv>
         <refname>diag</refname>
-        <refpurpose>inclusão ou extração diagonal</refpurpose>
+        <refpurpose>inclusão ou extração diagonal</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
-        <title>Seqüência de Chamamento</title>
-        <synopsis>[y]=diag(vm, [k])</synopsis>
+        <title>Seqüência de Chamamento</title>
+        <synopsis>
+           y = diag(vm)
+           y = diag(vm, k)
+        </synopsis>
     </refsynopsisdiv>
     <refsection>
-        <title>Parâmetros</title>
+        <title>Parâmetros</title>
         <variablelist>
             <varlistentry>
                 <term>vm</term>
@@ -34,7 +40,7 @@
             <varlistentry>
                 <term>k</term>
                 <listitem>
-                    <para>inteiro (o valor padrão é 0)</para>
+                    <para>inteiro (o valor padrão é 0)</para>
                 </listitem>
             </varlistentry>
             <varlistentry>
         </variablelist>
     </refsection>
     <refsection>
-        <title>Descrição</title>
+        <title>Descrição</title>
         <para>
             Para um n-vetor (linha ou coluna) <literal>vm</literal> ,
             <literal>diag(vm)</literal> retorna uma matriz diagonal com entradas de
             <literal>vm</literal> ao longo da diagonal principal.
         </para>
         <para>
-            <literal>diag(vm,k)</literal> é uma matriz
+            <literal>diag(vm,k)</literal> é uma matriz
             <literal>(n+abs(k))x(n+abs(k))</literal> com entradas de
-            <literal>vm</literal> ao longo da k-ésima diagonal. <literal>k=0</literal>
-            é a diagonal principal, <literal>k&gt;0</literal> são as diagonais
-            superiores e <literal>k&lt;0</literal> são as diagonais inferiores.
+            <literal>vm</literal> ao longo da k-ésima diagonal. <literal>k=0</literal>
+            é a diagonal principal, <literal>k&gt;0</literal> são as diagonais
+            superiores e <literal>k&lt;0</literal> são as diagonais inferiores.
         </para>
         <para>
             Para uma matriz <literal>vm</literal>, <literal>diag(vm,k)</literal>
-            é o vetor coluna feito das entradas da k-ésima diagonal de
-            <literal>vm</literal>. <literal>diag(vm)</literal> é a diagonal principal
-            de <literal>vm</literal>. <literal>diag(diag(x))</literal> é a matriz
+            é o vetor coluna feito das entradas da k-ésima diagonal de
+            <literal>vm</literal>. <literal>diag(vm)</literal> é a diagonal principal
+            de <literal>vm</literal>. <literal>diag(diag(x))</literal> é a matriz
             diagonal.
         </para>
         <para>
-            Se <literal>vm</literal> é uma matriz esparsa,
+            Se <literal>vm</literal> é uma matriz esparsa,
             <literal>diag(vm,k)</literal> retorna uma matriz esparsa.
         </para>
         <para>Para construir um sistema linear diagonal, use
@@ -75,9 +81,9 @@
         </para>
         <para>
             Perceba que <literal>eye(A).*A</literal> retorna uma matriz diagonal
-            feita das entradas diagonais de <literal>A</literal>. Isto é válido para
-            qualquer matriz (constante, de polinômios, de razões de polinômios,
-            sistema linear em espaço de estados,...).
+            feita das entradas diagonais de <literal>A</literal>. Isto é válido para
+            qualquer matriz (constante, de polinômios, de razões de polinômios,
+            sistema linear em espaço de estados,...).
         </para>
     </refsection>
     <refsection>
@@ -96,13 +102,22 @@ m=5;diag(-m:m) +  diag(ones(2*m,1),1) +diag(ones(2*m,1),-1)
  ]]></programlisting>
     </refsection>
     <refsection role="see also">
-        <title>Ver Também</title>
+        <title>Ver Também</title>
         <simplelist type="inline">
             <member>
+                <link linkend="toeplitz">toeplitz</link>
+            </member>
+            <member>
+                <link linkend="eye">eye</link>
+            </member>
+            <member>
                 <link linkend="sysdiag">sysdiag</link>
             </member>
             <member>
-                <link linkend="sparse">sparse</link>
+                <link linkend="spec">spec</link>
+            </member>
+            <member>
+                <link linkend="bdiag">bdiag</link>
             </member>
         </simplelist>
     </refsection>