* Bug 16021 fixed: tand(90) cotd(90) 1/cosd(90) were wrong
[scilab.git] / scilab / modules / elementary_functions / help / pt_BR / trigonometry / cotd.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  * Copyright (C) 2012 - 2016 - Scilab Enterprises
6  * Copyright (C) 2019 - Samuel GOUGEON
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
17           xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml"
18           xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
19           xmlns:scilab="http://www.scilab.org" xml:id="cotd" xml:lang="pt">
20     <refnamediv>
21         <refname>cotd</refname>
22         <refpurpose>cotangent elemento a elemento do argumento dado em
23             graus
24         </refpurpose>
25     </refnamediv>
26     <refsynopsisdiv>
27         <title>Seqüência de Chamamento</title>
28         <synopsis>y = cotd(x)</synopsis>
29     </refsynopsisdiv>
30     <refsection>
31         <title>Parâmetros</title>
32         <variablelist>
33             <varlistentry>
34                 <term>x</term>
35                 <listitem>
36                     <para>array de reais</para>
37                 </listitem>
38             </varlistentry>
39             <varlistentry>
40                 <term>y</term>
41                 <listitem>
42                     <para>array de reais com as mesmas dimensões que
43                         <literal>x</literal>.
44                     </para>
45                 </listitem>
46             </varlistentry>
47         </variablelist>
48     </refsection>
49     <refsection>
50         <title>Descrição</title>
51         <para>
52             As entradas <literal>y</literal> são as cotangentes das entradas
53             correspondentes de <literal>x</literal> supostamente dadas em graus.
54             <literal>t=cos(x)./sin(x)</literal>. Para entradas iguais a
55             <literal>n*180</literal> com <literal>n</literal> inteiro, os resultados
56             são infinitos, enquanto que com <literal>cotg(n*%pi)</literal> o resultado
57             é grande, pois <literal>%pi</literal> não pode ser representado
58             exatamente. para entradas iguais a <literal>n*90</literal> com
59             <literal>n</literal> inteiro e ímpar, o resultado é exatamente 0.
60         </para>
61     </refsection>
62     <refsection>
63         <title>Exemplos</title>
64         <programlisting role="example"><![CDATA[
65 cotd([30 45 60 90])
66 cotd([-180 -90 0 90 180])
67  ]]></programlisting>
68     <screen><![CDATA[
69 --> cotd([30 45 60 90])
70  ans  =
71    1.7320508   1.   0.5773503   0.
72
73 --> cotd([-180 -90 0 90 180])
74  ans  =
75    Inf   0.   Inf   0.   Inf
76 ]]></screen>
77     </refsection>
78     <refsection role="see also">
79         <title>Ver Também</title>
80         <simplelist type="inline">
81             <member>
82                 <link linkend="cotg">cotg</link>
83             </member>
84             <member>
85                 <link linkend="coth">coth</link>
86             </member>
87             <member>
88                 <link linkend="tan">tan</link>
89             </member>
90             <member>
91                 <link linkend="tand">tand</link>
92             </member>
93         </simplelist>
94     </refsection>
95 </refentry>