<chapter id="tutorial">

<chapterinfo>
<authorgroup>
<author
><firstname
>Barth</firstname
> <othername
></othername
> <surname
>Netterfield</surname
> <affiliation
><address
><email
>kst@kde.org</email
></address
></affiliation>
</author>
<author
><firstname
>Rick</firstname
> <othername
></othername
> <surname
>Chern</surname
> <affiliation
><address
><email
>kst@kde.org</email
></address
></affiliation>
</author>
</authorgroup>



<copyright>
<year
>2004</year>
<holder
>La Universidad de British Columbia</holder>
</copyright>



</chapterinfo>
<title
>El tutorial de &kst;</title>



<sect1 id="Welcome">
<title
>Bienvenido</title>
<para
>¡Bienvenido a &kst;! En pocos minutos, estará listo para explorar las ricas características de este paquete de manipulación y dibujo de datos. Aquí están algunas de las tareas que puede acometer utilizando &kst;: </para>

<itemizedlist>
<listitem>
<para
>Dibujar rápidamente diferentes gráficos utilizando solo la línea de órdenes. </para>
</listitem>
<listitem>
<para
>Analizar datos utilizando un amplio conjunto de herramientas incluyendo histogramas, espectros de potencia y ecuaciones personalizadas. </para>
</listitem>
<listitem>
<para
>Ampliar y reducir sin esfuerzo las áreas que considere interesantes utilizando el ratón o el teclado. </para>
</listitem>
<listitem>
<para
>Monitorizar los datos transmitidos utilizando las capacidades de dibujo de &kst; en tiempo real. </para>
</listitem>
</itemizedlist>
<para
>Este tutorial cubre la instalación básica, ejecución y trabajo con &kst;. Está basado en la guía rápida de &kst; de Barth Netterfield. Está invitado a investigar con más profundidad cualquiera de las características en cualquier momento.</para>

</sect1>

<sect1 id="commandline">
<title
>Iniciar &kst; desde la línea de órdenes</title>
<para
>Un uso habitual de &kst; es generar rápidamente gráficos de datos desde la línea de órdenes. Este método de generar gráficos no necesita de grandes conocimientos de la interfaz gráfica de usuario de &kst;, produciendo resultados inmediatos. </para>

<para
>Este tutorial utiliza un paquete de datos de demostración que está instalado junto con &kst; en <filename class="directory"
>$<envar
>KDEDIR</envar
>/share/apps/kst/tutorial</filename
>, dónde <filename class="directory"
>$<envar
>KDEDIR</envar
></filename
> es la ubicación en la que se instaló &kde; en su sistema (puede encontrar este valor utilizando la orden <command
>kde-config --prefix</command
>).</para>

<note
><para
>Si tiene una versión de &kst; anterior a la 1.1.0, puede encontrar los datos del tutorial en <ulink url="http://omega.astro.utoronto.ca/kst/tutorial/kst_tutorialdata.tgz"
>http://omega.astro.utoronto.ca/kst/tutorial/kst_tutorialdata.tgz</ulink
>. Descargue y descomprima el paquete, y a continuación vaya al directorio resultante: <screen
><userinput
><command
>tar -zxvf kst_tutorialdata.tgz</command>
<command
>cd kst_tutorialdata</command
></userinput
></screen>

</para>
</note>

<para
>Para obtener una vista general de todas las opciones disponibles en la línea de órdenes para &kst;, teclee: <screen
><userinput
><command
>kst --help</command
></userinput
></screen>
</para>
<para
>Se mostrará una descripción de la sintaxis y una lista de órdenes similar a la siguiente: <screen
>Uso: kst [Opciones de Qt] [Opciones de KDE] [opciones] [Archivos]

Kst: un programa para ver datos.

Opciones genéricas:
  --help                    Muestra ayuda sobre las opciones
  --help-qt                 Muestra las opciones específicas de Qt
  --help-kde                Muestra las opciones especificas de KDE
  --help-all                Muestra todas las opciones
  --author                  Muestra información del autor
  -v, --version             Muestra información de la versión
  --license                 Muestra información de la licencia
  --                        Fin de las opciones

