<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
>All the predefined functions and constants that &kmplot; knows can be shown by selecting <menuchoice
><guimenu
>Help</guimenu
><guimenuitem
>Predefined Math Functions</guimenuitem
> </menuchoice
>. They are: <variablelist>

<varlistentry>
<term
>sqr, sqrt</term>
<listitem>
<para
>Return the square and square root of a number, respectively.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>exp, ln</term>
<listitem>
<para
>Return the exponential and natural logarithm of a number, respectively.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>log</term>
<listitem>
<para
>Returns the logarithm to base 10 of a number.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>sin, arcsin</term>
<listitem>
<para
>Return the sine and inverse sine of a number, respectively. Note that the argument to sin and the return value of arcsin are in radians.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>cos, arccos</term>
<listitem>
<para
>Return the cosine and inverse cosine of a number, respectively. Also in radians.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>tan, arctan</term>
<listitem>
<para
>Return the tangent and inverse tangent of a number, respectively. Also in radians.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>sinh, arcsinh</term>
<listitem>
<para
>Return the hyperbolic sine and inverse hyperbolic sine of a number, respectively.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>cosh, arccosh</term>
<listitem>
<para
>Return the hyperbolic cosine and inverse hyperbolic cosine of a number, respectively.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>tanh, arctanh</term>
<listitem>
<para
>Return the hyperbolic tangent and inverse hyperbolic tangent of a number, respectively.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>sin, arcsin</term>
<listitem>
<para
>Return the sine and inverse sine of a number, respectively. Note that the argument to sin and the return value of arcsin are in radians.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>cos, arccos</term>
<listitem>
<para
>Return the cosine and inverse cosine of a number, respectively. Also in radians.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>pi, e</term>
<listitem>
<para
>Constants representing &pgr; (3.14159...) and e (2.71828...), respectively.</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
>An extension for a function is specified by entering a semicolon, followed by the extension, after the function definition. The extension can either be written in the Quick Edit box or by using the &DCOP; method Parser addFunction. None of the extensions are available for parametric functions but N and D[a,b] work for polar functions too. For example: <screen>
      <userinput>
        f(x)=x^2; A1
      </userinput>
    </screen
> will show the graph y=x<superscript
>2</superscript
> with its first derivative. Supported extensions are described below: <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
>The plus and minus symbols perform addition and subtraction. &eg;, <userinput
>1+3-2</userinput
> returns 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
>By default, explicitly given functions are plotted for the whole of the visible part of the x-axis. You can specify an other range in the edit-dialog for the function. For every pixel on the x-axis &kmplot; calculates a function value. If the plotting area contains the resulting point it is connected to the last drawn point by a line. </para>
<para
>Parametric functions are plotted for parameter values from 0 up to 2&pgr;. You can set the plotting range in the dialog for the function too. </para>
</sect1>

<sect1 id="coord-cross">
<title
>Cross Hair Cursor</title>
<para
>While the mouse cursor is over the plotting area the cursor changes to a cross hair. The current coordinates can be seen at the intersections with the coordinate axes and also in the status bar at the bottom of the main window. </para>
<para
>You can trace a function's values more precisely by clicking onto or next to a graph. The selected function is shown in the status bar in the right column. The cross hair then will be caught and be colored in the same color as the graph. If the graph has the same color as the background color, the cross hair will have the inverted color of the background. When moving the mouse or pressing the keys Left or Right the cross hair will follow the function and you see the current x- and y-value. If the cross hair is close to y-axis, the root-value is shown in the statusbar. You can switch function with the Up and Down keys. A second click anywhere in the window or pressing any non-navigating key will leave this trace mode. </para>
<para
>Note that tracing is only possible with explicitly given functions. The coordinates are always displayed according to a Cartesian system of coordinates. Neither non-single-point parametric functions nor functions given in polar coordinates can be traced in this way. </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:
-->
