<chapter id="reference">
<title
>Guida di riferimento a &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
>Sintassi funzioni</title>

<para
>È necessario rispettare alcune regole di sintassi:</para>

<screen
><userinput
>nome(var1[, var2])=termine [;estensioni]</userinput
>
</screen>


<variablelist>
<varlistentry>
<term
>nome</term>
<listitem>

<para
>Il nome della funzione. Se il primo carattere è <quote
>r</quote
>, l'interprete assume che tu stia usando coordinate polari. Se il primo carattere è <quote
>x</quote
> (per esempio <quote
>xfunz</quote
>) il parser si aspetta una seconda funzione il cui nome inizi per <quote
>y</quote
> (in questo caso <quote
>yfunz</quote
>) per definire una funzione in forma parametrica. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
>var1</term>
<listitem
><para
>La variabile della funzione</para
></listitem>
</varlistentry>
<varlistentry>
<term
>var2</term
> 
<listitem
><para
>Il <quote
>parametro di gruppo</quote
> della funzione. Deve esserci una virgola a separarlo dal nome della funzione. Puoi usare il parametro di gruppo, ad esempio, per tracciare un certo numero di grafici da una funzione. Vedi l'opzione P sotto <xref linkend="func-extension"/>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>termine</term>
<listitem
><para
>L'espressione che definisce la funzione.</para
></listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="func-predefined">
<title
>Nomi di funzione e costanti predefinite</title>

<para
>È possibile visualizzare tutte le funzioni predefinite e le costanti note a &kmplot; selezionando <menuchoice
><guimenu
>Aiuto</guimenu
><guimenuitem
>Nomi</guimenuitem
> </menuchoice
>. Si tratta di: <variablelist>

<varlistentry>
<term
>sqr, sqrt</term>
<listitem>
<para
>Restituiscono rispettivamente il quadrato e la radice quadrata di un numero.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>exp, ln</term>
<listitem>
<para
>Restituiscono rispettivamente l'esponenziale e il logaritmo naturale di un numero.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>log</term>
<listitem>
<para
>Restituisce il logaritmo in base 10 di un numero.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>sin, arcsin</term>
<listitem>
<para
>Restituiscono rispettivamente il seno e l'arcoseno di un numero. Nota che l'argomento di sin e il valore restituito da arcsin sono in radianti.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>cos, arccos</term>
<listitem>
<para
>Restituiscono rispettivamente il coseno e l'arcocoseno di un numero. Sempre in radianti.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>tan, arctan</term>
<listitem>
<para
>Restituiscono rispettivamente la tangente e l'arcotangente di un numero. Sempre in radianti.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>sinh, arcsinh</term>
<listitem>
<para
>Restituiscono rispettivamente il seno iperbolico e l'arcoseno iperbolico di un numero.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>cosh, arccosh</term>
<listitem>
<para
>Restituiscono rispettivamente il coseno iperbolico e l'arcocoseno iperbolico di un numero.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>tanh, arctanh</term>
<listitem>
<para
>Restituiscono rispettivamente la tangente iperbolica e l'arcotangente iperbolica di un numero.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>sin, arcsin</term>
<listitem>
<para
>Restituiscono rispettivamente il seno e l'arcoseno di un numero. Nota che l'argomento di sin e il valore restituito da arcsin sono in radianti.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>cos, arccos</term>
<listitem>
<para
>Restituiscono rispettivamente il coseno e l'arcocoseno di un numero. Sempre in radianti.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>pi, e</term>
<listitem>
<para
>Costanti che rappresentano rispettivamente &pgr; (3,14159...) ed e (2,71828...).</para>
</listitem>
</varlistentry>

</variablelist>
</para>

<para
>Queste funzioni e costanti, e anche tutte le funzioni definite dall'utente, sono utilizzabili anche per determinare le impostazioni degli assi. Vedi <xref linkend="the-axes-tab"/>. </para>

</sect1>