Opciones:
  -F &lt;dataFile&gt;             Especifica el archivo de datos: utilizado para sobreescribir el archivos predeterminado de kst [|]
  -y &lt;Y&gt;                    Campo para el eje Y (se permiten varios)
  --ye &lt;equation&gt;           Ecuación para el eje Y (se permiten varias)
  -e &lt;E&gt;                    Campo para los errores del eje Y (se permiten varias)
  -x &lt;X&gt;                    Campo para el rango del eje X [INDEX]
  --xe &lt;X&gt;                  Vector X para las ecuaciones x0:x1:n [INDEX]
  -p &lt;Y&gt;                    Campo para el espectro de potencia (se permiten varias)
  -h &lt;Y&gt;                    Campo para el histograma (se permiten varias)
  -r &lt;f&gt;                    Tasa de muestra del espectro de potencia [60.0]
  --ru &lt;U&gt;                  Unidades para el ratio de muestra psd [Hz]
  --yu &lt;U&gt;                  Unidades para los vectores y [V]
  -l &lt;P&gt;                    La longitud de los FFTs es 2^P [10]
  -f &lt;F0&gt;                   Primera estructura a leer [-2]
  -n &lt;NS&gt;                   Número de estructuras a leer [-2]
  -s &lt;NS&gt;                   Número de estructuras a ignorar en cada lectura [-1]
  -a                        Aplicar el filtro boxcar antes de ignorar las estructuras
  -m &lt;NC&gt;                   Separar gráficos ordenados en &lt;NC&gt; columnas
  -d                        Mostrar como puntos en lugar de como curvas
  -g                        Proporciona un cuadro con la leyenda
  --print &lt;file&gt;            Imprime en un archivo y sale [&lt;none&gt;]
  --png &lt;file&gt;              Guarda como un archivo png y sale [&lt;none&gt;]

Argumentos:
  Archivos                 Archivos de datos (si se ha utilizado -y) o archivos *.kst
</screen>
</para>

<para
>Las opciones específicas de &kst; se listan en la sección <literal
>Opciones</literal
>. Siempre que sea adecuado utilice los valores predeterminados que son los que están entre corchetes al final de la descripción de la opción. Éstos valores serán los utilizados por cualquier opción no especificada. </para>

<para
>En primer lugar echaremos un vistazo al archivo ASCII <filename
>gyrodata.dat</filename
>, incluído en el paquete de demostración. Los archivos ASCII son uno de los muchos tipos de archivos que &kst; puede leer. En los archivos ASCII, los datos se colocan en columnas, correspondiendo cada columna a un campo, y los números de la columna (comenzando con el 1, de izquierda a derecha) corresponden a los nombre del campo. Éste archivo en particular contiene 3 columnas, y sus nombres serán 1, 2 y 3. Para dibujar un gráfico de la primera columna, teclee: <screen
><userinput
><command
>kst -y 1 gyrodata.dat</command
></userinput
></screen>

</para>
<para
>Se dibujarán todos los datos de la primera columna: </para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-tutorial-gyro1.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
<para
>Tenga en cuenta que no se especifica campo para el eje X del gráfico, de forma que &kst; utiliza el vector INDEX predeterminado, tal y como era de esperar. El vector INDEX es un vector especial de &kst; que contiene valores enteros desde 0 hasta N-1, donde N es el número de datos del correspondiente vector del eje Y. Cierre &kst; seleccionando <guimenuitem
>Salir</guimenuitem
> del menú <guimenu
>Archivo</guimenu
>, o tecleando <keycombo action="simul"
><keycap
>Ctrl</keycap
><keycap
>Q</keycap
></keycombo
>. </para>

<para
><filename
>gyrodata.dat</filename
> contiene 20.000 estructuras, por tanto solo deseará ver una parte de los mismas. Para dibujar solo 10.000 comenzando desde aquella que hace el número 7.000, teclee: <screen
><userinput
><command
>kst -y 1 -f 7000 -n 10000 gyrodata.dat</command
></userinput
></screen>

</para>

<para
>Una de las potencialidades de &kst; es la capacidad de dibujar datos en tiempo real. Imagine que se deben añadir continuamente datos nuevos al final de <filename
>gyrodata.dat</filename
>. En este escenario, sería práctico dibujar solo los puntos más recientes de los datos. Para dibujar solo las últimas 10.000 estructuras de <filename
>gyrodata.dat</filename
>, introduzca lo siguiente: <screen
><userinput
><command
>kst -y 1 -n 10000 gyrodata.dat</command
></userinput
></screen>
</para>
<para
>Si <filename
>gyrodata.dat</filename
> se actualizase, el gráfico se desplazaría continuamente, mostrando solo las últimas 10.000 estructuras. </para>

<para
>En lugar de leer directamente un archivo de entrada, &kst; puede utilizar datos ASCII desde la fuente de datos de la entrada estándar. Para especificar la entrada estándar como una entrada, introduzca <filename
>stdin</filename
> con uno de los nombres de los archivos. Existen muchos usos de esta capacidad, como utilizar &kst; como parte de una secuencia de «tuberías»: <screen
><userinput
><command
>cat gyrodata.dat | awk '{print $1 + 2}' | kst -y 1 stdin</command
></userinput
></screen>
</para>
<para
>La orden anterior utiliza <command
>awk</command
> para añadir 2 a la columna uno de <filename
>gyrodata.dat</filename
> antes de enviar el resultado a &kst;. </para>

