<?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-11-2011</date>
<releaseinfo
>0.11 (&kde; 4.8)</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
>gràfic</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>

<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
>, una <guilabel
>Gràfic 2D</guilabel
>, una <guilabel
>Gràfic 3D</guilabel
> i una <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; <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 presentem 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
>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
>Gràfics 2D</title>
<para
>Per afegir un nou gràfic 2D en &kalgebra;, seleccioneu la pestanya <guilabel
>Gràfic 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 gràfic a la finestra principal.</para>

</sect1>

<sect1 id="two-D-features">
<title
>Característiques</title>
<para
>Podeu ajustar diversos gràfics en la mateixa vista. Només heu d'utilitzar el botó <guilabel
>Afegeix</guilabel
> quan es troba en mode de llista. Podeu ajustar cada gràfic 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>

<para
>A la pestanya <guilabel
>Llista</guilabel
>, podeu obrir un menú contextual amb el &BDR; fent clic a sobre d'una funció per ocultar-la o eliminar-la.</para>

<para
>Al menú <guimenu
>Gràfic 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 gràfic com un fitxer d'imatge</para
></listitem>
<listitem
><para
>Reiniciar la vista a l'apropament original</para
></listitem>
<listitem
><para
>Selecciona una resolució per als gràfics</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 gràfic (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 gràfics 2D de &kalgebra;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="kalgebra-2dgraph-window.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Finestra gràfics 2D de &kalgebra;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>


</sect1>

</chapter>

<chapter id="three-D-graphs">
<title
>Gràfics 3D</title>

<para
>Per dibuixar un gràfic 3D amb &kalgebra; seleccioneu la pestanya <guilabel
>Gràfic 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 gràfics 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
>sin(x)*sin(y)</para
></listitem>
<listitem
><para
>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 gràfic.</para>

<para
>Les tecles de fletxa esquerra i dreta giren el gràfic al voltant de l'eix «z», les tecles de fletxa cap amunt i cap avall el giren al voltant de l'eix horitzontal de la vista.</para>

<para
>Al menú <guimenu
>Gràfic 3D</guimenu
> trobareu aquestes opcions:</para>
<itemizedlist>
<listitem
><para
>Activar o desactivar la transparència al menú de gràfics 3D</para
></listitem>
<listitem
><para
>Desar (<keycombo action="simul"
>&Ctrl; <keycap
>S</keycap
></keycombo
>) el gràfic com un fitxer d'imatge</para
></listitem>
<listitem
><para
>Reiniciar la vista a l'apropament original al menú de gràfics 3D</para
></listitem>
<listitem
><para
>Podeu dibuixar els gràfics amb punts, línies o estils sòlids al menú de gràfic 3D</para
></listitem>
</itemizedlist>

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

<screenshot>
<screeninfo
>Aquí hi ha una captura de pantalla de la finestra gràfics 3D de &kalgebra;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="kalgebra-3dgraph-window.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Finestra gràfics 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:
-->
