<chapter id="reference">
<title
>Referència 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
>Sintaxi de la funció</title>
	
	<para
>S'hauran de complir algunes regles de la sintaxi:</para>
	
	<screen
><userinput
>nom(var1[, var2])=terme [;extensions]</userinput
>
        </screen>
	
	
	<variablelist>
		<varlistentry>
			<term
>nom</term>
			<listitem>
				
				<para
>El nom de la funció. Si el primer caràcter és <quote
>r</quote
> l'analitzador assumirà que esteu utilitzant coordenades polars. Si el primer caràcter és <quote
>x</quote
> (per exemple <quote
>xfunc</quote
>) que l'analitzador esperarà una segona funció amb un líder <quote
>y</quote
> (aquí <quote
>yfunc</quote
>) per definir la funció en forma paramètrica. </para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>var1</term>
			<listitem
><para
>La variable de la funció.</para
></listitem>
		</varlistentry>
		<varlistentry>
			<term
>var2</term
> 
			<listitem
><para
>La funció <quote
>paràmetre de grup</quote
>. Hi ha d'haver una coma per separar-lo de la variable de la funció. Podeu utilitzar el paràmetre de grup per a, per exemple, representar un nombre de grafs des d'una funció. Els valors del paràmetre es poden seleccionar manualment o podeu optar per tenir un control lliscant que controli un paràmetre. En canviar el valor del control lliscant es canviarà el valor del paràmetre. El control lliscant es pot establir a un enter entre 0 i 100.</para
></listitem>
		</varlistentry>
		<varlistentry>
			<term
>terme</term>
			<listitem
><para
>L'expressió que defineix la funció.</para
></listitem>
		</varlistentry>
	</variablelist>
</sect1>

<sect1 id="func-predefined">
	<title
>Noms de les funcions i constants predefinides</title>
	
	<para
>Es poden mostrar totes les funcions predefinides i constants que coneix &kmplot; seleccionant <menuchoice
><guimenu
>Ajuda</guimenu
><guimenuitem
>Funcions matemàtiques predefinides</guimenuitem
> </menuchoice
>, el qual mostrarà aquesta pàgina del manual de &kmplot;. </para>
	
	<para
>Aquestes funcions i constants, i fins i tot totes les funcions definides per l'usuari es poden utilitzar per determinar l'ajustament dels eixos. Veure <xref linkend="axes-config"/>. </para>
	
	<sect2 id="trigonometric-functions">
		<title
>Funcions trigonomètriques</title>
		
		<para
>Per omissió, les funcions trigonomètriques es calculen en radiants. No obstant, això es pot canviar mitjançant <menuchoice
><guimenu
>Arranjament</guimenu
><guimenuitem
>Configura &kmplot;</guimenuitem
></menuchoice
>. </para>
		
		<variablelist>
			
			<varlistentry>
				<term
>sin(x)</term>
				<term
>arcsin(x)</term>
				<term
>cosec(x)</term>
				<term
>arccosec(x)</term>
				<listitem
><para
>El sinus, el sinus invers, cosecant i cosecant invers respectivament.</para
></listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>cos(x)</term>
				<term
>arccos(x)</term>
				<term
>sec(x)</term>
				<term
>arcsec(x)</term>
				<listitem
><para
>El cosinus, cosinus invers, secant i secant invers respectivament.</para
></listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>tan(x)</term>
				<term
>arctan(x)</term>
				<term
>cot(x)</term>
				<term
>arccot(x)</term>
				<listitem
><para
>La tangent, tangent inversa, cotangent i cotangent inversa respectivament.</para
></listitem>
			</varlistentry>
			
		</variablelist>
	</sect2>
	
	<sect2 id="hyperbolic-functions">
		<title
>Funcions hiperbòliques</title>
		<para
>Les funcions hiperbòliques.</para>
		
		<variablelist>
			
			<varlistentry>
				<term
>sinh(x)</term>
				<term
>arcsinh(x)</term>
				<term
>cosech(x)</term>
				<term
>arccosech(x)</term>
				<listitem
><para
>El sinus hiperbòlic, sinus invers, cosecant i cosecant invers respectivament.</para
></listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>cosh(x)</term>
				<term