<sect1 id="func-extension">
<title
>Estensioni</title>
<para
>Un'estensione di una funzione si può specificare inserendo un punto e virgola, seguito dall'estensione stessa, dopo la definizione della funzione. Per esempio: <screen>
<userinput>
f(x)=x^2; A1
</userinput>
</screen
> visualizzerà il grafico di y=x<superscript
>2</superscript
> assieme a quello della sua derivata prima. Le estensioni supportate sono descritte di seguito: <variablelist>
<varlistentry>
<term
>N</term>
<listitem>
<para
>La funzione sarà memorizzata ma non visualizzata. In tal modo la si potrà usare come ogni altra funzione predefinita o definita dall'utente. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
>A1</term>
<listitem>
<para
>Sarà tracciato anche il grafico della derivata prima della funzione, con una linea dello stesso colore ma più sottile. Questa estensione non ha effetto sulle funzioni definite in forma parametrica. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
>A2</term>
<listitem>
<para
>Sarà tracciato anche il grafico della derivata seconda della funzione, con una linea dello stesso colore ma più sottile. Questa estensione non ha effetto sulle funzioni definite in forma parametrica. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
>D[a,b]</term>
<listitem>
<para
>Imposta l'intervallo entro il quale tracciare la funzione. Per le funzioni parametriche si tratta dell'intervallo di valori del parametro, ed è necessario specificarlo soltanto per la funzione x. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
>P[a{,b...}]</term>
<listitem>
<para
>Fornisce una serie di valori di un parametro di gruppo per i quali la funzione va visualizzata. Per esempio, <userinput
>f(x,k)=k*x;P[1,2,3]</userinput
> traccerà le funzioni f(x)=x, f(x)=2*x e f(x)=3*x. Puoi anche utilizzare funzioni come argomenti dell'opzione P. </para>
</listitem>
</varlistentry>
</variablelist>
</para>

</sect1>


<sect1 id="math-syntax">
<title
>Sintassi matematica</title>
<para
>&kmplot; utilizza convenzioni ben note per esprimere le funzioni matematiche, per cui non dovrebbero essere fonte di problemi. Gli operatori noti a &kmplot; sono, in ordine decrescente di precedenza: <variablelist>

<varlistentry>
<term
>^</term>
<listitem
><para
>L'apice esegue l'elevamento a potenza. &eg;, <userinput
>2^4</userinput
> ha come risultato 16.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>*, /</term>
<listitem>
<para
>L'asterisco e la barra eseguono la moltiplicazione e la divisione. &eg;, <userinput
>3*4/2</userinput
> ha come risultato 6.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>+, -</term>
<listitem
><para
>Il più e il meno eseguono l'addizione e la sottrazione.&eg;, <userinput
>1+3-2</userinput
> ha come risultato 2.</para>
</listitem>
</varlistentry>

</variablelist>
</para>
<para
>Nota la precedenza: se non ci sono parentesi, l'elevamento a potenza è eseguito prima della moltiplicazione/divisione, che a loro volta precedono l'addizione/sottrazione. Perciò <userinput
>1+2*4^2</userinput
> vale 33, e non, per esempio, 144. Per modificare l'ordine delle operazioni, utilizza le parentesi. Tornando all'esempio di prima, <userinput
>((1+2)*4)^2</userinput
> vale proprio 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
>Area del grafico</title>
<para
>L'impostazione predefinita è che le funzioni definite esplicitamente siano tracciate lungo tutta la parte visibile dell'asse x (vedi <xref linkend="func-extension"/> per modificare questo comportamento per singole funzioni). Per ogni pixel sull'asse delle ascisse, &kmplot; calcola il valore della funzione. Se il punto risultante si trova all'interno dell'area del grafico, sarà unito con una linea al punto precedente. </para>
<para
>Le funzioni parametriche sono tracciate per valori del parametro da 0 a 2&pgr;. Questo intervallo si può anche impostare tramite l'estensione D (vedi <xref linkend="func-extension"/>). </para>
</sect1>

<sect1 id="coord-cross">
<title
>Puntatore a croce</title>
<para
>Quando il puntatore del mouse si trova all'interno dell'area del grafico, diventa a forma di croce. Le coordinate correnti sono visibili all'intersezione con gli assi, e anche nella barra di stato ai piedi della finestra principale. </para>
<para
>Puoi seguire con maggiore precisione il valore di una funzione facendo clic sul suo grafico o nelle vicinanze. Il puntatore del mouse sarà catturato e diventerà dello stesso colore del grafico. Un secondo clic su un punto qualsiasi provocherà l'uscita da questa modalità. </para>
<para
>Nota che questa modalità è disponibile soltanto con funzioni esplicite. Le coordinate sono sempre riferite a un sistema cartesiano. Non è possibile tracciare in questo modo né le funzioni parametriche, né le funzioni definite in coordinate polari, né le derivate. </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:
-->
