<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kalgebra;">
  <!ENTITY package "kdeedu">

  <!ENTITY commands SYSTEM "commands.docbook">

  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Catalan  "INCLUDE">
]>

<book id="kalgebra" lang="&language;">

<bookinfo>
<title
>El manual de &kalgebra;</title>

<authorgroup>
<author
><firstname
>Aleix</firstname
> <surname
>Pol</surname
> <affiliation
> <address
>&Aleix.Pol.mail;</address>
</affiliation>
</author>
&traductor.Antoni.Bella; 
</authorgroup>

<copyright>
<year
>2007</year>
<holder
>&Aleix.Pol;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>


<date
>27-06-2013</date>
<releaseinfo
>0.11 (&kde; 4.11)</releaseinfo>

<abstract>
<para
>&kalgebra; és una aplicació que pot substituir la calculadora gràfica. Té característiques numèriques, lògiques, simbòliques i d'anàlisi que us permetran calcular expressions matemàtiques a la consola i traçar gràfics dels resultats en 2D o 3D. &kalgebra; té les seves arrels en el llenguatge de marques matemàtic (Mathematical Markup Language -MathML-). Però un no us caldrà saber MathML per utilitzar &kalgebra;. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>graf</keyword>
<keyword
>matemàtiques</keyword>
<keyword
>2D</keyword>
<keyword
>3D</keyword>
<keyword
>mathML</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introducció</title>

<para
>&kalgebra; té nombroses característiques que permeten a l'usuari realitzar tot tipus d'operacions matemàtiques i mostrar-les gràficament. Alhora, aquest programa ha estat orientat a MathML. Ara el pot utilitzar qualsevol persona amb una mica de coneixements matemàtics per resoldre problemes senzills i avançats per igual. </para>
<!--FIXME Ask Burkhard where to put tutorials and if it is worth efforts to do. Example from UB page: http://swiftscythe.blogspot.de/2011/02/how-to-work-with-complex-numbers-in.html-->
<para
>Inclou característiques com: </para>


<itemizedlist>
<listitem
><para
>Una consola d'usuari per a l'avaluació ràpida i fàcil de les funcions matemàtiques. </para
></listitem>
<listitem
><para
>Capacitat de crear scripts per a sèries de càlculs avançats </para
></listitem>
<listitem
><para
>Capacitats de llenguatge, incloent l'autocompleció de definició de funcions i sintaxi. </para
></listitem>
<listitem
><para
>Funcions de càlcul, incloent els derivats de càlcul simbòlic, càlcul vectorial, manipulació de les llistes. </para
></listitem>
<listitem
><para
>Gràfics de funcions amb cursor dinàmic per trobar l'arrel gràfica i altres tipus d'anàlisi. </para
></listitem>
<listitem
><para
>Gràfics 3D per a la útil visualització de les funcions en 3D. </para
></listitem>
<listitem
><para
>Un diccionari encastat d'operadors per a una referència ràpida de les funcions disponibles. </para
></listitem>
</itemizedlist>

<para
>A continuació es mostra una captura de pantalla de l'aplicació &kalgebra; en acció: </para>

<screenshot>
<screeninfo
>Aquí hi ha una captura de pantalla de la finestra principal de &kalgebra;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="kalgebra-main-window.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Finestra principal de &kalgebra;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Quan l'usuari inicia una sessió de &kalgebra;, es presentarà amb una sola finestra que consisteix en una pestanya <guilabel
>Consola</guilabel
>, un <guilabel
>Graf 2D</guilabel
>, un <guilabel
>Graf 3D</guilabel
> i un <guilabel
>Diccionari</guilabel
>. Dins de cada pestanya, trobareu un camp d'entrada per introduir les vostres funcions o càlculs, i un camp de vista que mostrarà els resultats. </para>

<para
>En qualsevol moment l'usuari pot gestionar la seva sessió amb les opcions del menú principal <guilabel
>Sessió</guilabel
>:</para>