<para
>Tenga en cuenta que la descripción de la opción <option
>y</option
> indica que se permiten varias instancias de la opción. Ésto permite dibujar rápidamente más de una curva, e incluso más de una gráfico. Para dibujar los tres campos de <filename
>gyrodata.dat</filename
> en gráficos separados, introduzca lo siguiente: <screen
><userinput
><command
>kst -y 1 -y 2 -y 3 -m 1 gyrodata.dat</command
></userinput
></screen>

</para>
<para
>La opción <option
>m</option
> especifica que se deben utilizar gráficos separados en lugar de un solo gráfico, tal y como se muestra a continuación: </para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-tutorial-gyro-multiple.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>

</sect1>

<sect1 id="datawizard-tour">
<title
>Una introducción rápida al asistente de datos</title>
<para
>Aunque el uso de &kst; desde la línea de órdenes es rápido, pueden existir situaciones en las que sea sencillo importar datos desde el interfaz gráfico de usuario (por ejemplo, si ya tuviera abierto &mdash;con otros datos cargados&mdash;). O, simplemente puede preferir utilizar la interfaz gráfica de usuario. Familiarizarse con ambos métodos de importación de datos le permitirá hacer un uso más eficiente de &kst;. </para>

<para
>El asistente de datos proporciona una forma rápida y sencilla de crear vectores, curvas y gráficos en &kst; a partir de los datos de los archivos. Para iniciar el asistente, seleccione <guimenuitem
>Asistente de datos...</guimenuitem
> desde el menú <guimenu
>Datos</guimenu
> o pulse el botón <inlinemediaobject
> <imageobject
> <imagedata fileref="Icon-kst-datawizard.png" format="PNG"/> </imageobject
> </inlinemediaobject
> en la barra de herramientas. Se le pedirá que seleccione una fuente de datos. Navegue hasta el archivo <filename
>gyrodata.dat</filename
> utilizado en los ejemplos de la línea de órdenes y pulse <guibutton
>Siguiente</guibutton
>. Se mostrará la siguiente ventana: </para>

<screenshot>
<screeninfo
>Pantalla 2 del asistente de importación de datos</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-datawizard2.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Pantalla 2 del asistente de importación de datos</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Los campos disponibles en <filename
>gyrodata.dat</filename
> se listan en la parte izquierda. Puede filtrar la lista de campos resaltados introduciendo un texto (también están soportados los comodines, como <literal
>*</literal
>) en el cuadro de texto situado sobre la lista. Marque las casillas para los campos de las casillas <guilabel
>1</guilabel
>, <guilabel
>2</guilabel
> y <guilabel
>3</guilabel
>. </para>

<para
>La sección <guilabel
>Rango de datos</guilabel
> se utiliza para especificar el rango de datos que se leerán de los vectores seleccionados en el archivo de entrada. La siguiente explicación asume el conocimiento de las «estructuras». En resumen, una estructura solo es un número de muestras de datos, y cada uno de los archivos de datos está formado por una serie de estructuras. Para obtener una descripción de este concepto, consulte <xref linkend="supportingadditionalfileformatsdatasourceconceptsframes"/>. </para>

<variablelist>
<varlistentry>
<term
><guilabel
>Inicio</guilabel
>, <guilabel
>Contador de fin</guilabel
>, <guilabel
>Rango</guilabel
> y <guilabel
>Leer hasta el final</guilabel
> </term>
<listitem>
<para
>Utilizando estas cuatro configuraciones, podrá definir los límites superior e inferior del rango de datos. Como ejemplo, seleccione <guilabel
>Contador de fin</guilabel
> e introduzca 10.000 en <guilabel
>Rango</guilabel
> para leer solo las 10.000 últimas estructuras. Si <filename
>gyrodata.dat</filename
> se hubiera actualizado en tiempo real, los siguientes datos se añadirían al final del archivo. </para>

</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Leer 1 muestra por N estructuras</guilabel
> y <guilabel
>Primer filtro Boxcar</guilabel
> </term>
<listitem>
<para
>Además de los límites superior e inferior, se pueden establecer las muestras a leer del rango seleccionado. Si <guilabel
>Leer 1 muestra cada N estructuras</guilabel
> (donde N es el valor introducido) no está seleccionado, se leerán todas las muestras. Además, las estructuras en cada archivo de datos pueden ignorarse seleccionando <guilabel
>Leer 1 muestra cada N estructuras</guilabel
>. Por el momento, no seleccione <guilabel
>Leer 1 muestra cada N estructuras</guilabel
>. </para>
</listitem>
</varlistentry>
</variablelist>

