* Bug 15891 fixed: [doc] matrix-wise trigo pages => subsection
[scilab.git] / scilab / modules / elementary_functions / help / pt_BR / size.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="size" xml:lang="pt">
17     <refnamediv>
18         <refname>size</refname>
19         <refpurpose>tamanho de objetos</refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>Seqüência de Chamamento</title>
23         <synopsis>y=size(x [,sel])
24             [nr,nc]=size(x)
25         </synopsis>
26     </refsynopsisdiv>
27     <refsection>
28         <title>Parâmetros</title>
29         <variablelist>
30             <varlistentry>
31                 <term>x</term>
32                 <listitem>
33                     <para>matrix (incluindo matriz de transferência), lista, ou sistema
34                         linear (<literal>syslin</literal>)
35                     </para>
36                 </listitem>
37             </varlistentry>
38             <varlistentry>
39                 <term>y</term>
40                 <listitem>
41                     <para>
42                         <literal> 1x2</literal> vetor de inteiros ou número inteiro
43                     </para>
44                 </listitem>
45             </varlistentry>
46             <varlistentry>
47                 <term>sel</term>
48                 <listitem>
49                     <para>um escalar ou um string </para>
50                 </listitem>
51             </varlistentry>
52             <varlistentry>
53                 <term>nr,nc</term>
54                 <listitem>
55                     <para>dois inteiros </para>
56                 </listitem>
57             </varlistentry>
58         </variablelist>
59     </refsection>
60     <refsection>
61         <title>Descrição</title>
62         <variablelist>
63             <varlistentry>
64                 <term>Aplicado a :</term>
65                 <listitem>
66                     <para> uma matriz (de constantes, de polinômios, de "strings", de
67                         booleanos ou de razões de polinômios) <literal>x</literal>, com
68                         apenas um argumento LHS ("Left Hand Side" ou "do lado esquerdo")
69                         <literal>size</literal> retorna um vetor
70                         <literal>1</literal>x<literal>2</literal> [número de linhas, número
71                         de colunas]. Chamado com LHS= 2, retorna <literal>nr,nc</literal> =
72                         [número de linhas, número de colunas]. <literal>sel</literal> pode
73                         ser usado para especficar a dimensão a ser recebida:
74                     </para>
75                 </listitem>
76             </varlistentry>
77             <varlistentry>
78                 <term>1 ou 'r'</term>
79                 <listitem>
80                     <para>para receber o número de linhas. </para>
81                 </listitem>
82             </varlistentry>
83             <varlistentry>
84                 <term>2 ou 'c'</term>
85                 <listitem>
86                     <para>para receber o número de colunas</para>
87                 </listitem>
88             </varlistentry>
89             <varlistentry>
90                 <term>'*'</term>
91                 <listitem>
92                     <para>para receber o produto de linhas e números de colunas </para>
93                 </listitem>
94             </varlistentry>
95             <varlistentry>
96                 <term>Aplicado a:</term>
97                 <listitem>
98                     <para>uma lista retorna o número de elementos. Neste caso, apenas a
99                         sintaxe <literal>y=size(x)</literal> pode ser usada.
100                     </para>
101                 </listitem>
102             </varlistentry>
103             <varlistentry>
104                 <term>Aplicado a:</term>
105                 <listitem>
106                     <para>
107                         um sistema linear, <literal>y=size(x)</literal> retorna em
108                         <literal>y</literal> o vetor (linha) [número de saídas, número de
109                         entradas] i.e. a dimensão da matriz de transferência correspondente.
110                         A sintaxe <literal>[nr,nc]=size(x)</literal> também é válida (com
111                         <literal>(nr,nc)=(y(1),y(2)</literal>). Se <literal>x</literal> é um
112                         sistema linear em forma de estado-espaço, então
113                         <literal>[nr,nc,nx]=size(x)</literal> retorna ainda a dimensão
114                         <literal>nx</literal> da matriz <literal>A</literal> de
115                         <literal>x</literal>.
116                     </para>
117                 </listitem>
118             </varlistentry>
119             <varlistentry>
120                 <term>Aplicado a</term>
121                 <listitem>
122                     <para>
123                         uma hipermatriz <literal> y=size(x) </literal> retorna o vetor
124                         de dimensões da hipermatriz. <literal> [n1,n2,...nn]=size(x)
125                         </literal>
126                         retorna as dimensões da hipermatriz. <literal>
127                             ni=size(x,i)
128                         </literal>
129                         retorna a i-ésima dimensão e
130                         <literal>size(x,'*') </literal> retorna o produto de
131                         dimensões.
132                     </para>
133                 </listitem>
134             </varlistentry>
135         </variablelist>
136     </refsection>
137     <refsection>
138         <title>Exemplos</title>
139         <programlisting role="example"><![CDATA[
140 [n,m]=size(rand(3,2))
141 [n,m]=size(['a','b';'c','d'])
142 x=ssrand(3,2,4);[ny,nu]=size(x)
143 [ny,nu]=size(ss2tf(x))
144 [ny,nu,nx]=size(x)
145  ]]></programlisting>
146     </refsection>
147     <refsection role="see also">
148         <title>Ver Também</title>
149         <simplelist type="inline">
150             <member>
151                 <link linkend="length">length</link>
152             </member>
153             <member>
154                 <link linkend="syslin">syslin</link>
155             </member>
156         </simplelist>
157     </refsection>
158 </refentry>