ISO-8859-1 to UTF-8
[scilab.git] / scilab / modules / elementary_functions / help / pt_BR / size.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) 2008 - INRIA
5  * 
6  * This file must be used under the terms of the CeCILL.
7  * This source file is licensed as described in the file COPYING, which
8  * you should have received as part of this distribution.  The terms
9  * are also available at    
10  * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
11  *
12  -->
13 <refentry version="5.0-subset Scilab" xml:id="size" xml:lang="en"
14           xmlns="http://docbook.org/ns/docbook"
15           xmlns:xlink="http://www.w3.org/1999/xlink"
16           xmlns:svg="http://www.w3.org/2000/svg"
17           xmlns:ns3="http://www.w3.org/1999/xhtml"
18           xmlns:mml="http://www.w3.org/1998/Math/MathML"
19           xmlns:db="http://docbook.org/ns/docbook">
20   <info>
21     <pubdate>$LastChangedDate$</pubdate>
22   </info>
23
24   <refnamediv>
25     <refname>size</refname>
26
27     <refpurpose>tamanho de objetos</refpurpose>
28   </refnamediv>
29
30   <refsynopsisdiv>
31     <title>Seqüência de Chamamento</title>
32
33     <synopsis>y=size(x [,sel])
34 [nr,nc]=size(x)</synopsis>
35   </refsynopsisdiv>
36
37   <refsection>
38     <title>Parâmetros</title>
39
40     <variablelist>
41       <varlistentry>
42         <term>x</term>
43
44         <listitem>
45           <para>matrix (incluindo matriz de transferência), lista, ou sistema
46           linear (<literal>syslin</literal>)</para>
47         </listitem>
48       </varlistentry>
49
50       <varlistentry>
51         <term>y</term>
52
53         <listitem>
54           <para>: <literal> 1x2</literal> vetor de inteiros ou número inteiro
55           </para>
56         </listitem>
57       </varlistentry>
58
59       <varlistentry>
60         <term>sel</term>
61
62         <listitem>
63           <para>um escalar ou um string </para>
64         </listitem>
65       </varlistentry>
66
67       <varlistentry>
68         <term>nr,nc</term>
69
70         <listitem>
71           <para>dois inteiros </para>
72         </listitem>
73       </varlistentry>
74     </variablelist>
75   </refsection>
76
77   <refsection>
78     <title>Descrição</title>
79
80     <variablelist>
81       <varlistentry>
82         <term>Aplicado a :</term>
83
84         <listitem>
85           <para> uma matriz (de constantes, de polinômios, de "strings", de
86           booleanos ou de razões de polinômios) <literal>x</literal>, com
87           apenas um argumento LHS ("Left Hand Side" ou "do lado esquerdo")
88           <literal>size</literal> retorna um vetor
89           <literal>1</literal>x<literal>2</literal> [número de linhas, número
90           de colunas]. Chamado com LHS= 2, retorna <literal>nr,nc</literal> =
91           [número de linhas, número de colunas]. <literal>sel</literal> pode
92           ser usado para especficar a dimensão a ser recebida: </para>
93         </listitem>
94       </varlistentry>
95
96       <varlistentry>
97         <term>1 ou 'r'</term>
98
99         <listitem>
100           <para>para receber o número de linhas. </para>
101         </listitem>
102       </varlistentry>
103
104       <varlistentry>
105         <term>2 ou 'c'</term>
106
107         <listitem>
108           <para>para receber o número de colunas</para>
109         </listitem>
110       </varlistentry>
111
112       <varlistentry>
113         <term>'*'</term>
114
115         <listitem>
116           <para>para receber o produto de linhas e números de colunas </para>
117         </listitem>
118       </varlistentry>
119
120       <varlistentry>
121         <term>Aplicado a:</term>
122
123         <listitem>
124           <para>uma lista retorna o número de elementos. Neste caso, apenas a
125           sintaxe <literal>y=size(x)</literal> pode ser usada.</para>
126         </listitem>
127       </varlistentry>
128
129       <varlistentry>
130         <term>Aplicado a:</term>
131
132         <listitem>
133           <para>um sistema linear, <literal>y=size(x)</literal> retorna em
134           <literal>y</literal> o vetor (linha) [número de saídas, número de
135           entradas] i.e. a dimensão da matriz de transferência correspondente.
136           A sintaxe <literal>[nr,nc]=size(x)</literal> também é válida (com
137           <literal>(nr,nc)=(y(1),y(2)</literal>). Se <literal>x</literal> é um
138           sistema linear em forma de estado-espaço, então
139           <literal>[nr,nc,nx]=size(x)</literal> retorna ainda a dimensão
140           <literal>nx</literal> da matriz <literal>A</literal> de
141           <literal>x</literal>.</para>
142         </listitem>
143       </varlistentry>
144
145       <varlistentry>
146         <term>Aplicado a</term>
147
148         <listitem>
149           <para>uma hipermatriz <literal> y=size(x) </literal> retorna o vetor
150           de dimensões da hipermatriz. <literal> [n1,n2,...nn]=size(x)
151           </literal> retorna as dimensões da hipermatriz. <literal>
152           ni=size(x,i) </literal> retorna a i-ésima dimensão e
153           <literal>size(x,'*') </literal> retorna o produto de
154           dimensões.</para>
155         </listitem>
156       </varlistentry>
157     </variablelist>
158   </refsection>
159
160   <refsection>
161     <title>Exemplos</title>
162
163     <programlisting role="example">
164
165 [n,m]=size(rand(3,2))
166 [n,m]=size(['a','b';'c','d'])
167 x=ssrand(3,2,4);[ny,nu]=size(x)
168 [ny,nu]=size(ss2tf(x))
169 [ny,nu,nx]=size(x)
170  
171   </programlisting>
172   </refsection>
173
174   <refsection>
175     <title>Ver Também</title>
176
177     <simplelist type="inline">
178       <member><link linkend="length">length</link></member>
179
180       <member><link linkend="syslin">syslin</link></member>
181     </simplelist>
182   </refsection>
183 </refentry>