<chapter id="reference">
<title
>Références de &kmplot;</title>

<!--
<mediaobject>
<imageobject>
<imagedata fileref="kfkt.png" format="PNG"/>
</imageobject>
</mediaobject>

<para
>This menu entry or toolbar button opens the Functions Editor.  Here
you can enter up to 10 functions or
function groups.  The parser knows <firstterm
>explicit</firstterm
> and
<firstterm
>parametric</firstterm
> form.  With specific extensions it
is possible to add first and second derivatives and to choose values
for the function group parameter.</para>
-->

<sect1 id="func-syntax">
<title
>Syntaxe des fonctions</title>

<para
>La syntaxe doit être se conformer à :</para>

<screen
><userinput
>nom(var1[, var2])=term [;extensions]</userinput
>
</screen>


<variablelist>
<varlistentry>
<term
>nom</term>
<listitem>

<para
>Le nom de la fonction. Si le premier caractère est « r », l'analyseur suppose que vous utilisez des coordonnées polaires. Si le premier caractère est « x » (par exemple « xfonc »), l'analyseur attend une deuxième fonction avec pour commencer « y » (ici, « yfonc ») pour définir la fonction sous forme paramétrique. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
>var1</term>
<listitem
><para
>La variable de la fonction</para
></listitem>
</varlistentry>
<varlistentry>
<term
>var2</term
> 
<listitem
><para
>Le « paramètre de groupe » de la fonction. Il doit être séparé de la variable de la fonction par une virgule. Vous pouvez utiliser le paramètre de groupe pour, par exemple, mettre en courbe plusieurs graphes d'une fonction. Les valeurs des paramètres peuvent être sélectionnées manuellement, ou vous pouvez choisir d'avoir une glissière qui contrôle un paramètre. En modifiant la valeur de la glissière, la valeur du paramètre sera modifiée également. La glissière peut être réglée sur un entier contenu entre 0 et 100.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>term</term>
<listitem
><para
>L'expression définissant la fonction</para
></listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="func-predefined">
<title
>Noms de fonctions prédéfinies et constantes</title>

<para
>Toutes les fonctions prédéfinies et les constantes que &kmplot; connaît peuvent être affichées en sélectionnant <menuchoice
><guimenu
>Aide</guimenu
><guimenuitem
>Fonctions mathématiques prédéfinies</guimenuitem
> </menuchoice
>. Ce sont : <variablelist>

<varlistentry>
<term
>sqr, sqrt</term>
<listitem>
<para
>Retourne respectivement le carré et la racine carrée d'un nombre.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>exp, ln</term>
<listitem>
<para
>Retourne respectivement l'exponentielle et le logarithme naturel d'un nombre.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>log</term>
<listitem>
<para
>Retourne le logarithme en base 10 d'un nombre.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>sin, arcsin</term>
<listitem>
<para
>Retourne respectivement le sinus et le sinus inverse d'un nombre. Notez que l'argument de sinus et la valeur retournée d'arcsinus sont en radians.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>cos, arccos</term>
<listitem>
<para
>Retourne respectivement le cosinus et le cosinus inverse d'un nombre. Aussi en radians.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>tan, arctan</term>
<listitem>
<para
>Retourne respectivement la tangente et la tangente inverse d'un nombre. Aussi en radians.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>sinh, arcsinh</term>
<listitem>
<para
>Retourne respectivement le sinus hyperbolique et le sinus hyperbolique inverse d'un nombre.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>cosh, arccosh</term>
<listitem>
<para
>Retourne respectivement le cosinus hyperbolique et le cosinus hyperbolique inverse d'un nombre.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>tanh, arctanh</term>
<listitem>
<para
>Retourne respectivement la tangente hyperbolique et la tangente hyperbolique inverse d'un nombre.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>sin, arcsin</term>
<listitem>
<para
>Retourne respectivement le sinus et le sinus inverse d'un nombre. Notez que l'argument de sinus et la valeur retournée d'arcsinus sont en radians.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>cos, arccos</term>
<listitem>
<para
>Retourne respectivement le cosinus et le cosinus inverse d'un nombre. Aussi en radians.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>pi, e</term>
<listitem>
<para
>Des constantes représentant respectivement &pgr; (3,14159...) et e (2,71828...).</para>
</listitem>
</varlistentry>

</variablelist>
</para>

<para
>Ces fonctions et constantes et même toutes les fonctions définies par l'utilisateur peuvent aussi bien être utilisées pour déterminer les réglages d'axes. Voyez <xref linkend="axes-config"/>. </para>

</sect1>

<sect1 id="func-extension">
  <title
>Extensions</title>
  <para
>Une extension pour une fonction est spécifiée en saisissant un point-virgule, suivi de l'extension, après la définition de la fonction. L'extension peut soit être écrite dans le champ de saisie rapide ou en utilisant la méthode &DCOP; Parser addFunction. Aucune extensions ne sont disponibles pour les fonctions paramétriques mais N et D[a,b] fonctionnent aussi pour les fonctions polaires. Par exemple : <screen>
      <userinput>
        f(x)=x^2; A1
      </userinput>
    </screen
> va afficher le graphe y=x<superscript
>2</superscript
> avec sa dérivée première. Les extensions supportées sont décrites ci-dessous : <variablelist>
      <varlistentry>
	<term
>N</term>
	<listitem>
	  <para
>La fonction sera enregistrée mais non tracée. Elle pourra être utilisée comme toute autre fonction définie par l'utilisateur ou toute autre fonction prédéfinie. </para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term
>A1</term>
	<listitem>
	  <para
