<?xml version="1.0" encoding="UTF-8"?>
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
          xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml"
          xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
          xmlns:scilab="http://www.scilab.org" xml:id="atan" xml:lang="pt">
    <refnamediv>
        <refname>atan</refname>
        <refpurpose>arco-tangente 2-quadrantes e 4-quadrantes</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
        <title>Seqüência de Chamamento</title>
        <synopsis>
            phi = atan(x)
            phi = atan(y,x)
        </synopsis>
    </refsynopsisdiv>
    <refsection>
        <title>Parâmetros</title>
        <variablelist>
            <varlistentry>
                <term>x</term>
                <listitem>
                    <para>escalar real ou complexo, ou vetor ou matriz de reais ou
                        complexos
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>phi</term>
                <listitem>
                    <para>escalar real ou complexo, ou vetor ou matriz de reais ou
                        complexos
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>x, y</term>
                <listitem>
                    <para>escalares real, ou vetores ou matrizes de reais de mesmo
                        tamanho
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>phi</term>
                <listitem>
                    <para>escalar real, ou vetor ou matriz de reais</para>
                </listitem>
            </varlistentry>
        </variablelist>
    </refsection>
    <refsection>
        <title>Descrição</title>
        <para>A primeira forma computa o arco-tangente 2-quadrantes, que é o
            inverso de <literal>tan(phi)</literal>. Para um real <literal>x</literal>,
            <literal>phi</literal> está no intervalo (-π/2,π/2).. Para um complexo
            <literal>x</literal>, <literal>atan</literal> tem dois pontos de
            ramificação singulares <literal>+%i</literal>,<literal>-%i</literal> e os
            ramos escolhidos são as duas semi-retas imaginárias [i,i∞) e (-i∞,-i].
        </para>
        <para>A segunda forma computa o arco-tangente 4-quadrantes (atan2 em
            FORTRAN), isto é, retorna o argumento (ângulo) do número complexo
            <literal>x+i*y</literal>. A imagem de <literal>atan(y,x)</literal> é (-π,π].
        </para>
        <para>Para argumentos reais, ambas as formas produzem valores idênticos se
            <literal>x&gt;0</literal>.
        </para>
        <para>No caso de os argumentos serem vetores ou matrizes, a avaliação é
            feita elemento a elemento, de modo que <literal>phi</literal> é um vetor
            ou matriz com o mesmo tamanho de <literal>phi(i,j)=atan(x(i,j))</literal>
            ou <literal>phi(i,j)=atan(y(i,j),x(i,j))</literal>.
        </para>
    </refsection>
    <refsection>
        <title>Exemplos</title>
        <programlisting role="example"><![CDATA[
// exemplos com a segunda forma
x=[1,%i,-1,%i]
phasex=atan(imag(x),real(x))
atan(0,-1)
atan(-%eps,-1)

// ramos
atan(-%eps + 2*%i)
atan(+%eps + 2*%i)
atan(-%eps - 2*%i)
atan(+%eps - 2*%i)

// valores nos pontos de ramificação
ieee(2)
atan(%i)
atan(-%i)
 ]]></programlisting>
    </refsection>
    <refsection role="see also">
        <title>Ver Também</title>
        <simplelist type="inline">
            <member>
                <link linkend="atand">atand</link>
            </member>
            <member>
                <link linkend="tan">tan</link>
            </member>
            <member>
                <link linkend="tand">tand</link>
            </member>
            <member>
                <link linkend="unwrap">unwrap</link>
            </member>
            <member>
                <link linkend="ieee">ieee</link>
            </member>
        </simplelist>
    </refsection>
</refentry>
