<chapter id="using-kmplot">
<title
>Utilisation de &kmplot;</title>

<para
>&kmplot; travaille avec des fonctions nommées, qui peuvent être spécifiées en termes de coordonnées cartésiennes (appelées « fonctions explicites », coordonnées polaires ou fonctions paramétriques). Pour saisir une fonction, choisissez <menuchoice
><guimenu
>Tracer</guimenu
><guimenuitem
>Modifier les courbes...</guimenuitem
></menuchoice
>. Vous pouvez également saisir de nouvelles fonctions  dans la zone de texte <guilabel
>Équation de la fonction</guilabel
> dans la fenêtre principale de &kmplot; Cette zone de texte gère les fonctions explicites et les fonctions polaires. Chaque fonction que vous saisissez doit avoir un nom unique (&cad; un nom qui n'est pas pris par une autre fonction existante affichée dans la zone de liste). Un nom de fonction sera automatiquement généré si vous n'en spécifiez pas un.</para>

<para
>Pour plus d'informations sur les fonctions de &kmplot;, voyez le <xref linkend="reference"/>. </para>

<screenshot>
<screeninfo
>Voici une capture d'écran de l'écran d'accueil de &kmplot;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="main.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Capture d'écran</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<sect1 id="function-types">
<title
>Types de fonctions</title>

<sect2 id="explicit-functions">
<title
>Fonctions explicites</title>
<para
>Pour saisir une fonction explicite (&cad; une fonction de la forme y=f(x)) dans &kmplot;, saisissez-la simplement sous la forme suivante : <screen>
<userinput
><replaceable
>f</replaceable
>(<replaceable
>x</replaceable
>)=<replaceable
>expression</replaceable
></userinput>
</screen
> où : <itemizedlist>
<listitem
><para
><replaceable
>f</replaceable
> est le nom de la fonction, et peut être n'importe quelle chaîne de caractères et nombres que vous voulez, à condition qu'elle ne commence pas par les lettres x, y ou r (car elles sont utilisées pour les fonctions paramétriques et polaires).</para>
</listitem>

<listitem
><para
><replaceable
>x</replaceable
> est la coordonnée X, à utiliser dans l'expression suivant le signe égal. C'est en fait une variable simple, et ainsi, vous pouvez utiliser n'importe quel nom de variable, avec le même effet.</para>
</listitem>

<listitem>
<para
><replaceable
>expression</replaceable
> est l'expression à mettre en courbe, étant donnée une syntaxe appropriée pour &kmplot;. Voyez <xref linkend="math-syntax"/>. </para>
</listitem>

</itemizedlist>
</para>
<para
>Comme exemple, pour dessiner la courbe de y=x<superscript
>2</superscript
>+2x, saisissez la formule suivant dans la boîte de dialogue des fonctions de &kmplot; : <screen
>f(x)=x^2+2x
</screen>
</para>
</sect2>

<sect2 id="parametric-functions">
<title
>Fonctions paramétriques</title>
<para
>Les fonctions paramétriques sont celles dans lesquelles les coordonnées x et y sont définies par des fonctions séparées dépendant d'autres variables, souvent t. Pour saisir une fonction paramétrique dans &kmplot;, suivez la procédure comme pour une fonction explicite, mais préfixez le nom de la fonctions décrivant la coordonnée x par la lettre x, et la fonction décrivant la coordonnée y par la lettre y. Comme pour les fonctions explicites, vous pouvez utiliser n'importe quel nom de variable pour le paramètre. Pour tracer une fonction paramétrique, vous devez aller dans le menu <guimenu
>Tracer</guimenu
><guimenuitem
>Nouvelle courbe paramétrique...</guimenuitem
>. Un nom de fonction sera créé automatiquement si vous n'en spécifiez pas un.</para>
<para
>À titre d'exemple, supposez que vous voulez tracer un cercle, qui a les équations paramétriques x=sin(t), y=cos(t). Dans la boîte de dialogue de fonctions de &kmplot;, faites ceci : <orderedlist
> <listitem
><para
>Ouvrez la boîte de dialogue des fonctions paramétriques avec  <menuchoice
><guimenu
>Tracer</guimenu
><guimenuitem
>Nouvelle courbe paramétrique...</guimenuitem
> </menuchoice
>.</para
> </listitem
> <listitem
><para
>Saisissez un nom pour la fonction, disons <userinput
>cercle</userinput
> dans la zone de texte <guilabel
>Nom</guilabel
>. Les noms des fonctions x et y changent pour refléter ce changement : la fonction x devient <guilabel
>xcercle(t)</guilabel
> et la fonction y  devient <guilabel
>ycercle(t)</guilabel
>.</para
> </listitem
> <listitem
> <para
>Dans les zones de texte x et y, saisissez les équations appropriées, &cad; <guilabel
>xcircle(t)=</guilabel
><userinput
>sin(t)</userinput
> et <guilabel
>ycircle(t)=</guilabel
><userinput
>cos(t)</userinput
>.</para
> </listitem
> </orderedlist
> Cliquez sur <guibutton
>OK</guibutton
> et la fonction sera tracée. </para>
<para
>Vous pouvez spécifier d'autres options pour le tracé dans cette boîte de dialogue : <variablelist>

<varlistentry>
<term
><guilabel
>Masquer</guilabel
></term>
<listitem>
<para
>Si cette option est sélectionnée, le tracé n'est pas affiché, mais &kmplot; se souvient de la définition de la fonction, donc vous pouvez l'utiliser pour définir d'autres fonctions.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Plage de minima de courbe personnalisée</guilabel
></term>
<term
><guilabel
>Plage de maxima de courbe personnalisée</guilabel
></term>
<listitem>
<para
>Si ces options sont sélectionnées, vous pouvez changer les valeurs minimale et maximale du paramètre t pour lequel la fonction est tracée, en utilisant les zones de texte <guilabel
>min</guilabel
> et <guilabel
>max</guilabel
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Épaisseur de ligne :</guilabel
></term>
<listitem>
<para
>Avec cette option, vous pouvez régler l'épaisseur de la ligne du tracé, en multiples de 0.1 mm.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Couleur :</guilabel
></term>
<listitem>
<para
>Cliquez sur la boîte de couleur et choisissez une couleur dans la boîte de dialogue qui apparaît. Le tracé sera dessiné avec cette couleur.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2 id="polar-functions">
<title
>Entrée de fonctions en coordonnées polaires</title>

<para
>Les coordonnées polaires représentent un point par sa distance par rapport à l'origine (habituellement appelée r), et l'angle que fait une ligne reliant l'origine à ce point avec l'axe des x (généralement représenté par la lettre grecque theta). Pour saisir des fonctions en coordonnées polaires, utilisez l'entrée de menu <menuchoice
><guimenu
>Tracer</guimenu
><guimenuitem
>Nouvelle courbe polaire...</guimenuitem
> </menuchoice
>. Dans la boîte étiquetée <guilabel
>r</guilabel
>, complétez la définition de la fonction, y compris le nom de la variable theta que vous souhaitez utiliser. Par exemple, pour tracer la spirale d'Archimère r=theta, saisissez : <screen>
<userinput>
(theta)=theta
</userinput>
</screen
>  afin que la ligne complète soit « r(theta)=theta ». Notez que vous pouvez utiliser n'importe quel nom pour la variable theta, ainsi « r(toto)=toto » produirait le même résultat. </para>

</sect2>

</sect1>

<sect1 id="combining-functions">
<title
>Combinaisons de fonctions</title>
<para
>Les fonctions peuvent être combinées pour en produire de nouvelles. Saisissez simplement les fonctions après le signe égal dans une expression comme si les fonctions étaient des variables. Par exemple, si vous avez défini les fonctions f(x) et g(x), vous pouvez faire la courbe de la somme de f et de g avec : <screen
><userinput>
sum(x)=f(x)+g(x)
</userinput
>
</screen>
</para>
<para
>Notez que vous ne pouvez que combiner des fonctions du même type, &pex; une fonction explicite ne peut pas être combinée avec une fonction polaire.</para>
</sect1>

<sect1 id="function-appearance">
<title
>Changer l'apparence des fonctions</title>

<para
>Pour changer l'apparence du tracé d'une fonction sur la fenêtre de courbe principale, sélectionnez la fonction dans la boîte de dialogue<guilabel
>Modifier les tracés</guilabel
>, et cliquez sur le bouton <guibutton
>Modifier...</guibutton
>. Dans la boîte de dialogue qui apparaît, vous pouvez changer l'épaisseur du trait dans la zone de texte, et la couleur du graphe de la fonction en cliquant sur le bouton de couleur à droite. Si vous modifiez une fonction explicite, vous verrez une boîte de dialogue avec trois onglets. Dans le premier, vous spécifiez l'équation de la fonction. L'onglet <guilabel
>Dérivées</guilabel
> vous permet de tracer la dérivée première et seconde de la fonction. Avec l'onglet <guilabel
>Primitive</guilabel
>, vous pouvez tracer l'intégrale de la fonction, calculée par la méthode d'Euler. </para>
<para
>Une autre façon de modifier une fonction est de cliquer avec le bouton droit de la souris sur le tracé. Un menu surgissant apparaît, choisissez <guibutton
>Modifier</guibutton
></para>

<para
>Pour plus d'informations sur le menu surgissant, consultez la section <xref linkend="popupmenu"/>. </para>
</sect1>

<sect1 id="popupmenu">
<title
>Menu surgissant</title>

<para
>Lorsque vous cliquez avec le bouton droit de la souris sur un tracé ou sur une fonction paramétrique à un point, un menu surgissant apparaît. Cinq élément sont disponibles :</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Masquer</guimenuitem>
</menuchoice
></term>
<listitem>
<para
>Cache la courbe sélectionnée. Les autres tracés du graphique seront toujours affichés.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Supprimer</guimenuitem>
</menuchoice
></term>
<listitem>
<para
>Supprime la fonction. Tous cestracés disparaîtront.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Modifier</guimenuitem>
</menuchoice
></term>
<listitem>
<para
>Affiche la boîte de dialogue de modification de la fonction sélectionnée.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Copier</guimenuitem>
</menuchoice
></term>
<listitem>
<para
>Copie la courbe dans une autre instance de &kmplot;</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Déplacer</guimenuitem>
</menuchoice
></term>
<listitem>
<para
>Déplace la courbe dans une autre instance de &kmplot;</para>
</listitem>
</varlistentry>
</variablelist>

<para
>Pour les courbes fonctions, les quatre éléments suivants sont également disponibles :</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Obtenir l'ordonnée</guimenuitem>
</menuchoice
></term>
<listitem>
<para
>Ouvre une boîte de dialogue dans laquelle vous pouvez trouver l'ordonnée correspondante à une abscisse spécifique. La courbe sélectionnée sera mise en surbrillance dans la boîte de dialogue. Saisissez une valeur de l'abscisse dans la zone de texte <guilabel
>X :</guilabel
>, et actionnez le bouton <guibutton
>Calculer</guibutton
> (ou appuyez sur &Enter;). La valeur de l'ordonnée correspondante sera affichée dans <guilabel
>Y :</guilabel
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Chercher le minimum</guimenuitem>
</menuchoice
></term>
<listitem>
<para
>Trouve la valeur minimale de la courbe dans une plage spécifiée. La courbe sélectionnée sera mise en surbrillance dans la boîte de dialogue qui apparaît. Saisissez les limites supérieure et inférieure de la région dans laquelle vous voulez chercher le minimum, et actionner le bouton <guibutton
>Chercher</guibutton
>. Les valeurs de l'abscisse et de l'ordonnée au minimum seront affichées.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Chercher le maximum</guimenuitem>
</menuchoice
></term>
<listitem>
<para
>C'est la même chose que <guimenuitem
>Chercher le minimum</guimenuitem
>, mais cette fois la valeur maximale est recherchée au lieu du minimum. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Calculer l'intégrale</guimenuitem>
</menuchoice
></term>
<listitem>
<para
>Sélectionne les abscisses pour la courbe dans la nouvelle boîte de dialogue qui apparaît. Calcule l'intégrale et dessine la surface entre la courbe et l'axe des abscisses dans la plage dans la couleur de la courbe.</para>
</listitem>
</varlistentry>
</variablelist>


</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:
-->