<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>N</keycap
></keycombo
></shortcut
> <guimenu
>Sessió</guimenu
><guimenuitem
>Nou</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Obre una nova finestra de &kalgebra;.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Maj; <keycap
>F</keycap
></keycombo
></shortcut
> <guimenu
>Sessió</guimenu
><guimenuitem
>Mode de pantalla completa</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Alterna el mode de pantalla completa per a la finestra de &kalgebra;. El mode de pantalla completa també es pot activar i desactivar utilitzant el botó <inlinemediaobject
> <imageobject
> <imagedata fileref="view-fullscreen.png" format="PNG"/> </imageobject
> </inlinemediaobject
> a la part superior dreta de la finestra de &kalgebra;.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>Q</keycap
></keycombo
></shortcut
> <guimenu
>Sessió</guimenu
><guimenuitem
>Surt</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Surt del programa.</para
></listitem>
</varlistentry>

</variablelist>

</chapter>

<chapter id="syntax">
<title
>Sintaxi</title>
<para
>&kalgebra; utilitza una sintaxi algebraica intuïtiva per a la introducció de funcions d'usuari, similar a la utilitzada en les calculadores gràfiques més modernes. En aquesta secció s'enumeren els operadors incorporats fonamentals disponibles a &kalgebra;. L'autor de &kalgebra; modela aquesta sintaxi basant-se en <ulink url="http://maxima.sourceforge.net/"
>Maxima</ulink
> i <ulink url="http://www.maplesoft.com/products/maple/"
>maple</ulink
> per als usuaris que estiguin familiaritzats amb aquests programes. </para>

<para
>Per als usuaris que estiguin interessats en el funcionament intern de &kalgebra;, les expressions introduïdes per l'usuari es converteixen a MathML sobre el dorsal. Una comprensió rudimentària de les capacitats de suport de MathML donen un gran avenç a les capacitats internes de &kalgebra;. </para>

<para
>Aquí hi ha una llista dels operadors disponibles que tenim per ara:</para>
<itemizedlist>
<listitem
><para
>+ - * / : Suma, resta, multiplicació i divisió.</para
> </listitem>
<listitem
><para
>^, ** : Potència, pot utilitzar ambdós. També és possible utilitzar caràcters Unicode ². Les potències són una manera de calcular arrels, podeu fer-ho com: a**(1/b)</para
></listitem>
<listitem
><para
>-&gt; : lambda. És la manera d'especificar una o més variables lliures que seran acotades a una funció. Per exemple, en l'expressió, <userinput
>length:=(x,y)->(x*x+y*y)^0.5</userinput
>, l'operador «lambda» s'utilitza per indicar que «x» i «y» s'acoten quan s'utilitza la funció de longitud («length»). </para
></listitem>
<listitem
><para
>x=a..b : S'utilitza quan necessitem delimitar un rang (variable acotada+límit superior+límit inferior). Això vol dir que «x» anirà des de «A» a «B».</para
></listitem>
<listitem
><para
>() : S'utilitza per especificar una prioritat més alta.</para
></listitem>
<listitem
><para
>abc(params) : Funcions. Quan l'analitzador troba una funció, comprovarà si «abc» és un operador. Si ho és, el tractarà com a tal, si no ho és, el tractarà com una funció d'usuari.</para
></listitem>
<listitem
><para
>:= : Definició. S'utilitza per definir un valor variable. Podeu fer coses com x:=3, x:=y, la «y» es pot o no definir, o perimeter:=r->2*pi*r. </para
></listitem>
<listitem
><para
>? : Definició de condicions. Aquesta és la manera com podem definir operacions condicionals a &kalgebra;. Dit d'una altra manera, aquesta és una forma d'especificar una condició «if», «elseif», «else». Si introduïm la condició abans del caràcter «?» només s'utilitzarà aquesta condició si és veritat, si troba un caràcter «?» sense cap condició, introduirà l'última instància. Exemple: piecewise { x=0 ? 0, x=1 ? x+1, ? x**2 } </para
></listitem>
<listitem
><para
>{} : Contenidor de MathML. Es pot utilitzar per definir un contenidor. Principalment útil per treballar amb les definicions d'operacions condicionals. </para
></listitem>
<listitem
><para
>= &gt; &gt;= &lt; &lt;= : Comparadors de valor per «igual», «major», «major o igual», «menor» i «menor o igual», respectivament.</para
></listitem>
</itemizedlist>

