* Bug 16145 fixed: intg() integrate() intc() default atol
[scilab.git] / scilab / modules / differential_equations / help / fr_FR / integrate.xml
index 176765d..5867c3b 100644 (file)
@@ -2,8 +2,8 @@
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) 2008 - INRIA
- *
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2020 - Samuel GOUGEON
  *
  * This file is hereby licensed under the terms of the GNU GPL v2.0,
  * pursuant to article 5.3.4 of the CeCILL v.2.1.
  * along with this program.
  *
  -->
-<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="integrate" xml:lang="fr">
+<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="integrate" xml:lang="fr">
     <refnamediv>
         <refname>integrate</refname>
         <refpurpose>intégration numérique d'une expression</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Séquence d'appel</title>
-        <synopsis>x=integrate(expr,v,x0,x1 [,atol [,rtol]])</synopsis>
+        <synopsis>
+          y = integrate(expr, v, x0, x1)
+          y = integrate(expr, v, x0, x1, atol)
+          y = integrate(expr, v, x0, x1, atol, rtol)
+        </synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Paramètres</title>
             <varlistentry>
                 <term>expr</term>
                 <listitem>
-                    <para>chaîne de caractères, définit l'expression scilab</para>
+                    chaîne de caractères : expression scilab fournissant l'intégrande.
+                    <para/>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>v</term>
                 <listitem>
-                    <para>chaîne de caractères, le nom de la variable
-                        d'intégration.
-                    </para>
+                    chaîne de caractères : nom de la variable d'intégration.
+                    <para/>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>x0</term>
                 <listitem>
-                    <para>nombre réel, la borne inférieure de l'intégration.</para>
+                    nombre réel, la borne inférieure de l'intégration.
+                    <para/>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>x1</term>
                 <listitem>
-                    <para>vecteur de nombres réels, les bornes supérieures
-                        d'intégration.
-                    </para>
+                    vecteur de nombres réels, les bornes supérieures d'intégration.
+                    <para/>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>atol</term>
                 <listitem>
