<chapter id="reference">
<title>Referencia 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>Sintaxis de las funciones</title>

<para>Algunas reglas de sintaxis deben seguir la siguiente estructura:</para>

<screen><userinput>nombre(var1[, var2])=term [;extensiones]</userinput>
</screen>


<variablelist>
<varlistentry>
<term>nombre</term>
<listitem>

<para>El nombre de la función. Si el primer carácter es «r», el analizador asume que está usando coordenadas polares. Si el primer carácter es «x» (por ejemplo «xfunc»), el analizador espera una segunda función que comience por «y» (por tanto, «yfunc») para definir la función de forma paramétrica. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>var1</term>
<listitem><para>La variable de la función.</para></listitem>
</varlistentry>
<varlistentry>
<term>var2</term> 
<listitem><para>La función «parámetro de grupo». Debe estar separada de las variables de la función por una coma. Puede usar el parámetro de grupo para, por ejemplo, representar varios gráficos desde una función. El valor de los parámetros puede ser seleccionado manualmente, o puede elegir utilizar una barra deslizante para controlar un parámetro determinado. Al modificar el valor del la barra deslizante, el valor del parámetro cambiará en consecuencia. Dicha barra puede tomar valores enteros del 0 al 100.</para></listitem>
</varlistentry>
<varlistentry>
<term>term</term>
<listitem><para>La expresión que define la función.</para></listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="func-predefined">
<title>Nombre predefinidos de funciones y constantes</title>

<para>Todas las funciones y constantes predefinidas que conoce &kmplot; se muestran al seleccionar <menuchoice><guimenu>Ayuda</guimenu><guimenuitem>Funciones matemáticas predefinidas</guimenuitem> </menuchoice>. Son: <variablelist>

<varlistentry>
<term>sqr, sqrt</term>
<listitem>
<para>Devuelven, respectivamente, el cuadrado y la raíz cuadrada de un número.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>exp, ln</term>
<listitem>
<para>Devuelven, respectivamente, los logaritmos exponencial y natural de un número.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>log</term>
<listitem>
<para>Devuelve el logaritmo en base 10 de un número.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>sin, arcsin</term>
<listitem>
<para>Devuelven, respectivamente, el seno y el arcoseno de un número. Tenga en cuenta que el argumento del seno y del valor devuelto por el arcoseno están en radianes.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>cos, arccos</term>
<listitem>
<para>Devuelven, respectivamente, el coseno y el arcocoseno de un número. También en radianes.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>tan, arctan</term>
<listitem>
<para>Devuelven, respectivamente, la tangente y la arcotangente de un número. También en radianes.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>sinh, arcsinh</term>
<listitem>
<para>Devuelven, respectivamente, el seno hiperbólico y el coseno hiperbólico de un número.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>cosh, arccosh</term>
<listitem>
<para>Devuelven, respectivamente, el coseno hiperbólico y el arcocoseno hiperbólico de un número.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>tanh, arctanh</term>
<listitem>
<para>Devuelven, respectivamente, la tangente hiperbólica y la arcotangente hiperbólica de un número.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>sin, arcsin</term>
<listitem>
<para>Devuelven, respectivamente, el seno y el arcoseno de un número. Tenga en cuenta que el argumento del seno y del valor devuelto por el arcoseno están en radianes.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>cos, arccos</term>
<listitem>
<para>Devuelven, respectivamente, el coseno y el arcocoseno de un número. También en radianes.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>pi, e</term>
<listitem>
<para>Constantes que representan, respectivamente, &pgr; (3.14159...) y e (2.71828...).</para>
</listitem>
</varlistentry>

</variablelist>
</para>

<para>Estas funciones y constantes, y casi todas las definidas por el usuario se pueden usar para determinar también las preferencias de los ejes. Vea <xref linkend="axes-config"/>. </para>

</sect1>