<para
>Ara us podeu preguntar, què fa llavors MathML? És molt senzill. Amb ell, podem operar amb funcions com cos(), sin(), altres funcions trigonomètriques, sum() o product(). No importa de quin tipus siguin. Podem utilitzar plus(), times() i tot el que té el seu operador. Les funcions booleanes també s'apliquen, així que no podem fer quelcom semblant a or(1,0,0,0,0).</para>

</chapter>

<chapter id="using-console">
<title
>Ús de la consola</title>
<para
>La consola de &kalgebra; és útil com una calculadora amb esteroides. L'usuari pot introduir expressions per avaluar en rl mode <guimenu
>Calcula</guimenu
> o <guimenu
>Avalua</guimenu
>, depenent de la selecció al menú de la <guimenu
>Consola</guimenu
>. </para>
<para
>En el mode avaluació, &kalgebra; simplifica l'expressió fins i tot si veu una variable sense definir. En el mode càlcul, &kalgebra; ho calcula tot i si troba una variable sense definir, mostrarà un error. </para>
<para
>A més de mostrar a la pantalla de la consola les equacions i resultats introduïts per l'usuari, totes les variables que es declaren es mostren en un quadre persistent de la dreta. Fent doble clic sobre una variable, veureu un diàleg que us permetrà canviar els seus valors (només una manera d'enganyar al registre). </para>

<para
>La variable «ans» és especial, cada vegada que introduïu una expressió, el valor de la variable «ans» canviarà el resultat final. </para>

<para
>Els següents exemples són de funcions que es poden introduir en el camp d'entrada de la finestra de la consola:</para>
<itemizedlist>
<listitem
><para
>sin(pi)</para
></listitem>
<listitem
><para
>k:=33</para
></listitem>
<listitem
><para
>sum(k*x : x=0..10)</para
></listitem>
<listitem
><para
>f:=p->p*k</para
></listitem>
<listitem
><para
>f(pi)</para
></listitem>
</itemizedlist>

<para
>A continuació es mostra una captura de pantalla de la finestra de la consola després d'introduir les expressions d'exemple de dalt: </para>
<screenshot>
<screeninfo
>Captura de pantalla de la finestra consola de &kalgebra; amb expressions d'exemple</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="kalgebra-console-window.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Finestra consola de &kalgebra;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>


<para
>Un usuari pot controlar l'execució d'una sèrie de càlculs utilitzant les opcions de menú de <guimenu
>Consola</guimenu
>:</para>

<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>L</keycap
></keycombo
></shortcut
> <guimenu
>Consola</guimenu
><guimenuitem
>Carrega un script</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Executa les instruccions en un fitxer seqüencial. Útil si es volen definir algunes biblioteques o reprendre algun treball anterior.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>G</keycap
></keycombo
></shortcut
> <guimenu
>Consola</guimenu
><guimenuitem
>Desa un script</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Desa les instruccions que heu escrit des que es va iniciar la sessió per poder-les tornar a utilitzar. Genera fitxers de text de manera que siguin fàcils de corregir utilitzant qualsevol editor de text, com Kate.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>S</keycap
></keycombo
></shortcut
> <guimenu
>Consola</guimenu
><guimenuitem
>Exporta el registre</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Desa el registre amb tots els resultats en un fitxer &HTML; per poder-lo imprimir o publicar.</para
></listitem>
</varlistentry>

</variablelist>

</chapter>