<para
>La configuración del espectro de potencia y del eje X pueden especificarse en la sección <guilabel
>Tipos de gráfico</guilabel
>. </para>

<variablelist>

<varlistentry>
<term
><guilabel
>XY</guilabel
>, <guilabel
>Espectro de potencia</guilabel
>, y <guilabel
>Espectro de potencia y XY</guilabel
> </term>
<listitem>
<para
>Seleccione <guilabel
>Espectro de potencia y XY</guilabel
> para generar gráficos de los dos datos y del espectro de potencia. Para obtener más información de las opciones disponibles para el espectro de potencia, consulte <xref linkend="power-spectra"/>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Vector del eje X</guilabel>
</term>
<listitem>
<para
>El vector que se utilizará como vector independiente para los gráficos. Puede seleccionar un campo de un archivo de datos, o el vector INDEX. Como <filename
>gyrodata.dat</filename
> no contiene un vector para el eje X, deje la selección en INDEX. </para>
</listitem>
</varlistentry>

</variablelist>

<para
>La subsección <guilabel
>Opciones FFT</guilabel
> en la sección <guilabel
>Tipos de gráfico</guilabel
> está disponible solo si se va a dibujar un espectro de potencia. Este tutorial no tratará los detalles del espectro de potencia, por tanto utilice las configuraciones predeterminadas para esta subsección. </para>

<para
>Una vez que esté satisfecho con toda la configuración, pulse <guibutton
>Siguiente</guibutton
> para avanzar hasta la siguiente ventana. </para>

<screenshot>
<screeninfo
>Pantalla 3 del asistente de importación de datos</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-datawizard3.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Pantalla 3 del asistente de importación de datos</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Desde aquí, puede cambiar la configuración general del gráfico. La mayor parte de los elementos de la configuración son auto explicativos. Seleccione <guilabel
>1 punto nuevo por curva</guilabel
> para <guilabel
>Situar curva</guilabel
> y <guilabel
>En nueva ventana</guilabel
> para <guilabel
>Situar gráfico</guilabel
>. Ésto colocará los seis puntos (tres curvas y tres espectros de potencia) en la misma ventana. </para>


<para
>Una vez que esté satisfecho con todas las configuraciones, pulse <guibutton
>Finalizar</guibutton
> y se generarán los gráficos: </para>
<screenshot>
<screeninfo
>Los gráficos generados</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-tutorial-datawizard-done.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Los gráficos generados</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Generar estos gráficos dará un poco de trabajo, por ello, podemos guardar la sesión actual de &kst; (se utilizará en la siguiente sección de este tutorial). Seleccione <guimenuitem
>Guardar como...</guimenuitem
> del menú <guimenu
>Archivo</guimenu
>, y guarde la sesión como <filename
>misesiónkst.kst</filename
>: </para>

<screenshot>
<screeninfo
>Guardar una sesión de KST</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-filesave.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Guardar una sesión de KST</phrase>
</textobject>
</mediaobject>
</screenshot>
<para
>Guardar una sesión de &kst; guardará todos los gráficos, objetos de datos (luego veremos esto), y distribuciones que ya existan en el momento de la grabación. </para>
<para
>Una vez que se haya guardado el archivo, podrá salir de &kst;. </para>
</sect1>

<sect1 id="mousezooming">
<title
>Las bases de la manipulación de los gráficos</title>
<para
>Ahora que ya está cómodo creando gráficos en &kst;, podemos explorar algunas de las características de manipulación de gráficos utilizando la interfaz gráfica de usuario de &kst;. Inicie &kst; desde la línea de órdenes con el archivo <filename
>misesiónkst.kst</filename
> que guardó antes: </para>
<screen
><userinput
><command
>kst misesiónkst.kst</command
></userinput
></screen>
<para
>Se cargarán en &kst; todos los puntos que creó antes. Examine en el gráfico la etiqueta <literal
>PSD [V/Hz^{1/2}]</literal
> en el eje y. Para ver más de cerca el gráfico, pulse con el botón derecho sobre él y seleccione el elemento de menú <guimenuitem
>Maximizar</guimenuitem
>, tal y como se muestra a continuación: </para>
<screenshot>
<screeninfo
>Maximizar un gráfico</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-zoom.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Maximizar un gráfico</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Ahora el gráfico estará maximizado en la ventana actual. Observe la x en la parte superior de este gráfico que está prácticamente plana, por tanto debería ser práctico ver solo el área del gráfico que resulte interesante. Para hacer esto, asegúrese de que está en el modo Ampliación del ratón XY (seleccione <guimenuitem
>Ampliación del ratón XY</guimenuitem
> en el menú <guimenu
>Gráficos</guimenu
>, o pulse el botón <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-xymousezoom.png" format="PNG"/></imageobject
></inlinemediaobject
> de la barra de herramientas). A continuación, dibuje un rectángulo sobre el área que sea de su interés. Tenga en cuenta que las coordenadas del cursor del ratón se mostrarán en la esquina inferior derecha de la ventana de &kst; (sino, asegúrese que <guimenuitem
>Mostrar barra de estado</guimenuitem
> está marcado en el menú <guimenu
>Preferencias</guimenu
>). </para>

