94196e6a15b7748ea31208bb61dddd3fdb20455d
[scilab.git] / scilab / modules / elementary_functions / help / pt_BR / floating_point / number_properties.xml
1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <refentry version="5.0-subset Scilab" xml:id="number_properties" xml:lang="en"
3           xmlns="http://docbook.org/ns/docbook"
4           xmlns:xlink="http://www.w3.org/1999/xlink"
5           xmlns:svg="http://www.w3.org/2000/svg"
6           xmlns:ns3="http://www.w3.org/1999/xhtml"
7           xmlns:mml="http://www.w3.org/1998/Math/MathML"
8           xmlns:db="http://docbook.org/ns/docbook">
9   <info>
10     <pubdate>$LastChangedDate$</pubdate>
11   </info>
12
13   <refnamediv>
14     <refname>number_properties</refname>
15
16     <refpurpose>determina parâmetros de ponto flutuante</refpurpose>
17   </refnamediv>
18
19   <refsynopsisdiv>
20     <title>Seqüência de Chamamento</title>
21
22     <synopsis>pr = number_properties(prop)</synopsis>
23   </refsynopsisdiv>
24
25   <refsection>
26     <title>Parâmetros</title>
27
28     <variablelist>
29       <varlistentry>
30         <term>prop</term>
31
32         <listitem>
33           <para>string</para>
34         </listitem>
35       </varlistentry>
36
37       <varlistentry>
38         <term>pr</term>
39
40         <listitem>
41           <para>escalar real ou booleano </para>
42         </listitem>
43       </varlistentry>
44     </variablelist>
45   </refsection>
46
47   <refsection>
48     <title>Descrição </title>
49
50     <para>Esta função pode ser usada para receber os números/propriedades
51     característicos do conjunto de pontos flutuantes aqui dentoado por
52     <literal>F(b,p,emin,emax)</literal> ((geralmente o conjunto de "floats" de
53     64 bits prescritos por IEEE 754). Números de <literal>F</literal> são da
54     forma: </para>
55
56     <programlisting role = ""><![CDATA[ 
57      sign * m * b^e
58  ]]></programlisting>
59
60     <para><literal>e</literal> é o expoente e <literal>m</literal> a
61     mantissa:</para>
62
63     <programlisting role = ""><![CDATA[ 
64      m = d_1 b^(-1) + d_2 b^(-2) + .... + d_p b^(-p)
65  ]]></programlisting>
66
67     <para><literal>d_i</literal> os dígitos estão em <literal>[0,
68     b-1]</literal> e <literal>e</literal> em <literal>[emin, emax]</literal>,
69     o número é dito "normalizado" se <literal>d_1 ~= 0</literal>. Os seguintes
70     podem ser recebidos: </para>
71
72     <variablelist>
73       <varlistentry>
74         <term>prop = "radix"</term>
75
76         <listitem>
77           <para>então <literal>pr</literal> é a raiz <literal>b</literal> do
78           conjunto <literal>F</literal></para>
79         </listitem>
80       </varlistentry>
81
82       <varlistentry>
83         <term>prop = "digits"</term>
84
85         <listitem>
86           <para>então <literal>pr</literal> é o número de dígitos de
87           <literal>p</literal></para>
88         </listitem>
89       </varlistentry>
90
91       <varlistentry>
92         <term>prop = "huge"</term>
93
94         <listitem>
95           <para>então <literal>pr</literal> é o maior float positivo de
96           <literal>F</literal></para>
97         </listitem>
98       </varlistentry>
99
100       <varlistentry>
101         <term>prop = "tiny"</term>
102
103         <listitem>
104           <para>então <literal>pr</literal> é o menor float normalizado
105           positivo de <literal>F</literal></para>
106         </listitem>
107       </varlistentry>
108
109       <varlistentry>
110         <term>prop = "denorm"</term>
111
112         <listitem>
113           <para>então <literal>pr</literal> é um booleano (%t se números
114           denormalizados são utilizados) </para>
115         </listitem>
116       </varlistentry>
117
118       <varlistentry>
119         <term>prop = "tiniest"</term>
120
121         <listitem>
122           <para>então se denorm = %t, <literal>pr</literal> é o número
123           positivo denormalizado mínimo. Em outro caso, <literal>pr</literal>
124           = tiny</para>
125         </listitem>
126       </varlistentry>
127
128       <varlistentry>
129         <term>prop = "eps"</term>
130
131         <listitem>
132           <para>então <literal>pr</literal> é a máquina epsilon ( geralmente
133           (<literal>b^(1-p))/2</literal> ) que é o erro máximo relativo entre
134           um real <literal>x</literal> (tal que <literal>|x|</literal> está em
135           <literal>[tiny, huge]</literal>) e <literal>fl(x)</literal>, sua
136           aproximação em ponto flutuante em <literal>F</literal></para>
137         </listitem>
138       </varlistentry>
139
140       <varlistentry>
141         <term>prop = "minexp"</term>
142
143         <listitem>
144           <para>então <literal>pr</literal> é <literal>emin</literal></para>
145         </listitem>
146       </varlistentry>
147
148       <varlistentry>
149         <term>prop = "maxexp"</term>
150
151         <listitem>
152           <para>então <literal>pr</literal> é <literal>emax</literal></para>
153         </listitem>
154       </varlistentry>
155     </variablelist>
156   </refsection>
157
158   <refsection>
159     <title>Observações</title>
160
161     <para>Esta função usa uma rotina de LAPACK dlamch para receber os
162     parâmetros máquinas (os nomes (radix, digits, huge, etc...) são aqueles
163     recomendados pelo padrão LIA 1 e são diferentes daqueles correspondentes
164     em LAPACK) ; CUIDADO: às vezes você poderá encontrar a seguinte para a
165     máquina epsilon: <literal>eps = b^(1-p)</literal> , mas nesta função nós
166     usamos a definição tradicional (ver prop = "eps" acima) e então
167     <literal>eps = (b^(1-p))/2</literal> se o arredondamento normal acontecer
168     e <literal>eps = b^(1-p)</literal> se não acontecer.</para>
169   </refsection>
170
171   <refsection>
172     <title>Exemplos</title>
173
174     <programlisting role="example"><![CDATA[ 
175 b = number_properties("radix")
176 eps = number_properties("eps")
177  ]]></programlisting>
178   </refsection>
179
180   <refsection role="see also">
181 <title>Ver Também</title>
182
183     <simplelist type="inline">
184       <member><link linkend="nearfloat">nearfloat</link></member>
185
186       <member><link linkend="frexp">frexp</link></member>
187     </simplelist>
188   </refsection>
189
190   <refsection>
191     <title>Autor</title>
192
193     <para>Bruno Pincon</para>
194   </refsection>
195 </refentry>