>arccosh(x)</term>
				<term
>sech(x)</term>
				<term
>arcsech(x)</term>
				<listitem
><para
>El cosinus hiperbòlic, cosinus invers, secant i secant invers respectivament.</para
></listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>tanh(x)</term>
				<term
>arctanh(x)</term>
				<term
>coth(x)</term>
				<term
>arccoth(x)</term>
				<listitem
><para
>La tangent hiperbòlica, tangent inversa, cotangent i cotangent inversa respectivament.</para
></listitem>
			</varlistentry>
			
		</variablelist>
	</sect2>
	
	<sect2 id="other-functions">
		<title
>Altres funcions</title>
		<variablelist>
			
			<varlistentry>
				<term
>sqr(x)</term>
				<listitem
><para
>L'arrel quadrada x^2 de «x».</para
></listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>sqrt(x)</term>
				<listitem
><para
>L'arrel quadrada de «x».</para
></listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>sign(x)</term>
				<listitem
><para
>El signe de «x». Retorna 1 si «x» és positiu, 0 si «x» és zero, o &minus;1 si «x» és negatiu.</para
></listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>H(x)</term>
				<listitem
><para
>La funció de pas de Heaviside. Retorna 1 si «x» és positiu, 0,5 si «x» és igual que zero, o 0 si «x» és negatiu.</para
></listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>exp(x)</term>
				<listitem
><para
>L'exponent e^x de «x».</para
></listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>ln(x)</term>
				<listitem
><para
>El logaritme natural (exponent invers) de «x».</para
></listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>log(x)</term>
				<listitem
><para
>El logaritme de «x» en base 10.</para
></listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>abs(x)</term>
				<listitem
><para
>El valor absolut de «x».</para
></listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>floor(x)</term>
				<listitem
><para
>Arrodoneix «x» a l'enter més proper inferior o igual que «x».</para
></listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>ceil(x)</term>
				<listitem
><para
>Arrodoneix «x» a l'enter més proper major o igual que «x».</para
></listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>round(x)</term>
				<listitem
><para
>Arrodoneix «x» a l'enter més proper.</para
></listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>gamma(x)</term>
				<listitem
><para
>La funció gamma.</para
></listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>factorial(x)</term>
				<listitem
><para
>El factorial de «x».</para
></listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>min(x<subscript
>1</subscript
>,x<subscript
>2</subscript
>,...,x<subscript
>n</subscript
>)</term>
				<listitem
><para
>Retorna el mínim del conjunt de números {x<subscript
>1</subscript
>,x<subscript
>2</subscript
>,...,x<subscript
>n</subscript
>}.</para
></listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>max(x<subscript
>1</subscript
>,x<subscript
>2</subscript
>,...,x<subscript
>n</subscript
>)</term>
				<listitem
><para
>Retorna el màxim del conjunt de números {x<subscript
>1</subscript
>,x<subscript
>2</subscript
>,...,x<subscript
>n</subscript
>}.</para
></listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>mod(x<subscript
>1</subscript
>,x<subscript
>2</subscript
>,...,x<subscript
>n</subscript
>)</term>
				<listitem
><para
>Retorna el mòdul (longitud euclidiana) del conjunt de números {x<subscript
>1</subscript
>,x<subscript
>2</subscript
>,...,x<subscript
>n</subscript
>}.</para
></listitem>
			</varlistentry>
			
			<!-- TODO: Legendre polynomials -->
			
		</variablelist>
	</sect2>
	
	<sect2>
		<title
>Constants predefinides</title>
		<variablelist>
			
			<varlistentry>
				<term
>pi</term>
				<term
>&pgr;</term>
				<listitem>
					<para
>Constants que representen &pgr; (3.14159...).</para>
				</listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>e</term>
				<listitem>
					<para
>Constant que representa el nombre d'Euler «e» (2.71828...).</para>
				</listitem>
			</varlistentry>
			
		</variablelist>
	</sect2>
</sect1>

<sect1 id="func-extension">
	<title
>Extensions</title>
	<para
