<?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 % addindex "IGNORE">
  <!ENTITY % Spanish "INCLUDE">
]>

<book 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>
<othercredit role="translator"
><firstname
>Leticia</firstname
><surname
>Martín Hernández</surname
><affiliation
><address
><email
>leticia.martin@gmail.com</email
></address
></affiliation
><contrib
>Traductor</contrib
></othercredit
><othercredit role="translator"
><firstname
>Eloy</firstname
><surname
>Cuadra</surname
><affiliation
><address
><email
>ecuadra@eloihr.net</email
></address
></affiliation
><contrib
>Traductor</contrib
></othercredit
>  
</authorgroup>

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

<legalnotice
>&FDLNotice;</legalnotice>


<date
>2009-11-8</date>
<releaseinfo
>0.9 (&kde; 4.4.0)</releaseinfo>

<abstract>
<para
>&kalgebra; es una calculadora matemática basada en el lenguaje de marcado MathML. Hoy en día es capaz de realizar operaciones simples (aritméticas y lógicas) usando MathML y de representarlas en gráficas de dos y tres dimensiones. No es necesario conocer MathML para usar &kalgebra;. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>gráfica</keyword>
<keyword
>matemáticas</keyword>
<keyword
>2D</keyword>
<keyword
>3D</keyword>
<keyword
>mathML</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction"
> 
<title
>Introducción</title
> 
<para
>&kalgebra; es una calculadora gráfica basada en MathML. Aunque en un principio estuvo orientado a MathML, actualmente puede ser usado por cualquier persona, aunque posea pocos conocimientos matemáticos. </para
> 

<screenshot>
<screeninfo
>Aquí se muestra una captura de la ventana principal de &kalgebra;.</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="kalgebra-main-window.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Ventana principal de &kalgebra;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>La ventana principal de &kalgebra; consta de cuatro pestañas: <guilabel
>Consola</guilabel
>, <guilabel
>Gráfica 2D</guilabel
>, <guilabel
>Gráfica 3D</guilabel
> y <guilabel
>Diccionario</guilabel
>. Bajo estas pestañas encontrará un campo de entrada donde podrá introducir sus funciones o realizar sus cálculos. </para>

</chapter>

<chapter id="syntax">
<title
>Sintaxis</title>

<para
>Para entender cómo funciona, conviene comprender que lo que introducimos está siendo convertido a MathML, aunque no es necesario conocer MathML. He basado la sintaxis en el sentido común, por lo que debería ser asequible para todos; he tenido también en cuenta las sintaxis de Maxima y Maple, por lo que es muy similar a estas.</para>
<para
>Aquí hay una lista de los operadores disponibles hasta el momento:</para>
<itemizedlist>
<listitem
><para
>+ - * / : suma, resta, multiplicación y división.</para
> </listitem>
<listitem
><para
>^, ** : potencia, puede usar cualquiera de las dos formas. Asimismo, puede usar los caracteres unicode ². Las potencias son también una forma de expresar raíces, lo que puede hacer de la siguiente forma: a**(1/b).</para
></listitem>
<listitem
><para
>-&gt; : lambda. Permite especificar la variable limitada en una función.</para
></listitem>
<listitem
><para
>x=a..b : se usa cuando necesitamos delimitar un rango (variable limitada + límite superior + límite inferior). Esto significa que «x» va de «a» a «b».</para
></listitem>
<listitem
><para
>() : se usa para especificar una prioridad mayor.</para
></listitem>
<listitem
><para
>abc(parámetros) : funciones. Cuando el analizador sintáctico encuentra una función, comprueba si «abc» es un operador. Si lo es, lo trata como un operador; si no lo es, lo trata como una función de usuario. </para
></listitem>
<listitem
><para
>:= : definición. Se usa para definir el valor de una variable. Puede escribir cosas como «x:=3, x:=y», donde «y» puede estar definido o no, o como «perímetro:=r->2*pi*r». </para
></listitem>
<listitem
><para
>? : definición de condiciones en funciones definidas a trozos («piecewise»). Permite definir operaciones condicionales en &kalgebra;. Cuando introducimos la condición antes del símbolo «?», &kalgebra; utiliza esta condición solo si es verdadera; en cambio, si encuentra un símbolo «?» sin ninguna condición, toma en cuenta el último caso. Por ejemplo: piecewise { x=0 ? 0, x=1 ? x+1, ? x**2 }. </para
></listitem>
<listitem
><para
>{ } : contenedor MathML. Puede usarse para definir un contenedor. Es muy útil a la hora de trabajar con funciones definidas a trozos. </para
></listitem>
<listitem
><para
>= &gt; &gt;= &lt; &lt;= : operadores relacionales que indican «igual», «mayor», «mayor o igual», «menor» o «menor o igual», respectivamente.</para
></listitem>
</itemizedlist>
<para
>Ahora puede preguntarme por qué debería el usuario preocuparse por MathML. La respuesta es fácil. Con esto podremos realizar operaciones con funciones como cos(), sin() (o cualquier otra función trigonométrica), sum() o product(). No importa el tipo de función que sea. Podremos usar plus(), times() y cualquier cosa a la que le corresponda un operador. También se han implementado funciones lógicas, por lo que podremos hacer cosas como «or(1,0,0,0,0)». </para>