<para
>Los ejes del gráfico cambiarán para «ampliar» el área seleccionada del gráfico. Verá que existe un pico en el lado izquierdo del espectro de potencia que se extiende más allá del nuevo límite del eje y superior. Imagine que desea ver la parte superior de este pico. Pulse con el botón derecho en este gráfico y seleccione <guimenuitem
>Arriba</guimenuitem
> en el submenú <guimenu
>Desplazamiento</guimenu
>. Los gráficos deberían desplazarse hacia arriba. Por supuesto, es mucho más sencillo utilizar la tecla de acceso rápido asociada con el elemento del menú. Ésto es correcto para la mayor parte de las funciones de ampliación y desplazamiento. En este caso, el acceso rápido es <keysym
>Flecha arriba</keysym
>, por tanto, la forma más rápida de desplazarse hacia arriba es mantener pulsada la tecla <keysym
>Flecha arriba</keysym
>. Para volver a la ampliación máxima en cualquier momento, pulse con el botón derecho en el gráfico y seleccione <guimenuitem
>Ampliación máxima</guimenuitem
> en el submenú <guisubmenu
>Ampliar</guisubmenu
> (o teclee <keycap
>M</keycap
>, el acceso rápido asociado con <guimenuitem
>Ampliación máxima</guimenuitem
>). </para>

<para
>Restaure el tamaño del gráfico del espectro de potencia pulsando con el botón derecho y quitando la marca a <guimenuitem
>Maximizar</guimenuitem
>. </para>

<para
>Ahora vea los gráficos con los ejes y etiquetados como <literal
>Columna 2</literal
> y <literal
>Columna 3</literal
>. Éstos son gráficos del giroscopio de inclinación y desplazamiento, respectivamente, del vuelo BOOMERANG de 1998. Como estos dos gráficos están relacionados, puede ser práctico ampliarlos y desplazarlos simultáneamente. Pulse en los cuadrados situados en la esquina superior derecha de los dos gráficos. Debería oscurecerse para indicar que los dos gráficos están relacionados entre sí: </para>

<screenshot>
<screeninfo
>Ampliación vinculada</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-tiedzoom.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Ampliación vinculada</phrase>
</textobject>
</mediaobject>
</screenshot>
<para
>Antes de intentar realizar la ampliación, deberíamos borrar todos los demás gráficos con los que no estemos trabajando. Seleccione <guimenuitem
>Modo de distribución</guimenuitem
> en el menú <guimenu
>Gráficos</guimenu
> o pulse el botón <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-layoutmode.png" format="PNG"/></imageobject
></inlinemediaobject
> de la barra de herramientas. Para cada gráfico que no sea los dos que necesitamos, pulse con el botón derecho en el gráfico y seleccione <guimenuitem
>Borrar</guimenuitem
>. A continuación pulse con el botón derecho en la ventana actual y seleccione <guimenuitem
>Limpiar distribución</guimenuitem
>. Ahora los dos gráficos deberían compartir el máximo espacio dentro de la ventana. Vuelva al modo Ampliación del ratón XY cuando haya terminado. </para>

<para
>Ahora intentaremos ampliar una parte del gráfico superior. Verá que el gráfico inferior se vuelve blanco. Ésto se debe a que el gráfico inferior ha cambiado para coincidir con el gráfico superior, y no hay datos en esta región en particular del gráfico inferior. Teclee <keycap
>M</keycap
> mientras el cursor del ratón está sobre un gráfico para volver a la ampliación máxima de ambos gráficos. Ahora mantenga pulsada la tecla <keycap
>Ctrl</keycap
> (es equivalente a seleccionar <guimenu
>Modo de ampliación del ratón X</guimenu
> en el menú <guimenu
>Gráficos</guimenu
> o pulsar el botón <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-xmousezoom.png" format="PNG"/></imageobject
></inlinemediaobject
> en la barra de herramientas). El cursor del ratón cambiará su forma para dar información visual. Mientras mantiene pulsada la tecla <keycap
>Ctrl</keycap
>, dibuje un rectángulo en el gráfico superior. Tenga en cuenta que la altura del rectángulo está restringida y por eso solo se ampliará el eje x. Ahora ambos gráficos mostrarán los datos que se ampliaron, ya que el eje y no se alteró. </para>
<tip>
<para
>Puede vincular o desvincular todos los gráficos de una ventana seleccionando <guimenuitem
>Ampliación vinculada</guimenuitem
> desde el menú <guimenu
>Gráficos</guimenu
> o pulsando el botón <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-tiedzoom.png" format="PNG"/></imageobject
></inlinemediaobject
> de la barra de herramientas. </para>
</tip>
<para
>Cuando haya terminado de experimentar con las características de ampliación, puede cerrar &kst;. En este momento no necesitaremos guardar los gráficos (a menos que lo desee). </para>