>Una extensió per a una funció s'especifica introduint un punt i coma, seguit de l'extensió, després de la definició de la funció. L'extensió es pot escriure utilitzant el mètode «parser addFunction» de &DBus;. Cap de les extensions estaran disponibles per a les funcions paramètriques, però N i D[a,b] funcionen també per a les funcions polars. Per exemple:<screen>
            <userinput>
                f(x)=x^2; A1
            </userinput>
        </screen
> mostrarà el graf de y=x<superscript
>2</superscript
> amb la seva primera derivada. Les extensions suportades es descriuen a continuació: <variablelist>
			<varlistentry>
				<term
>N</term>
				<listitem>
					<para
>La funció s'emmagatzemarà però no serà dibuixada. Es pot utilitzar com qualsevol altra funció definida per l'usuari o predefinida. </para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term
>A1</term>
				<listitem>
					<para
>Es dibuixarà de forma addicional el graf de la derivada de la funció amb el mateix color però menys amplada de línia. </para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term
>A2</term>
				<listitem>
					<para
>Es dibuixarà de forma addicional el graf de la segona derivada de la funció amb el mateix color però menys amplada de línia. </para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term
>D[a,b]</term>
				<listitem>
					<para
>Estableix el domini per al qual es mostrarà la funció. </para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term
>P[a{,b...}]</term>
				<listitem>
					<para
>Ofereix un conjunt de valors d'un paràmetre de grup per als quals s'haurà de mostrar la funció. Per exemple: <userinput
>f(x,k)=k*x;P[1,2,3]</userinput
> dibuixarà les funcions f(x)=x, f(x)=2*x i f(x)=3*x. També podeu utilitzar funcions com a arguments a l'opció «P». </para>
				</listitem>
			</varlistentry>
		</variablelist>
	</para>
	<para
>Tingueu en compte que també podeu fer totes aquestes operacions editant els elements a la pestanya <guilabel
>Derivats</guilabel
>, les seccions <guilabel
>Personalitza l'abast del gràfic</guilabel
> i <guilabel
>Paràmetres</guilabel
> a la barra lateral <guilabel
>Funcions</guilabel
>. </para>
</sect1>

<sect1 id="math-syntax">
	<title
>Sintaxi matemàtica</title>
	<para
>&kmplot; utilitza una forma habitual d'expressar les funcions matemàtiques, de manera que no hauríeu de tenir problemes alhora de treballar. Els operadors que &kmplot; entén són, en ordre decreixent de precedència: <variablelist>
			
			<varlistentry>
				<term
>^</term>
				<listitem
><para
>L'accent circumflex realitza l'exponenciació. &pex;, <userinput
>2^4</userinput
> retorna 16.</para>
				</listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>*</term>
				<term
>/</term>
				<listitem>
					<para
>L'asterisc i la barra realitzen la multiplicació i la divisió. &pex;, <userinput
>3*4/2</userinput
> retorna 6.</para>
				</listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>+</term>
				<term
>&minus;</term>
				<listitem
><para
>Els signes més i menys realitzen sumes i restes. &pex;, <userinput
>1+3&minus;2</userinput
> retorna 2.</para>
				</listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>&lt;</term>
				<term
>&gt;</term>
				<term
>&le;</term>
				<term
>&ge;</term>
				<listitem
><para
>Els operadors de comparació. Ens retornen 1 si l'expressió és «true» (veritable), en cas contrari retornarà 0. &pex;, <userinput
>1 &le; 2</userinput
> retorna 1.</para>
				</listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>&radic;</term>
				<listitem
><para
>L'arrel quadrada d'un nombre. &pex;, <userinput
>&radic;4</userinput
> retorna 2.</para>
				</listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>|x|</term>
				<listitem
><para
>El valor absolut de «x». &pex;, <userinput
>|&minus;4|</userinput
> retorna 4.</para>
				</listitem>
			</varlistentry>
			
			<varlistentry>
				<term
>&plusmn;</term>
				<term
></term>
				<listitem
><para
>Cada signe més-menys dóna dos tipus de gràfics: un en el qual es pren el signe més, i un altre en el qual es pren el signe menys. &pex;, <userinput
>y = &plusmn;sqrt(1&minus;x^2)</userinput
> dibuixarà un cercle. Aquests, per tant, no es poden utilitzar en les constants. </para>
				</listitem>
			</varlistentry>
			
			
			
		</variablelist>
	</para>
	<para