-                    <para>nombre réel positif (borne sur l'erreur absolue) par défaut :
-                        1d-8
-                    </para>
+                    nombre réel positif: erreur absolue maximale acceptable. Par défaut : 1d-13
+                    <para/>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>rtol</term>
                 <listitem>
-                    <para>nombre réel positif (borne sur l'erreur relative) par défaut :
-                        1.d-14
-                    </para>
+                    nombre réel positif: erreur relative maximale acceptable. Par défaut : 1d-8
+                    <para/>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>x</term>
+                <term>y</term>
                 <listitem>
-                    <para>vecteur de nombres réels, la valeur de l'intégrale pour chaque
-                        <literal>x1(i)</literal>.
-                    </para>
+                    vecteur de nombres réels, la valeur de l'intégrale pour chaque
+                    <literal>x1(i)</literal>.
+                    <para/>
                 </listitem>
             </varlistentry>
         </variablelist>
     <refsection>
         <title>Description</title>
         <para>
-            calcule :
-            <subscript>
-                <inlinemediaobject>
-                    <imageobject>
-                        <imagedata>
-                            <mml:math display="block" scilab:localized="true">
-                                <mml:mi mathvariant="normal">x</mml:mi>
-                                <mml:mrow>
-                                    <mml:mrow>
-                                        <mml:mo>(</mml:mo><mml:mi mathvariant="normal">i</mml:mi><mml:mo>)</mml:mo>
-                                    </mml:mrow>
-                                    <mml:mo>=</mml:mo>
-                                    <mml:mrow>
-                                        <mml:msubsup>
-                                            <mml:mo>∫</mml:mo>
-                                            <mml:msub>
-                                                <mml:mi mathvariant="normal">x</mml:mi><mml:mn>0</mml:mn>
-                                            </mml:msub>
-                                            <mml:mrow>
-                                                <mml:msub>
-                                                    <mml:mi mathvariant="normal">x</mml:mi><mml:mn>1</mml:mn>
-                                                </mml:msub>
-                                                <mml:mrow>
-                                                    <mml:mo>(</mml:mo><mml:mi mathvariant="normal">i</mml:mi><mml:mo>)</mml:mo>
-                                                </mml:mrow>
-                                            </mml:mrow>
-                                        </mml:msubsup>
-                                        <mml:mi mathvariant="normal">f</mml:mi>
-                                    </mml:mrow>
-                                </mml:mrow>
-                                <mml:mrow>
-                                    <mml:mo>(</mml:mo><mml:mi mathvariant="normal">v</mml:mi><mml:mo>)</mml:mo>
-                                </mml:mrow>
-                                <mml:mi>d</mml:mi><mml:mi mathvariant="normal">v</mml:mi><mml:annotation mml:encoding="StarMath 5.0">x(i)=int_{x_0}^{x_1(i)}
-                                    f(v)dv
-                                </mml:annotation>
-                            </mml:math>
-                        </imagedata>
-                    </imageobject>
-                </inlinemediaobject>
-            </subscript>
-            pour
-            <literal>i=1:size(x1,'*')</literal>
+            calcule
+            <latex alt="y(i) = integral_{x_0}^{x_1(i)} f(v).dv">
+                y(i) = \int_{x_0}^{x_1(i)} f(v)\,dv
+            </latex>
+            pour <literal>i=1:size(x1,'*')</literal>,
+            où <emphasis>f(v)</emphasis> est donnée par l'expression <literal>expr</literal>.
         </para>
         <para>
-            où
-            <inlinemediaobject>
-                <imageobject>
-                    <imagedata>
-                        <mml:math display="block">
-                            <mml:mi mathvariant="normal">f</mml:mi><mml:mo>(</mml:mo><mml:mi mathvariant="normal">v</mml:mi><mml:mo>)</mml:mo>
-                        </mml:math>
-                    </imagedata>
-                </imageobject>
-            </inlinemediaobject>
-            est donnée par l'expression
-            <literal>expr</literal>
-        </para>
-        <para>L'approximation satisfait (on l'espère) l'affirmation suivante sur
-            l'erreur :
+            L'approximation satisfait (on l'espère) l'affirmation suivante sur l'erreur :
         </para>
         <para>
-            <literal>abs(I-x)&lt;= max(atol,rtol*abs(I))</literal>
+            <literal>abs(I-y) &lt;= max(atol, rtol*abs(I))</literal>
         </para>
         <para>
-            où <literal>I</literal> représente la valeur exacte de
-            l'intégrale.
+            où <literal>I</literal> représente la valeur exacte de l'intégrale.
         </para>
-    </refsection>
-    <refsection>
-        <title>Restriction</title>
-        <para>L'expression fournie ne doit pas référencer de variables dont le nom
-            commence avec un <literal>%</literal>.
+        <para>
+            <warning>
+                Restriction : l'expression fournie ne doit pas contenir de noms de variables
+                commençant par <literal>%</literal>.
+            </warning>
         </para>
     </refsection>
     <refsection>
         <title>Exemples</title>
         <programlisting role="example"><![CDATA[
-x0=0;x1=0:0.1:2*%pi;
-X=integrate('sin(x)','x',x0,x1);
-norm(cos(x1)-(1-X))
+x1 = 0:0.1:2*%pi;
+Y = integrate('sin(x)', 'x', 0, x1);
+norm(cos(x1)-(1-Y))
 
-x1=-10:0.1:10;
-X=integrate(['if x==0 then 1,';
-             'else sin(x)/x,end'],'x',0,x1)
+x1 = -10:0.1:10;
+Y = integrate(['if x==0 then 1,';
+               'else sin(x)/x,end'], 'x', 0, x1)
  ]]></programlisting>
     </refsection>
     <refsection role="see also">
@@ -186,4 +139,16 @@ X=integrate(['if x==0 then 1,';
             </member>
         </simplelist>
     </refsection>
+    <refsection role="history">
+        <title>Historique</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.1.0</revnumber>
+                <revdescription>
+                    Valeur par défaut de atol : 10<superscript>-13</superscript> (au lieu de
+                    10<superscript>-14</superscript>).
+                </revdescription>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>