</chapter>

<chapter id="using-console">
<title
>Uso de la consola</title>
<para
>La consola de &kalgebra; es tan útil como una calculadora. Aquí tiene una lista de las variables declaradas. Si pulsa dos veces sobre una de ellas, le aparecerá un diálogo con el que podrá cambiar su valor (es una forma de engañar al registro). Cada vez que introduzca una expresión, el valor de la variable «ans» cambiará para reproducir el último resultado.</para>

<para
>Ejemplos:</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
>Opciones del menú:</para>

<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>N</keycap
></keycombo
></shortcut
> <guimenuitem
>Nuevo</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Refresca el registro.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>L</keycap
></keycombo
></shortcut
> <guimenuitem
>Cargar un guión</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Ejecuta las instrucciones en una archivo de forma secuencial. Es útil si lo que desea es definir una biblioteca o reanudar un trabajo anterior.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>G</keycap
></keycombo
></shortcut
> <guimenuitem
>Guardar el guión</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Guarda las intrucciones que ha introducido desde que comenzó la sesión, con lo que podrá reutilizarlas. Genera un archivo de texto que podrá corregir usando cualquier editor de texto, por ejemplo Kate.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>S</keycap
></keycombo
></shortcut
> <guimenuitem
>Guardar el registro</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Guarda el registro con todos los resultados en un archivo HTML que podrá imprimir o pubicar.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>Q</keycap
></keycombo
></shortcut
> <guimenuitem
>Salir</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Cierra el programa.</para
></listitem>
</varlistentry>

</variablelist>

</chapter>

<chapter id="two-D-graphs">
<title
>Gráficas 2D</title>
<para
>Para añadir un gráfica 2D en &kalgebra;, lo que tiene que hacer es ir a la pestaña <guilabel
>Gráfica 2D</guilabel
> y aquí pulsar la pestaña  <guilabel
>Añadir</guilabel
>, que le permitirá añadir una nueva función. A continuación tendrá dirigirse al cuadro de texto de entrada, donde podrá introducir su función. </para>

<sect1 id="two-D-syntax">
<title
>Sintaxis</title>
<para
>Si quiere usar una función f(x) típica, no es necesario que la especifique; en cambio, si quiere usar una función f(y) o una función polar, tendrá que añadir y-> y q-> como variables limitadas.</para>

<para
>Ejemplos:</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
>Después de haber introducido la función, pulse el botón <guibutton
>Aceptar</guibutton
> para dibujar la gráfica en la ventana principal.</para>

</sect1>

<sect1 id="two-D-features">
<title
>Características</title>
<para
>Es posible dibujar varias gráficas en la misma vista. Para esto use simplemente el botón <guilabel
>Añadir</guilabel
> cuando se encuentre en el modo Lista. Puede ajustar el color de cada gráfica.</para>