<sect1 id="func-extension">
  <title>Extensiones</title>
  <para>Una extensión para una función se especifica introduciendo un punto y coma seguido de la extensión, después de la definición de la función. La extensión puede escribirse utilizando el cuadro de edición rápida o utilizando el método &DCOP; Parser addFunction. Ninguna de las extensiones estarán disponibles para las funciones paramétricas, pero N y D[a,b] funcionan también para las funciones polares. Por ejemplo: <screen>
      <userinput>
        f(x)=x^2; A1
      </userinput>
    </screen> mostrará el gráfico y=x<superscript>2</superscript> con su primera derivada. Las extensiones soportadas se describen a continuación: <variablelist>
      <varlistentry>
	<term>N</term>
	<listitem>
	  <para>La función se guardará pero no se dibujará. Puede utilizarse como cualquier otra función predefinida o definida por el usuario. </para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>A1</term>
	<listitem>
	  <para>El gráfico de la derivada de la función se dibujará adicionalmente con el mismo color pero con línea más fina. </para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>A2</term>
	<listitem>
	  <para>El gráfico de la segunda derivada de la función se dibujará adicionalmente con el mismo color pero con una línea más fina. </para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>D[a,b]</term>
	<listitem>
	  <para>Asigna el dominio para el que se mostrará la función. </para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>P[a{,b...}]</term>
	<listitem>
	  <para>Indica el conjunto de valores de un grupo de parámetros para los que la función debería mostrarse. Por ejemplo: <userinput>f(x,k)=k*x;P[1,2,3]</userinput> dibujará las funciones f(x)=x, f(x)=2*x, f(x)=3*x. También puede utilizar funciones como argumentos de la opción P. </para>
	</listitem>
      </varlistentry>
    </variablelist>
  </para>
  <para>Tenga en cuenta que puede realizar todas estas operaciones utilizando el diálogo editor de funciones. </para>
</sect1>

<sect1 id="math-syntax">
<title>Sintaxis matemática</title>
<para>&kmplot; usa una forma común de expresar las funciones matemáticas, para que no tenga problemas a la hora de trabajar. Los operadores que entiende &kmplot; son, en orden decreciente de precedencia: <variablelist>

<varlistentry>
<term>^</term>
<listitem><para>El acento circunflejo realiza la exponenciación. &eg; <userinput>2^4</userinput> devuelve 16.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>*, /</term>
<listitem>
<para>El asterisco y la barra realizan la multiplicación y la división. &eg;, <userinput>3*4/2</userinput> devuelve 6.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>+, -</term>
<listitem><para>Los símbolos más y menos realizan la suma y la resta. &eg; <userinput>1+3-2</userinput> devuelve 2.</para>
</listitem>
</varlistentry>

</variablelist>
</para>
<para>Tenga en cuenta la precedencia, que significa que si no se usan paréntesis, la potencia se realiza antes que la multiplicación/división, que a su vez se realiza antes que la suma/resta. Por tanto, <userinput>1+2*4^2</userinput> devuelve 33 y no, por ejemplo, 144.Para superponerse a esto, use paréntesis. En el ejemplo anterior, <userinput>((1+2)*4)^2</userinput> <emphasis>devolverá</emphasis> 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 de representación</title>
<para>De forma predeterminada, las funciones dadas explícitamente se representan para la parte visible del eje x. Es posible especificar un rango diferente en el diálogo edición de la función. Para cada pixel del eje x, &kmplot; calcula el valor de la función. Si el área de representación contiene el punto resultante, se conecta con una línea al último punto dibujado. </para>
<para>Las funciones paramétricas se representan para valores desde 0 hasta 2&pgr;. Este rango también se puede fijar en el diálogo correspondiente a la función. </para>
</sect1>

<sect1 id="coord-cross">
<title>Cursor de cruz</title>
<para>Cuando el cursor del ratón está sobre el área de representación, el cursor se convierte en dos líneas que se cruzan. Las coordenadas actuales se pueden ver en las intersecciones con los ejes de coordenadas y también en la barra de estado del final de la ventana principal. </para>
<para>Para rastrear los valores de una función con exactitud, pulse dentro o en las cercanías del gráfico. La función seleccionada se mostrará en la columna de la derecha de la barra de estado. Entonces, la cruz será capturada y se tornará del color del gráfico correspondiente. Si el color del gráfico fuera el mismo que el color de fondo, la cruz tomaría el inverso a dicho color. Observe que, ahora, al mover el ratón o presionar las teclas de dirección derecha o izquierda, la cruz seguirá el camino de la función a la vez que se mostrarán los valores de x e y correspondientes. Las teclas de dirección arriba y abajo, servirán para alternar entre las diferentes funciones. Una segunda pulsación en cualquier lugar de la ventana, o cualquier tecla que no sea de dirección, provocará que se abandone el modo de rastreo. </para>
<para>Tenga en cuenta que el rastreo sólo es posible para funciones con valores dados explícitamente. Las coordenadas se muestran siempre según el sistema cartesiano de coordenadas. Ni las funciones paramétricas no puntuales, ni las dadas en coordenadas polares pueden ser rastreadas de esta manera. </para>

</sect1>

</chapter>