</sect1>



<sect1 id="overviewdataobjects">
<title
>Una breve introducción a los objetos de datos</title>
<para
>&kst; sirve para más cosas que para dibujar y ver gráficos de datos. Desde el asistente de datos, ya vió que &kst; puede crear espectros de potencia de los datos. En efecto, &kst; también puede crear otros objetos de datos como histogramas, ecuaciones y extensiones. Una utilidad llamada Administrador de datos puede ayudarle a registrar todos los objetos de datos que cree. </para>

<para
>Inicie &kst; con el archivo <filename
>demo.kst</filename
>, incluído en el paquete de demostración: </para>
<screen
><userinput
><command
>kst demo.kst</command
></userinput
></screen>
<screenshot>
<screeninfo
>Kst con demo.kst</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-demo.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Kst con demo.kst</phrase>
</textobject>
</mediaobject>
</screenshot>
<para
>Esta sesión de &kst; contiene vectores y otros objetos de datos creados a partir de los datos de <filename
>gyrodata.dat</filename
>. El gráfico superior contiene los datos del acimut, el gráfico central muestra la inclinación en azul, y el inferior muestra el espectro de potencia de los datos de la inclinación en azul. Veamos los gráficos más de cerca. Vincule los dos gráficos superiores utilizando las técnicas que aprendió en la sección anterior. A continuación mantenga pulsada la tecla <keycap
>Ctrl</keycap
> para entrar en el modo de Ampliación del ratón X. Ahora amplie una región pequeña del gráfico superior (digamos entre 50.000 y 53.000), para hacer que los dos gráficos vinculados se amplíen. Verá que la curva de inclinación en azul está correlacionada negativamente con la curva del acimut en rojo. Ésto se debe a que el giroscopio de inclinación está ligeramente girado respecto al acimut del eje (por -0,69 grados). La inclinación real <literal
>p'</literal
> es: <informalequation
> <mediaobject
> <imageobject
> <imagedata fileref="Equation-kst-correctedpitch.png" format="PNG"/> </imageobject
> </mediaobject
> </informalequation
> donde <literal
>p</literal
> es la inclinación original, <inlinemediaobject
><imageobject
><imagedata fileref="Symbol-kst-theta.png" format="PNG"/></imageobject
></inlinemediaobject
> es la rotación del giroscopio de inclinación en relación con el eje del acimut, y <literal
>a</literal
> es el giroscopio del acimut. <literal
>p'</literal
> se dibuja como una curva en negro en el gráfico central. El espectro de potencia <literal
>p'</literal
> es la curva negra en el gráfico inferior. </para>

<para
>Ahora veamos cómo se crean los tres gráficos. Para mostrar el Administrador de los datos, seleccione <guimenuitem
>Administrador de datos...</guimenuitem
> en el menú <guimenu
>Datos</guimenu
>, o pulse el botón <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-datamanager.png" format="PNG"/></imageobject
></inlinemediaobject
> de la barra de herramientas: </para>
<screenshot>
<screeninfo
>El administrador de datos</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-datamanager.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>El administrador de datos</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>El administrador de datos contiene la lista definitiva de los objetos de datos de la sesión actual de &kst;. También le permite editar o crear nuevos objetos de datos. Como puede ver, hay listadas seis curvas (cada una creada a partir de un par de vectores), una ecuación, dos espectros de potencia y cuatro vectores de datos. Pulse con el botón derecho sobre C2-GY_PITCH y seleccione <guimenuitem
>W1-P1</guimenuitem
> en el submenú <guisubmenu
>Eliminar del gráfico</guisubmenu
>. Ésto eliminará la curva del gráfico P1 en la ventana W1. Elimine también C-PSD2-V3-GY_PITCH del gráfico P3 en la ventana W1 utilizando el mismo procedimiento. Ahora solo deberían mostrarse las curvas correctas en los gráficos: </para>