<para
>Puede ampliar la vista y desplazarla con el ratón. Con la rueda del ratón podrá ampliar o reducir la vista. Puede también seleccionar un área con el botón izquierdo, y el área se ampliará. Desplace la vista con las teclas de dirección. </para>

<para
>En la pestaña <guilabel
>Lista</guilabel
>, puede abrir un menú contextual pulsando con el &RMB; sobre una función, lo que le permitirá ocultar o eliminar dicha función.</para>

<para
>En el menú <guimenu
>Gráfica 2D</guimenu
> dispone de las siguientes opciones:</para>
<itemizedlist>
<listitem
><para
>Mostrar u ocultar la rejilla.</para
></listitem>
<listitem
><para
>Mantener las proporciones mientras amplía o reduce la vista.</para
></listitem>
<listitem
><para
>Ampliar (<keycombo action="simul"
>&Ctrl; <keycap
>+</keycap
></keycombo
>) y reducir (<keycombo action="simul"
>&Ctrl; <keycap
>-</keycap
></keycombo
>).</para
></listitem>
<listitem
><para
>Guardar (<keycombo action="simul"
>&Ctrl; <keycap
>S</keycap
></keycombo
>) la gráfica como un archivo de imagen.</para
></listitem>
<listitem
><para
>Reiniciar la vista a la ampliación original.</para
></listitem>
<listitem
><para
>Seleccionar una resolutión para las gráficas.</para
></listitem>
</itemizedlist>
</sect1>

</chapter>

<chapter id="three-D-graphs">
<title
>Gráficas 3D</title>

<para
>Para dibujar una grafica 3D con &kalgebra;, tiene que ir a la pestaña <guilabel
>Gráfica 3D</guilabel
>, donde verá un campo de entrada en la parte inferior que le permitirá introducir su función. &kalgebra; no le permite de momento definir z, ya que solo admite gráficas 3D que dependen de x e y, tales como (x, y)->x*y, donde z=x*y.</para>

<para
>Ejemplos:</para>
<itemizedlist>
<listitem
><para
>sin(x)*sin(y)</para
></listitem>
<listitem
><para
>x/y</para
></listitem>
</itemizedlist>

<para
>Puede ampliar o reducir la vista con el ratón. Use la rueda del ratón para ampliarla o reducirla. Si mantiene pulsado el &LMB; y se desplaza con el ratón, la gráfica rotará.</para>

<para
>Las teclas de dirección izquierda y derecha rotan la gráfica alrededor del eje z, mientras que las teclas de dirección arriba y abajo la rotan alrededor del eje horizontal de la vista.</para>

<para
>En el menú <guimenu
>Gráfica 3D</guimenu
> dispone de las siguientes opciones:</para>
<itemizedlist>
<listitem
><para
>Activar o desactivar la transparencia.</para
></listitem>
<listitem
><para
>Guardar (<keycombo action="simul"
>&Ctrl; <keycap
>S</keycap
></keycombo
>) la gráfica como un archivo de imagen.</para
></listitem>
<listitem
><para
>Reiniciar la vista a la ampliación original.</para
></listitem>
<listitem
><para
>Dibujar la gráfica con puntos, con líneas o con una línea sólida.</para
></listitem>
</itemizedlist>


</chapter>

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

<para
>El diccionario es una collección de todas las operaciones disponibles en &kalgebra;. Puede ser de utilidad a la hora de comprobar para qué sirve una operación y para saber de cuántos parámetros consta una función.</para>

</chapter>


<chapter id="credits">
<title
>Créditos y licencia</title>

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

<para
>Derechos de autor de la documentación 2007 &Aleix.Pol; &Aleix.Pol.mail;. </para>

<para
>Traducido por Leticia Martín Hernández <email
>leticia.martin@gmail.com</email
> y Eloy Cuadra <email
>ecuadra@eloihr.net</email
>.</para
> 
&underFDL; &underGPL; </chapter>


<appendix id="installation">
<title
>Instalación</title>

<sect1 id="getting-kapptemplate">
<title
>Cómo obtener &kalgebra;</title>
&install.intro.documentation; </sect1>

<sect1 id="compilation">
<title
>Compilación e instalación</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:
-->