>Tingueu en compte la prioritat, el qual significa que si no s'utilitzen parèntesis, l'exponenciació es realitzarà abans de la multiplicació/divisió, la qual es realitzarà abans de sumar/restar. Així que <userinput
>1+2*4^2</userinput
> retorna 33, i no, diguem 144. Per evitar-ho, utilitzeu els parèntesi. Per utilitzar l'exemple de dalt, <userinput
>((1+2)*4)^2</userinput
> retornarà 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
>Àrea del gràfic</title>
	<para
>Per omissió, les funcions donades explícitament es representen per al conjunt de la part visible de l'eix «x». Podeu especificar un altre abast en el diàleg d'edició per a la funció. Cada punt resultant que es troba dins de l'àrea representada, s'unirà amb el punt anterior amb una línia. </para>
	<para
>Les funcions paramètriques i polars tenen un abast gràfic per omissió de 0 a 2&pgr;. Aquest abast gràfic també es pot canviar a la barra lateral <guilabel
>Funcions</guilabel
>. </para>
</sect1>

<sect1 id="coord-cross">
	<title
>Cursor de creu</title>
	<para
>Mentre el cursor del ratolí resta sobre l'àrea del gràfic aquest canviarà a una creu. Les coordenades actuals es poden veure a les interseccions amb els eixos de coordenades i també a la barra d'estat a la part inferior de la finestra principal. </para>
	<para
>Podeu traçar valors d'una funció amb major precisió fent clic sobre o al costat d'un graf. La funció seleccionada es mostrarà a la barra d'estat a la columna dreta. Llavors, la creu serà capturada i es tornarà del mateix color que el graf. Si el graf té el mateix color que el color de fons, la creu prendrà l'invers al color de fons. Observeu que, ara, en moure el ratolí o prémer les tecles de cursor <keysym
>Esquerre</keysym
> i <keysym
>Dret</keysym
> la creu seguirà a la funció i veureu els valors de «x» i «y». Si la creu és a prop de l'eix «y», es mostrarà el valor arrel a la barra d'estat. Podeu canviar la funció amb les tecles de cursor <keysym
>Amunt</keysym
> i <keysym
>Avall</keysym
>. Un segon clic a qualsevol part de la finestra o prement qualsevol tecla que no sigui de navegació, provocarà la sortida d'aquesta mode de traça. </para>
	<para
>Per a realitzar un traçat més avançat, obriu el diàleg de configuració i seleccioneu <guilabel
>Dibuixa la tangent i la normal mentre es traça</guilabel
> des de la pàgina <guilabel
>Arranjament general</guilabel
>. Aquesta opció dibuixarà la tangent, la normal i el cercle osculador del gràfic en que s'està treballant. </para>
	
</sect1>

<sect1 id="coords-config">
	<title
>Configurar el <guimenuitem
>Sistema de coordenades</guimenuitem
></title>
	<para
>Per obrir aquest diàleg seleccioneu <menuchoice
><guimenu
>Visualitza</guimenu
><guimenuitem
>Sistema de coordenades...</guimenuitem
></menuchoice
> des de la barra de menú.</para>
	<screenshot>
		<screeninfo
>Captura de pantalla del diàleg Sistema de coordenades</screeninfo>
		<mediaobject>
			<imageobject>
				<imagedata fileref="settings-coords.png" format="PNG"/>
			</imageobject>
			<textobject>
				<phrase
>Captura de pantalla del diàleg Sistema de coordenades</phrase>
			</textobject>
		</mediaobject>
	</screenshot>
	
	<sect2 id="axes-config">
		<title
>Configurar els <guilabel
>Eixos</guilabel
></title>
		<para>
			<variablelist>
				
				<varlistentry>
					<term
><guilabel
>Abast de l'eix «x»</guilabel
></term>
					<listitem>
						<para