<screenshot>
<screeninfo
>Sólo las curvas correctas</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-democorrected.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Sólo las curvas correctas</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Para ver cómo se creó el giroscopio de inclinación, resalte C4-cleaned_pitch y pulse el botón <guibutton
>Editar</guibutton
>. Debería mostrarse el diálogo de edición de la ecuación: </para>
<screenshot>
<screeninfo
>Editar ecuación</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-editequation.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Editar ecuación</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Observe que la ecuación utilizada para calcular <literal
>p'</literal
> se introdujo en el cuadro de texto <guilabel
>Ecuación</guilabel
> (se utilizó una aproximación de 1 para <literal
>cos(-0,69)</literal
>). Pulse el botón <guibutton
>Aceptar</guibutton
> (para guardar los cambios hechos) o <guibutton
>Cancelar</guibutton
> cuando haya terminado. </para>

<para
>Observe que todos los objetos de datos tienen un número situado bajo la columna <guilabel
># Usado</guilabel
>. Este número indica el número de veces que el objeto de datos es utilizado por otros objetos de datos o gráficos. Como se eliminaron una curva y un espectro de potencia, al menos dos objetos de datos deberían tener 0 en esta columna. Pulse <guibutton
>Eliminar</guibutton
> para eliminar de forma permanente todos los objetos que no se usen. </para>

<para
>Pulse <guibutton
>Cerrar</guibutton
> para cerrar el Administrador de datos. Cuando haya terminado puede salir de &kst;. </para>
</sect1>

<sect1 id="pluginsandevents">
<title
>Un vistazo a las extensiones y eventos</title>
<para
>Para terminar este viaje por &kst; veremos dos tipos de datos específicos: las extensiones y los monitores de eventos. </para>

<para
>Una extensión es un objeto de datos flexible cuyo comportamiento depende del archivo de extensiones específico seleccionado. El archivo de extensión puede ser uno de los incluídos con la distribución estándar de &kst;, o puede ser un archivo de extensión creado por terceros. Puede encontrar instrucciones para crear y compilar archivos personalizados de extensiones en <xref linkend="creatingplugins"/>. Las extensiones permiten a &kst; realizar operaciones arbitrarias con un conjunto de datos, ya que el único requisito para un archivo de extensión es que reciba un conjunto de vectores de entrada y escalares, y de como resultado un conjunto de vectores y escalares. </para>

<para
>Como ejemplo, intentaremos ajustar un línea sencilla a un pequeño conjunto de puntos de datos. Inicie &kst; con un gráfico del primer campo de los datos del archivo <filename
>maxima.dat</filename
> incluído en el paquete de demostración: </para>

<screen
><userinput
><command
>kst -y 1 -d maxima.dat</command
></userinput
></screen>

<para
>La opción <option
>d</option
> especifica que solo deberían dibujarse los puntos, no las líneas. Ahora se mostrara el gráfico de los puntos de datos: </para>
<screenshot>
<screeninfo
>Gráfico de los puntos de datos</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-maxima-datapoints.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Gráfico de los puntos de datos</phrase>
</textobject>
</mediaobject>
</screenshot>
<para
>Ahora, abra el Administrador de datos. Pulse <guibutton
>Extensión...</guibutton
> en la sección <guilabel
>Nuevo</guilabel
> para crear un objeto de extensión nuevo. En <guilabel
>Selecionar extensión</guilabel
>, seleccione la extensión <guimenuitem
>Ajuste lineal</guimenuitem
>. Esta extensión en particular necesita dos vectores de entrada: uno conteniendo los valores x y otro conteniendo los valores y de los puntos de datos que se van a ajustar. Seleccione <guimenuitem
>INDEX</guimenuitem
> para el <guilabel
>Vector de entrada - Matriz X</guilabel
>, y <guimenuitem
>1</guimenuitem
> para <guilabel
>Vector de entrada - Matriz Y</guilabel
>. A continuación pulse <guibutton
>Aceptar</guibutton
>. Verá que la nueva extensión creó vectores esclavos para guardar las salidas. Pulse en <guibutton
>Curva...</guibutton
> para crear una curva nueva a partir de los vectores de salida. Seleccione <guimenuitem
>V1-INDEX</guimenuitem
> para <guilabel
>Vector del eje X</guilabel
> y <guimenuitem
>P1-kstfit_linear_unweighted-Y Fitted</guimenuitem
> para <guilabel
>Vector del eje Y</guilabel
>. Deseamos situar la curva en la parte superior de los puntos de datos en el gráfico existente, así que en <guilabel
>Colocar curva</guilabel
>, seleccione <guilabel
>Colocar en el gráfico existente</guilabel
> y quite la selección en <guilabel
>Colocar en gráfico nuevo</guilabel
>. Finalmente, pulse <guibutton
>Aceptar</guibutton
> para crear la curva. Cierre el administrador de datos para ver la línea ajustada: </para>