<chapter id="two-D-graphs">
<title
>Grafs 2D</title>
<para
>Per afegir un nou graf 2D en &kalgebra;, seleccioneu la pestanya <guilabel
>Graf 2D</guilabel
> i feu clic a la pestanya <guilabel
>Afegeix</guilabel
> per afegir una nova funció. El vostre focus anirà a un quadre de text des d'on podreu escriure la funció.</para>

<sect1 id="two-D-syntax">
<title
>Sintaxi</title>
<para
>Si voleu utilitzar una funció típica f(x), no és necessari especificar-la, però si voleu f(y) o una funció polar, haureu d'afegir y-&gt; and q-&gt; com en les variables acotades.</para>

<para
>Exemples:</para>
<itemizedlist>
<listitem
><para
>sin(x)</para
></listitem>
<listitem
><para
>x²</para
></listitem>
<listitem
><para
>y->sin(y)</para
></listitem>
<listitem
><para
>q->3*sin(7*q)</para
></listitem>
<listitem
><para
>t->vector{sin t, t**2}</para
></listitem>
</itemizedlist>
<para
>Si heu introduït la funció, feu clic al botó <guibutton
>Bé</guibutton
> per visualitzar el graf a la finestra principal.</para>

</sect1>

<sect1 id="two-D-features">
<title
>Característiques</title>
<para
>Podeu ajustar diversos grafs en la mateixa vista. Només heu d'utilitzar el botó <guilabel
>Afegeix</guilabel
> quan es troba en mode de llista. Podeu ajustar cada graf amb el seu propi color.</para>

<para
>La vista es pot apropar i moure amb el ratolí. Utilitzant la roda podeu apropar i allunyar. També podeu seleccionar una zona amb el &BER; i aquesta àrea serà ampliada. Moureu la vista amb les tecles de fletxa.</para>

<note>
 <para
>El camp de visió dels grafs en 2D es pot definir de forma explícita utilitzant la pestanya <guilabel
>Camp de visió</guilabel
> sobre una pestanya <guilabel
>Graf 2D</guilabel
>.</para>
</note>
 
<para
>A la pestanya <guilabel
>Llista</guilabel
>, podeu obrir una pestanya <guilabel
>Editant</guilabel
> per editar o eliminar una funció amb doble clic i marcar o desmarcar la casella de selecció al costat del nom de la funció per mostrar-la o ocultar-la.</para>
<para
>Al menú <guimenu
>Graf 2D</guimenu
> trobareu aquestes opcions:</para>
<itemizedlist>
<listitem
><para
>Mostrar o ocultar la graella</para
></listitem>
<listitem
><para
>Mantenir la relació d'aspecte mentre es fa zoom</para
></listitem>
<listitem
><para
>Apropar (<keycombo action="simul"
>&Ctrl; <keycap
>+</keycap
></keycombo
>) i allunyar (<keycombo action="simul"
>&Ctrl; <keycap
>-</keycap
></keycombo
>)</para
></listitem>
<listitem
><para
>Desar (<keycombo action="simul"
>&Ctrl; <keycap
>S</keycap
></keycombo
>) el graf com un fitxer d'imatge</para
></listitem>
<listitem
><para
>Reiniciar la vista a l'apropament original</para
></listitem>
<listitem
><para
>Selecciona una resolució pels grafs</para
></listitem>
</itemizedlist>

<para
>A continuació es mostra una captura de pantalla d'un usuari que el cursor es troba en l'arrel a la dreta de la funció, sin(1/x). L'usuari utilitza una resolució molt alta per crear aquest graf (atès que una funció amb una freqüència cada vegada major acaba oscil·lant al voltant de les coordenades d'origen). També hi ha una funció de cursor en viu, on cada vegada que moveu el cursor sobre un punt, es mostren els valors de «x» i «y» a la cantonada inferior esquerra de la pantalla. També s'ha dibuixat una «línia tangent» sobre la funció a la posició on es troba el cursor. </para>

