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  * 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>