<screenshot>
<screeninfo
>Línea ajustada</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-fittedline.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Línea ajustada</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Un procedimiento similar al que acaba de seguir le permitirá crear y dibujar gráficos del resultado de cualquier tipo de objeto. Sin embargo, existe un acceso rápido para crear extensiones de ajuste. Pulse con el botón derecho en un gráfico, de forma que se muestre un menú contextual, que contendrá un submenú <guisubmenu
>Ajustar...</guisubmenu
>. Seleccionando una curva del submenú se mostrará el diálogo de ajuste de la función con los vectores x e y preseleccionados. Después de seleccionar la extensión de ajuste, pulsar el botón <guibutton
>Aceptar</guibutton
> creará el objeto de la extensión, creando la curva a partir de la salida de la extensión y colocando la curva en el gráfico existente. </para>

<para
>Echemos un vistazo a los eventos. Los objetos de los eventos suelen monitorizar otros vectores o escalares y realizar las acciones especificadas cuando se den ciertas condiciones con estos vectores o escalares. Pulse <guibutton
>Monitor de eventos...</guibutton
> en la sección <guilabel
>Nuevo</guilabel
> del Administrador de datos para crear un evento nuevo: </para>
<screenshot>
<screeninfo
>Monitor de evento</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-eventmonitor.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Monitor de evento</phrase>
</textobject>
</mediaobject>
</screenshot>

<!-- FIXME: This seems to be incorrect: the equation given doesn't work -->
<para
>Imagine que los datos del giroscopio de inclinación se actualizasen en tiempo real, y lo que deseamos es que se nos avise cuando el giroscopio de inclinación se saliese del intervalo <literal
>[-0,60, -0,40]</literal
> Para configurar el evento de esta forma, introduzca lo siguiente en el cuadro de texto <guilabel
>Expresión</guilabel
>: </para>

<para>
<literal
>[C4-cleaned_pitch-sv]&gt;(-0.40) | [C4-cleaned_pitch-sv]&lt;(-0.60)</literal>
</para>

<para
>Tenga en cuenta que todo lo que se introduzca debe ser una expresión lógica. Ésta expresión en particular será verdadera si cualquiera de las dos desigualdades es verdadera. Seleccione <guilabel
>Registrar como</guilabel
> y <guilabel
>Notificar</guilabel
>, e introduzca su dirección de correo electrónico en la parte derecha del cuadro de texto <guilabel
>Notificación</guilabel
>. Pulse <guibutton
>Aceptar</guibutton
> y se creará el evento. </para>

<para
>Ahora seleccione <guimenuitem
>Depurar Kst...</guimenuitem
> en el menú <guimenu
>Ayuda</guimenu
>. Pulse la pestaña <guilabel
>Registro</guilabel
> para ver el registro de depuración. Si el evento estuviera configurado correctamente, debería ver un aviso indicando que los valores de x para los que se inició el evento. Verifique que los valores coinciden aproximadamente con los que esperaría ver en el gráfico: </para>

<screenshot>
<screeninfo
>Registro de depuración</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-debuglog.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Registro de depuración</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Si los datos del giroscopio de inclinación se actualizasen en tiempo real, el monitor de evento se iniciaría para cualquier dato nuevo cada vez que se necesitase. </para>

<para
>Una vez que lo haya hecho, puede cerrar &kst;. </para>
</sect1>


<sect1 id="conclusion">
<title
>Conclusión</title>

<para
>Aquí concluye este tutorial de &kst;. Esperamos que haya ganado conocimientos suficientes para sentirse cómodo con &kst;. Piense que este tutorial no cubre todas las funcionalidades de &kst;: hay mucho que explorar y experimentar. El resto de este manual es una guía en profundidad sobre los conceptos que van desde los fundamentos de la disposición de la ventana hasta la creación de extensiones personalizadas y los lectores de fuentes de datos. Le invitamos a utilizar &kst; de formas interesantes e innovadoras: encontrará no obstante que no solo se corresponde con sus necesidades, sino que excede sus necesidades y requerimientos. </para>
</sect1>


</chapter>

<!-- Keep this comment at the end of the file
Local variables:
mode: xml
sgml-omittag:nil
sgml-shorttag:nil
sgml-namecase-general:nil
sgml-general-insert-case:lower
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:0
sgml-indent-data:true
sgml-parent-document:("index.docbook" "book" "chapter")
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->