<screenshot>
<screeninfo
>Aquí hi ha una captura de pantalla de la finestra grafs 2D de &kalgebra;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="kalgebra-2dgraph-window.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Finestra grafs 2D de &kalgebra;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>


</sect1>

</chapter>

<chapter id="three-D-graphs">
<title
>Grafs 3D</title>

<para
>Per dibuixar un graf 3D amb &kalgebra; seleccioneu la pestanya <guilabel
>Graf 3D</guilabel
> i veureu un camp d'entrada a la part inferior on escriureu la funció. Z encara no es pot definir. De moment &kalgebra; només suporta grafs 3D explícitament que depenen únicament de la «x» i «y», com ara (x,y)->x*y, on z=x*y. </para>

<para
>Exemples:</para>
<itemizedlist>
<listitem
><para
>(x,y)->sin(x)*sin(y)</para
></listitem>
<listitem
><para
>(x,y)->x/y</para
></listitem>
</itemizedlist>

<para
>La vista es pot apropar i moure amb el ratolí. Utilitzant la roda podeu apropar i allunyar. Premeu el &BER; i moveu el ratolí per girar el graf.</para>

<!--FIXME BUG:321686 it is not possible to do use keys
<para
>The left and right arrow keys rotate the graph around the z axis, the up and down arrow keys rotate around the horizontal axis of the view.</para>
 -->
<para
>Al menú <guimenu
>Graf 3D</guimenu
> trobareu aquestes opcions:</para>
<itemizedlist>
<!-- not in master for 4.11
<listitem
><para
>Enable or disable transparency in the 3D graph menu</para
></listitem>
-->
<listitem
><para
>Desar (<keycombo action="simul"
>&Ctrl; <keycap
>S</keycap
></keycombo
>) el graf com un fitxer d'imatge</para
></listitem>
<listitem
><para
>Reiniciar la vista a l'apropament original al menú de grafs 3D</para
></listitem>
<listitem
><para
>Podeu dibuixar els grafs amb punts, línies o estils sòlids al menú de graf 3D</para
></listitem>
</itemizedlist>

<para
>A continuació es mostra una captura de pantalla de l'anomenada funció «sombrero». En aquest graf en particular es mostra el graf 3D utilitzant l'estil de línies. </para>

<screenshot>
<screeninfo
>Aquí hi ha una captura de pantalla de la finestra grafs 3D de &kalgebra;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="kalgebra-3dgraph-window.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Finestra grafs 3D de &kalgebra;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

</chapter>

<chapter id="dictionary">
<title
>Diccionari</title>

<para
>El diccionari conté una llista de totes les funcions incloses a &kalgebra;. Es pot utilitzar per trobar la definició d'una operació i els seus paràmetres d'entrada. És un lloc útil per cercar les moltes capacitats de &kalgebra;. </para>

 <para
>A continuació es mostra una captura de pantalla de la cerca al diccionari de &kalgebra; de la funció cosinus. </para>

<screenshot>
<screeninfo
>Aquí hi ha una captura de pantalla de la finestra diccionari de &kalgebra;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="kalgebra-dictionary-window.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Finestra diccionari de &kalgebra;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>


</chapter>

&commands;

<chapter id="credits">
<title
>Crèdits i llicència</title>

<itemizedlist>
<listitem
><para
>Copyright del programa 2005-2009 &Aleix.Pol;</para>
</listitem>
</itemizedlist>

<para
>Copyright de la documentació 2007 &Aleix.Pol; &Aleix.Pol.mail; </para>

<para
>Traductor de la documentació: &credits.Antoni.Bella;</para
> 
&underFDL; &underGPL; </chapter>


<appendix id="installation">
<title
>Instal·lació</title>

<sect1 id="getting-kapptemplate">
<title
>Com obtenir el &kalgebra;</title>
&install.intro.documentation; </sect1>

<sect1 id="compilation">
<title
>Compilació i instal·lació</title>
&install.compile.documentation; </sect1>

</appendix>
&documentation.index;
</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->
