[doc] comparisons page improved
[scilab.git] / scilab / modules / elementary_functions / help / fr_FR / trigonometry / asec.xml
1 <?xml version="1.0" encoding="utf-8"?>
2 <!--
3  * Ajouter ici d'éventuels commentaires sur le fichier XML
4 -->
5 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="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="asec" xml:lang="fr">
6     <refnamediv>
7         <refname>asec</refname>
8         <refpurpose>sécante inverse des éléments de l'argument.</refpurpose>
9     </refnamediv>
10     <refsynopsisdiv>
11         <title>Séquence d'appel</title>
12         <synopsis>y = asec(x)</synopsis>
13     </refsynopsisdiv>
14     <refsection>
15         <title>Paramètres</title>
16         <variablelist>
17             <varlistentry>
18                 <term>x</term>
19                 <listitem>
20                     <para>Tableau réel ou complexe.</para>
21                 </listitem>
22             </varlistentry>
23             <varlistentry>
24                 <term>y</term>
25                 <listitem>
26                     <para>Tableau réel ou complexe.</para>
27                 </listitem>
28             </varlistentry>
29         </variablelist>
30     </refsection>
31     <refsection>
32         <title>Description</title>
33         <para>
34             Les éléments de <literal>y</literal> sont les séquentes inverses des
35             éléments correspondants de <literal>x</literal>. Pour les données réelles
36             dont la valeur absolue est supérieure à <literal>1</literal>, les
37             résultats sont réel et dans l'intervalle <literal>[-%pi/2
38                 %pi/2];
39             </literal>
40         </para>
41         <para>
42             Les égalités suivantes sont respectées: <literal>asec(z) = -acsc(-z)
43                 = asin(1/z) = %pi/2-asec(x) = %i*acsch(%i*z)
44             </literal>
45         </para>
46     </refsection>
47     <refsection>
48         <title>Exemples</title>
49         <programlisting role="example"><![CDATA[
50 x=[1 2 -2 sqrt(2) -sqrt(2) 2/sqrt(3) -2/sqrt(3) -1];
51 asec(x)/%pi
52  ]]></programlisting>
53     </refsection>
54     <refsection role="see also">
55         <title>Voir aussi</title>
56         <simplelist type="inline">
57             <member>
58                 <link linkend="asecd">asecd</link>
59             </member>
60             <member>
61                 <link linkend="sec">sec</link>
62             </member>
63             <member>
64                 <link linkend="secd">secd</link>
65             </member>
66         </simplelist>
67     </refsection>
68     <refsection>
69         <title>Références</title>
70         <simplelist type="vert">
71             <member>Kahan, W., “Branch cuts for complex elementary functions, or,
72                 Much ado about nothing's sign bit”, Proceedings of the joing IMA/SIAM
73                 conference on The State of the Art in Numerical Analysis, University of
74                 Birmingham, A. Iserles and M.J.D. Powell, eds, Clarendon Press, Oxford,
75                 1987, 165-210.
76             </member>
77         </simplelist>
78     </refsection>
79 </refentry>