>Estableix l'abast de l'escala per a l'eix «x». Tingueu en compte que podeu utilitzar les funcions i constants predefinides (veure <xref linkend="func-predefined"/> ) així com els extrems de l'abast (&pex;, establir <guilabel
>Mín:</guilabel
> a <userinput
>2*pi</userinput
>). Fins i tot podeu utilitzar funcions que heu definit per establir els extrems d'abast de l'eix. Per exemple, si heu definit una funció <userinput
>f(x) = x^2</userinput
>, podreu establir <guilabel
>Mín:</guilabel
> a <userinput
>f(3)</userinput
>, el qual farà l'extrem inferior de l'abast igual que 9.</para>
					</listitem>
				</varlistentry>
				
				<varlistentry>
					<term
><guilabel
>Abast de l'eix «y»</guilabel
></term>
					<listitem>
						<para
>Estableix l'abast per a l'eix «y». Veure <quote
>Abast de l'eix horitzontal</quote
> a sobre.</para>
					</listitem>
				</varlistentry>
				
				<varlistentry>
					<term
><guilabel
>Espaiat a la graella de l'eix «x»</guilabel
></term>
					<listitem>
						<para
>Això controla l'espaiat entre les línies de la graella en la direcció horitzontal. Si se selecciona <guilabel
>Automàtic</guilabel
>, llavors &kmplot; tractarà de trobar un espai entre línies de la graella d'uns dos centímetres, el qual també és numèricament agradable. Si se selecciona <guilabel
>A mida</guilabel
>, podreu introduir l'espaiat horitzontal de la graella. Aquest valor s'utilitza independentment del zoom. Per exemple, si s'introdueix un valor de 0.5, i l'abast de «x» és de 0 a 8, llavors es mostraran 16 línies de la graella. </para>
					</listitem>
				</varlistentry>
				
				<varlistentry>
					<term
><guilabel
>Espaiat a la graella de l'eix «y»</guilabel
></term>
					<listitem>
						<para
>Això controla l'espaiat entre les línies de quadrícula en la direcció vertical. Veure <quote
>Espaiat a la graella de l'eix «x»</quote
>. </para>
					</listitem>
				</varlistentry>
				
			</variablelist>
		</para>
		
	</sect2>
</sect1>

<sect1 id="constants-config">
	<title
>Configurar les <guimenuitem
>Constants</guimenuitem
></title>
	<para
>Per obrir aquest diàleg seleccioneu <menuchoice
><guimenu
>Edita</guimenu
><guimenuitem
>Constants...</guimenuitem
></menuchoice
> des de la barra de menú.</para>
	
	<screenshot>
		<screeninfo
>Captura de pantalla del diàleg Constants</screeninfo>
		<mediaobject>
			<imageobject>
				<imagedata fileref="settings-constants.png" format="PNG"/>
			</imageobject>
			<textobject>
				<phrase
>Captura de pantalla del diàleg Constants</phrase>
			</textobject>
		</mediaobject>
	</screenshot>
	
	<para
>Les constants es poden utilitzar com a part d'una expressió en qualsevol lloc dins de &kmplot;. Cada constant ha de tenir un nom i un valor. Alguns noms no són vàlids, com per exemple els noms de funcions existents o constants existents. </para>
	
	<para
>Hi ha dues opcions que controlen l'àmbit d'una constant: <variablelist>
			
			<varlistentry>
				<term
><guilabel
>Document</guilabel
></term>
				<listitem>
					<para
>Si seleccioneu la casella de selecció <guilabel
>Document</guilabel
>, la constant es desarà juntament amb el diagrama actual quan el deseu en un fitxer. No obstant, llevat que hagueu seleccionat també l'opció <guilabel
>Global</guilabel
>, la constant no estarà disponible entre les instàncies de &kmplot;.</para>
				</listitem>
			</varlistentry>
			
			<varlistentry>
				<term
><guilabel
>Global</guilabel
></term>
				<listitem>
					<para
>Si seleccioneu la casella de selecció <guilabel
>Global</guilabel
>, llavors el nom i el valor de la constant s'escriuran a la configuració del &kde; (el qual també pot ser utilitzat per &kcalc;). La constant no es perdrà quan &kmplot; sigui tancat, i tornarà a estar disponible per al seu ús quan &kmplot; sigui iniciat de nou.</para>
				</listitem>
			</varlistentry>
			
		</variablelist>
	</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:
			-->
