← Back to branch summary

~ubuntu-branches/ubuntu/raring/scilab/raring-proposed

« back to all changes in this revision

Viewing changes to modules/elementary_functions/help/pt_BR/floating_point/number_properties.xml

  • Committer: Package Import Robot
  • Author(s): Sylvestre Ledru
  • Date: 2012-08-30 14:42:38 UTC
  • mfrom: (1.4.7)
  • Revision ID: package-import@ubuntu.com-20120830144238-c1y2og7dbm7m9nig
Tags: 5.4.0-beta-3-1~exp1
* New upstream release
* Update the scirenderer dep
* Get ride of libjhdf5-java dependency

Show diffs side-by-side

added added

removed removed

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