>La courbe de la dérivée de la fonction sera tracée en plus de la même couleur mais avec une épaisseur de trait plus fine. </para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term
>A2</term>
	<listitem>
	  <para
>La courbe de la dérivée seconde de la fonction sera tracée en plus de la même couleur mais avec une épaisseur de trait plus fine. </para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term
>D[a,b]</term>
	<listitem>
	  <para
>Fixe le domaine sur lequel la fonction sera affichée. </para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term
>P[a{,b...}]</term>
	<listitem>
	  <para
>Donne à un ensemble de valeurs un paramètre de groupe sur lequel la fonction sera affichée. Par exemple : <userinput
>f(x,k)=k*x;P[1,2,3]</userinput
> va tracer les fonctions f(x)=x, f(x)=2*x and f(x)=3*x. Vous pouvez aussi utiliser des fonctions comme arguments de l'option P. </para>
	</listitem>
      </varlistentry>
    </variablelist>
  </para>
  <para
>Veuillez noter que vous pouvez aussi effectuer toutes ces opérations en utilisant la boîte de dialogue d'édition de fonctions.  </para>
</sect1>

<sect1 id="math-syntax">
<title
>Syntaxe mathématique</title>
<para
>&kmplot; utilise une manière commune d'exprimer les fonctions mathématiques, et ainsi, vous ne devriez pas avoir de difficulté à travailler avec. Les opérateurs que &kmplot; comprend sont, en ordre décroissant de priorité : <variablelist>

<varlistentry>
<term
>^</term>
<listitem
><para
>Le symbole « caret » fournit la puissance. &pex; <userinput
>2^4</userinput
> retourne 16.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>*, /</term>
<listitem>
<para
>Les symboles astérisque et barre de fraction fournissent la multiplication et la division. &pex; <userinput
>3*4/2</userinput
> retourne 6.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>+, -</term>
<listitem
><para
>Les symboles plus et le moins font l'addition et la soustraction. &pex; <userinput
>1+3-2</userinput
> retourne 2.</para>
</listitem>
</varlistentry>

</variablelist>
</para>
<para
>Notez la priorité, qui signifie que si les parenthèses ne sont pas utilisées, la puissance sera effectuée avant la multiplication / division, qui sera effectuée avant l'addition / soustraction. ainsi, <userinput
>1+2*4^2</userinput
> retourne 33 et pas, disons, 144. Pour supplanter ceci, utilisez des parenthèses. Pour utiliser l'exemple ci-dessus, <userinput
>((1+2)*4)^2</userinput
> <emphasis
>renverra</emphasis
> 144. </para>
</sect1>

<!--
<sect1 id="coord-system">
<title
>Coordinate Systems</title>

<para
><inlinemediaobject>
<imageobject>
<imagedata fileref="ksys1.png" format="PNG"/>
</imageobject>
</inlinemediaobject
></para>

<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="ksys2.png" format="PNG"/>
</imageobject>
</inlinemediaobject
></para>

<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="ksys3.png" format="PNG"/>
</imageobject>
</inlinemediaobject
></para>
-->
<sect1 id="coord-area"
><title
>Zone de courbe</title>
<para
>Par défaut, les fonctions explicitement données sont mises en courbe pour la totalité de la partie visible de l'axe des abscisses. Vous pouvez spécifier une autre plage dans la boîte de dialogue d'édition de la fonction. Pour chaque point sur l'axe des abscisses, &kmplot; calcule une valeur de la fonction. Si la zone de courbe contient le point résultant, il est connecté au dernier point dessiné par une ligne. </para>
<para
>Les fonctions paramétriques sont mises en courbe pour les valeurs du paramètre de 0 à 2&pgr;. Vous pouvez définir la plage de tracé pour la fonction dans la boîte de dialogue également. </para>
</sect1>

<sect1 id="coord-cross">
<title
>Curseur en croix</title>
<para
>Pendant que le pointeur de la souris est au-dessus de la zone de courbe, le pointeur change en croix. Les coordonnées courantes peuvent se voir aux intersections avec les axes de coordonnées et aussi dans la barre d'état en bas de la fenêtre principale. </para>
<para
>Vous pouvez tracer les valeurs d'une fonction plus précisément en cliquant sur ou à côté d'un graphique. La fonction sélectionnée est affichée dans la barre d'état dans la colonne de droite. La croix sera alors capturée et colorée avec la même couleur que le tracé. Si le tracé est de la même couleur que l'arrière plan, la croix sera en couleurs inversées. Lorsque vous déplacez la souris ou appuyez sur les touches gauche et droite, la croix suivra la fonction et vous verrez les abscisses et ordonnées actuelles. Si la croix est proche de l'axe des ordonnées, la valeur de la racine est affichée dans la barre d'état. Vous pouvez basculer d'une fonction à l'autre avec les touches haut et bas. Un second clic n'importe où dans la fenêtre ou un appui sur n'importe quelle touche autre que les touches de navigation fera quitter ce mode de tracé. </para>
<para
>Notez que le traçage n'est possible qu'avec des fonctions explicitement données. Les coordonnées sont toujours affichées en fonction d'un système cartésien de coordonnées. Ni les fonctions paramétriques possédant plusieurs ordonnées pour une abscisse, ni les fonctions données en coordonnées polaires ne peuvent être tracées de cette manière. </para>

</sect1>

</chapter>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
sgml-parent-document:("index.docbook" "BOOK" "CHAPTER")
End:
-->
