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