modified hooks to remove trailing whitespaces for help files
[scilab.git] / scilab / modules / elementary_functions / help / pt_BR / exponential / power.xml
1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <refentry 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" xmlns:scilab="http://www.scilab.org" xml:id="power" xml:lang="pt">
3     <refnamediv>
4         <refname>power</refname>
5         <refpurpose>operação de potenciação(^,.^)</refpurpose>
6     </refnamediv>
7     <refsynopsisdiv>
8         <title>Seqüência de Chamamento</title>
9         <synopsis>t=A^b
10             t=A**b
11             t=A.^b
12         </synopsis>
13     </refsynopsisdiv>
14     <refsection>
15         <title>Parâmetros</title>
16         <variablelist>
17             <varlistentry>
18                 <term>A,t</term>
19                 <listitem>
20                     <para>matriz de escalares, polinômios ou razões de
21                         polinômios.
22                     </para>
23                 </listitem>
24             </varlistentry>
25             <varlistentry>
26                 <term>b</term>
27                 <listitem>
28                     <para>um escalar ou um vetor ou matriz de escalares.</para>
29                 </listitem>
30             </varlistentry>
31         </variablelist>
32     </refsection>
33     <refsection>
34         <title>Descrição</title>
35         <itemizedlist>
36             <listitem>
37                 <para>
38                     <literal>"(A:square)^(b:scalar)"</literal>Se
39                     <literal>A</literal> é uma matriz quadrada e <literal>b</literal> é um
40                     escalar, então <literal>A^b</literal> é a matriz <literal>A</literal>
41                     elevada à potência <literal>b</literal>.
42                 </para>
43             </listitem>
44             <listitem>
45                 <para>
46                     <literal>"(A:matrix).^(b:scalar)"</literal>Se
47                     <literal>b</literal> é um escalar e <literal>A</literal> uma matriz,
48                     então <literal>A.^b</literal> é formada pelos elementos de
49                     <literal>A</literal> elevados à potência <literal>b</literal>
50                     (potenciação elemento a elemento). Se <literal>A</literal> é um vetor
51                     e <literal>b</literal> é um escalar, então <literal>A^b</literal> e
52                     <literal>A.^b</literal> realizam a mesma operação (i.e., potenciação
53                     elemento a elemento).
54                 </para>
55             </listitem>
56             <listitem>
57                 <para>
58                     <literal>"(A:scalar).^(b:matrix)"</literal> Se
59                     <literal>A</literal> é um escalar e <literal>b</literal> é uma matriz
60                     (ou vetor) então <literal>A^b</literal> e <literal>A.^b</literal> são
61                     as matrizes (ou vetores) formados por<literal>
62                         a^(b(i,j))
63                     </literal>
64                     .
65                 </para>
66             </listitem>
67             <listitem>
68                 <para>
69                     <literal>"(A:matrix).^(b:matrix)"</literal> Se
70                     <literal>A</literal> e <literal>b</literal> são vetores (matrizes) de
71                     mesmo tamanho <literal>A.^b</literal> é o vetor
72                     <literal>A(i)^b(i)</literal> (matriz
73                     <literal>A(i,j)^b(i,j)</literal>).
74                 </para>
75             </listitem>
76         </itemizedlist>
77         <para>Notas:</para>
78         <para>
79             - Para matrizes quadradas <literal>A^p</literal> é computada através
80             de sucessivas multiplicações de matrizes se <literal>p</literal> is é um
81             número inteiro positivo e por diagonalização se não for.
82         </para>
83         <para>- Os operadores ** e ^ são sinônimos.</para>
84     </refsection>
85     <refsection>
86         <title>Exemplos</title>
87         <programlisting role="example"><![CDATA[
88 A=[1 2;3 4];
89 A^2.5,
90 A.^2.5
91 (1:10)^2
92 (1:10).^2
93
94 s=poly(0,'s')
95 s^(1:10)
96  ]]></programlisting>
97     </refsection>
98     <refsection>
99         <title> Ver Também </title>
100         <simplelist type="inline">
101             <member>
102                 <link linkend="exp">exp</link>
103             </member>
104         </simplelist>
105     </refsection>
106 </refentry>