<chapter id="workingwithdata">
<title
>Trabajando con datos</title>

<sect1 id="fileformats">
<title
>Formatos de archivos soportados</title>
<para
>En la actualidad, Kst soporta como fuentes de datos archivos tipo texto en ASCII, estructuras BOOMERANG, y directorios BLAST, así como PIOLib y FITS teniendo las librerías apropiadas. Esta sección describe los conceptos básicos de fuentes de datos comunes a todos los archivos de datos, y concretamente, detalla los archivos de texto ASCII y directorios BLAST. </para>

<sect2 id="supportingadditionalfileformatsdatasourceconcepts">
<title
>Conceptos de fuentes de datos</title>
<para
>Una fuente de datos en &kst; es simplemente un tipo de archivos soportados. Los conceptos siguientes son importantes para comprender como &kst; funciona con fuentes de datos diferentes. Se introduce algo de terminología en esta sección. </para>

<sect3 id="supportingadditionalfileformatsdatasourceconceptssamples">
<title
>Muestras</title>
<para
>Una muestra se considera a la unidad fundamental con respecto a los archivos de datos. Cada muestra consiste de un valor de los datos en el archivo. Notar que una muestra puede no corresponder a un valor en un vector de datos en &kst; debido al concepto de <link linkend="supportingadditionalfileformatsdatasourceconceptsframes"
>estructuras</link
>. </para>
</sect3>

<sect3 id="supportingadditionalfileformatsdatasourceconceptsfields">
<title
>Campos</title>
<para
>Una campo corresponde a un vector en &kst;. Por ejemplo, un vector en un archivo de datos ASCII se considera como un solo campo. Cada campo puede tener un nombre explícito o implícito. Los lectores de datos suministran funciones para leer y obtener campos y sus nombres. </para>
</sect3>

<sect3 id="supportingadditionalfileformatsdatasourceconceptsframes">
<title
>Estructuras</title>
<para
>Una estructura corresponde a un número especificado de muestras, y cada campo en un archivo de datos puede tener su propia relación de muestras por estructura. El tamaño del archivo de datos se mide por el número de estructuras que contiene. Para un archivo de datos ASCII, el número de muestras por estructura es 1, pero para otros archivos de datos, puede haber muchas muestras por estructura. En la ilustración de abajo, se muestran las primeras 3 estructuras de un archivo de datos imaginario. En este archivo, el campo 1 posee 5 muestras por estructura, el campo 2 posee 2 muestras por estructura,  el campo 3 posee 3 muestras por estructura, y el campo 4 posee 1 muestra por estructura. </para>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Diagram-kst-frames.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</para>
<para
>Dependiendo en la configuración de un vector de datos específico en &kst;, los datos de los archivos pueden leerse como estructuras en vez de como muestras, con la primera muestra en una estructura o la media de todas las muestras en una estructura representando el valor de dicha estructura. </para>
</sect3>

<sect3 id="supportingadditionalfileformatsdatasourceconceptsindex">
<title
>Campo INDEX</title>
<para
>Algunos archivos de datos puede que no posean un campo adecuado para representar el eje x en un gráfico. No obstante, &kst; crea de forma implícita un campo INDEX para todas las fuentes de datos. El campo INDEX simplemente contiene enteros desde 0 a N-1, donde N es el número de estructuras en el archivo de datos. </para>
</sect3>

</sect2>

<sect2 id="creatingascii">
<title
>Archivos de entrada en ASCII</title>
<para
>El formato de entrada de datos más sencillo es un archivo de textos en ASCII. Estos pueden leerse fácilmente y pueden crearse a mano fácilmente o por medio de scripts sencillas. Este es un ejemplo de un archivo de entrada en ASCII: </para>

<informalexample>
<screen
>112.5 3776 428
187.5 5380 429
262.5 5245 345
337.5 2942 184
412.5 1861 119
487.5 2424 138
567.5 2520 162
637.5 1868 144
712.5 1736 211
787.5 1736 211
862.5 2172 292
937.5 1174 377
1000.5 499 623
</screen>
</informalexample>

<para
>Cada columna de este archivo representa un campo, mientras que cada campo representa una estructura. Las columnas se separan por tabuladores o espacios, y las filas están separadas por saltos de línea. Notar que debido a su estructura, los archivos ASCII no pueden tener múltiples muestras por estructura. Notar también que como las columnas no tienen etiquetas, los nombres de los campos asignados por &kst; se basan en el orden de las columnas (la columna más a la izquierda tiene el nombre de campo <literal
>1</literal
>). </para>

<para
>Las líneas comentadas en los archivos ASCII comienzan por uno de los caracteres en la serie <literal
>{#, !, /, ;, c}</literal
>. Todas las líneas que estén comentadas y las líneas vacías serán ignoradas por &kst;. Los números válidos incluyen aquellos con decimales, signos negativos, o <literal
>e</literal
>, para indicar notación científica. Números inválidos (tales como dados en palabras) los reemplaza &kst; con un 0. </para>

</sect2>


<sect2 id="blastdirfiles">
<title
>Directorios BLAST</title>
<para
>Los directorios de datos BLAST son en realidad directorios de archivos. Cada directorio representa una fuente de datos, y cada archivo en el directorio, con la excepción de un archivo llamado <filename
>format</filename
>, representa un campo simple. El archivo <filename
>format</filename
> lista cada campo y sus propiedades. He aquí un ejemplo de tal archivo: </para>
<informalexample>
<screen
>scount RAW f 1
fcount RAW f 20
sine RAW f 20
ssine RAW f 1
cos RAW f 20</screen>
</informalexample>
<para
>En este ejemplo, los nombres de los campos son <literal
>scount</literal
>, <literal
>fcount</literal
>, <literal
>sine</literal
>, <literal
>ssine</literal
>, y <literal
>cos</literal
>. <literal
>RAW</literal
> indica si el archivo está escrito en formato en bruto, y si el último número en cada fila es el número de muestras por estructura. </para>

<para
>Cuando se selecciona un directorio BLAST para usarse en &kst;, debe seleccionarse el directorio que contenga los archivos de campos. Entonces, &kst; buscará el archivo <filename
>format</filename
>, que si existe, determinará las propiedades de los campos. </para>

</sect2>
</sect1>

<sect1 id="datawizard">
<title
>El asistente de datos</title>
<para
>El asistente de datos da una forma rápida y fácil de crear vectores, curvas y gráficos en &kst; desde archivos de datos. Para lanzar el asistente, seleccionar <guimenuitem
>Asistente de datos...</guimenuitem
> en el menú <guimenu
>Datos</guimenu
>. Se le pedirá seleccionar una fuente de datos. Busque un archivo válido (o introduzca la ruta al archivo) y pulse sobre <guibutton
>Siguiente</guibutton
>. Aparecerá la ventana siguiente. </para>
<screenshot>
<screeninfo
>Pantalla del Asistente de datos 2</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-datawizard2.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Pantalla del Asistente de datos 2</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Seleccione los campos que desee importar en &kst;. Puede filtrar la lista de campos introduciendo una cadena a emparejar (están soportadas máscaras tales como <literal
>*</literal
>) en la casilla de texto sobre la lista. </para>

<para
>La sección <guilabel
>Rango de datos</guilabel
> se utiliza para especificar el rango de datos a leer de los vectores seleccionados en el archivo de entrada. La discusión siguiente presupone el conocimiento de <quote
>estructuras</quote
>. Para una descripción detallada de este concepto, ver <link linkend="fileformats"
>Formatos de Archivos</link
>. </para>
<variablelist>
<varlistentry>
<term
><guilabel
>Estructura de comienzo</guilabel
>, <guilabel
>Cuenta desde el final</guilabel
>, <guilabel
>Número de estructuras</guilabel
>, y <guilabel
>Leer hasta el final</guilabel
> </term>
<listitem>
<para
>Usando estas cuatro entradas, puede configurarse los valores inferior y superior del rango de datos. Por ejemplo, para leer desde las estructuras número 10 a la 900, introducir <userinput
>10</userinput
> en <guilabel
>Estructura de comienzo</guilabel
> y <userinput
>890</userinput
> para el <guilabel
>Número de estructuras</guilabel
>. Para leer desde la estructura número 500 hasta el final del archivo, introducir <userinput
>500</userinput
> para <guilabel
>Estructura de comienzo</guilabel
> y seleccionar la opción <guilabel
>Leer hasta el final</guilabel
>. Para leer solo las últimas 450 estructuras, seleccionar <guilabel
>Cuenta desde el final</guilabel
> e introducir <userinput
>450</userinput
> para el <guilabel
>Número de estructuras</guilabel
>. Las combinaciones mostradas en los dos últimos ejemplos son útiles para leer datos de un archivo que se actualiza en tiempo real. La adición posterior de datos al archivo se leerán, haciendo que los vectores asociados se actualicen también. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Leer 1 muestra cada N estructuras</guilabel
> y <guilabel
>primero el filtro Boxcar</guilabel
> </term>
<listitem>
<para
>Además de los valores de los extremos superior e inferior del rango, puede configurarse que muestras leer del rango seleccionado. Si <guilabel
>Leer 1 muestra cada N estructuras</guilabel
> no está seleccionada, entonces se leerán todas las muestras del rango. Alternativamente, pueden saltarse estructuras en el archivo de datos seleccionando <guilabel
>Leer 1 muestra cada N estructuras</guilabel
>. El valor de 1 muestra que se utilizará para representar la estructura depende de si se ha seleccionado  <guilabel
>Primero, el filtro Boxcar</guilabel
>. Sin no se ha seleccionado <guilabel
>Primero, el filtro Boxcar</guilabel
>, el valor es igual al de la primera muestra en la estructura. Si sí está seleccionado <guilabel
>Primero, el filtro Boxcar</guilabel
>, el valor es la media (promedio) de todas las muestras en la estructura dada. </para>
</listitem>
</varlistentry>
</variablelist>



<para
>El espectro de potencias y la configuración del eje X pueden configurarse dentro de la sección <guilabel
>Tipos de gráficos</guilabel
>. Veamos la descripción de tales variables. </para>

<variablelist>

<varlistentry>
<term
><guilabel
>XY</guilabel
>, <guilabel
>Espectro de potencia</guilabel
>, y <guilabel
>XY y espectro de potencia</guilabel
> </term>
<listitem>
<para
>Seleccionar si mostrar solo el espectro de potencia, solo datos (XY), o ambos. Si se selecciona mostrar el espectro de potencias, varias variables se vuelven disponibles. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Vector eje X</guilabel>
</term>
<listitem>
<para
>El vector a usarse como el vector independiente para los gráficos. Puede seleccionar un campo de su archivo de datos, o el vector INDEX. El vector INDEX es simplemente un vector que contiene elementos del 0 al N-1, donde N es el número de estructuras en el archivo de datos. </para>
</listitem>
</varlistentry>

</variablelist>

<para
>La subsección <guilabel
>Opciones FFT</guilabel
> en la sección <guilabel
>Tipos de gráficos</guilabel
> está disponible solo si se va a representar un espectro de potencias. La definición abajo presupone conocimientos básicos de espectros de potencias&mdash;para más detalles, ver Numerical Recipes in C: The Art of Scientific Computing, publicado por  Cambridge University Press. </para>

<variablelist>

<varlistentry>
<term
><guilabel
>Promedio entrelazado</guilabel
> y <guilabel
>Longitud FFT</guilabel
>  </term>
<listitem>
<para
>El espectro de potencias se define como <quote
>la raíz cuadrada del valor absoluto de la media de las Transformadas Rápidas de Fourier (FFT) entrelazado de longitud <literal
>2^x</literal
></quote
>, donde x es el valor introducido en la casilla de <guilabel
>Longitud de la FFT</guilabel
>. La selección de <guilabel
>Promedio entrelazado</guilabel
> permite especificar la longitud de las Transformadas Rápidas de Fourier entrelazado. Si no está <guilabel
>Promedio entrelazado</guilabel
>marcado,  <guilabel
>Promedio entrelazado</guilabel
><guilabel
>, &kst; determinará la longitud en base a la longitud del vector. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Unidades de datos</guilabel
> y <guilabel
>Unidades de tasa</guilabel
> </term>
<listitem>
<para
>Las unidades que se especifiquen en estas casillas se usarán para generar las etiquetas de los ejes de los gráficos. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guibutton
>Tasa de muestreo</guibutton>
</term>
<listitem>
<para
>La tasa de muestreo se usa para generar el eje X de los gráficos de espectros de potencias. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Limpiar la señal</guilabel>
</term>
<listitem>
<para
>Si se selecciona esta opción, los datos se limpian usando una ventana Hanning, para reducir las perdidas de bin a bin. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Eliminar la media</guilabel>
</term>
<listitem>
<para
>Seleccione esta opción para quitar la media de los datos seleccionados (esto es, traducir los datos de tal forma que la media sea cero). </para>
</listitem>
</varlistentry>
</variablelist>
<para
>Una vez que este contento con sus opciones, pulse sobre <guibutton
>Siguiente</guibutton
> para continuar con la ventana siguiente. Seleccione cualquier filtro que desee aplicar a los datos, y pulse sobre <guibutton
>Siguiente</guibutton
> para avanzar hasta la última ventana. </para>

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

<para
>Desde aquí, se pueden cambiar varias variables de configuración. La mayoría de las variables se explican a sí mismas. He aquí un breve sumario: </para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Estilo de curva</guilabel>
</term>
<listitem>
<para
>Selecciona si mostrar solo puntos de datos, solo líneas conectando los puntos de datos, o ambos. Por defecto, las líneas son continuas, con un peso 0, y los puntos de datos se marcan con cruces. Los colores de los puntos y las líneas se eligen de tal forma que líneas con igual color sean las mínimas.  </para>
</listitem>
</varlistentry>



<varlistentry>
<term>
<guilabel
>Emplazamiento de la curva</guilabel>
</term>
<listitem>
<para
>Selecciona el lugar para emplazar nuevas curvas. <guilabel
>Circular por las gráficas existentes</guilabel
> crea el número especificado de curvas y circula a través de cada gráfico, cada vez poniendo una curva nueva en el gráfico. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Generación de etiquetas</guilabel>
</term>
<listitem>
<para
>Selecciona las etiquetas y leyendas deseadas para situar en los gráficos. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Emplazamiento del gráfico</guilabel>
</term>
<listitem>
<para
>Selecciona la ventana(s) en la cual se desea mostrar los gráficos. Se pueden crear ventanas nuevas para los gráficos seleccionando <guilabel
>nueva ventana</guilabel
>. </para>
</listitem>
</varlistentry>

</variablelist>

<para
>Una vez que esté contento con la configuración, puede pulsar sobre <guibutton
>Finalizar</guibutton
> y se generarán los gráficos. </para>

</sect1>

<sect1 id="datamanager">
<title
>El gestor de datos</title>
<para
>El gestor de datos es el lugar en el cual se añaden, borran y modifican todos los objetos de datos que se usan en &kst. Puede accederse seleccionando <guimenuitem
>Gestor de datos</guimenuitem
> desde el menú <guimenu
>Datos</guimenu
>. </para>
<sect2 id="creatingdata">
<title
>Creando nuevos objetos de datos</title>
<para
>Para crear un nuevo objeto de datos en el gestor de datos, pulsar sobre uno de los botones listados bajo <guilabel
>Nuevo:</guilabel
>. Una ventana nueva aparecerá, en la cual se podrá configurar las opciones y valores para el nuevo objeto de datos.</para>

<tip
><para
>También puede crear curvas nuevas pulsando al botón derecho del ratón y eligiendo <guimenuitem
>Nueva Curva</guimenuitem
></para
></tip>

<para
>Como está creando un nuevo objeto de datos, puede introducir un nombre único que identifique el objeto. También puede usarse el nombre por defecto (si es único). </para>
<para
>La configuración de todos los objetos de datos representables tiene dos secciones comunes&mdash;Aspecto de la curva y Emplazamiento de la curva. Describimos a continuación estas secciones. Para configuraciones específicas de datos, ver <link linkend="datatypes"
>Tipos de datos</link
>. </para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-curveoptions.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>

<note>
<para
>Las <quote
>curvas</quote
> referidas más abajo son por lo general las líneas visibles y los puntos de una curva cuando se representa un objeto de datos&mdash;en general no se refieren a la <quote
>curva</quote
> del objeto de datos. </para>
</note>
<sect3 id="curveappearance">
<title
>Aspecto de la curva</title>
<para
>La sección Aspecto de la curva permite cambiar el aspecto del objeto de datos cuando se representa. </para>

<variablelist>

<varlistentry>
<term>
<inlinemediaobject
><imageobject
><imagedata fileref="Widget-kst-colourchooser.png" format="PNG"/></imageobject
></inlinemediaobject>
</term>
<listitem>
<para
>Pulsando sobre este botón se muestra un diálogo de elegir color, el cual puede usarse para cambiar el color de las líneas y de los puntos de la curva. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Mostrar puntos</guilabel>
</term>
<listitem>
<para
>Seleccionando esta casilla se muestran los puntos de datos usados para representar la curva. La lista desplegable a la derecha permite cambiar la forma de los puntos. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Mostrar líneas</guilabel>
</term>
<listitem>
<para
>Seleccionando esta casilla, se muestran las líneas que unen los puntos de datos de la curva. Pueden cambiarse tanto el grosor como el estilo de la línea. </para>
</listitem>
</varlistentry>

</variablelist>


</sect3>

<sect3 id="curveplacement">
<title
>Emplazamiento de la curva</title>
<para
>El emplazamiento de la curva especifica la posición de curvas nuevas. </para>

<variablelist>

<varlistentry>
<term>
<guilabel
>Ventana gráfica</guilabel>
</term>
<listitem>
<para
>Especifica la ventana en la cual mostrar la curva. Puede crear una ventana nueva pulsando sobre el botón <guibutton
>Nueva...</guibutton
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Colocar en un gráfico existente</guilabel
>, <guilabel
>Colocar en un nuevo gráfico</guilabel
> y <guilabel
>No colocar en ningún gráfico</guilabel
> </term>
<listitem>
<para
>Puede elegir si quiere o no colocar la curva sobre una curva ya existente. Si selecciona <guilabel
>Colocar en la gráfica existente</guilabel
>, también puede elegir reordenar la disposición de los gráficos seleccionando <guilabel
>Columnas</guilabel
> e introduciendo el número de columnas a usar en la nueva disposición. </para>
</listitem>
</varlistentry>

 

</variablelist>

<para
>Una vez tenga la configuración deseada para el nuevo objeto de datos, pulse sobre el botón <guibutton
>OK</guibutton
> para crear el nuevo objeto de datos. </para>

</sect3>

</sect2>

<sect2 id="editinganddeletingdata">
<title
>Editando y borrando objetos de datos existentes.</title>
<para
>Para editar un objeto de datos existentes, simplemente seleccionarlo en la ventana del gestor de datos y pulsar sobre <guibutton
>Editar</guibutton
>. Aparecerá la ventana de configuración del objeto seleccionado. Esta ventana es idéntica a la mostrada cuando se crean nuevos objetos de datos (con la excepción de que la sección de emplazamiento de la curva puede estar omitida), así que ver <link linkend="creatingdata"
>Creando nuevos objetos de datos</link
> para más información en la configuración y en las opciones. </para>
<para
>Para borrar un objeto de datos, seleccionarlo en la ventana del gestor de datos y pulsar sobre <guibutton
>Borrar</guibutton
>. Notar que para poder borrar el objeto, la entrada en la columna <guilabel
># Usado</guilabel
> de un objeto debe ser 0. la columna <guilabel
># Usado</guilabel
> indica el número de veces que un objeto de datos particular y sus descendientes se usan por curvas o por otros objetos de datos. A continuación se listan algunas consecuencias de tal restricción cuando se trata de borrar objetos de datos. </para>

<itemizedlist>
<listitem>
<para
>Todos los datos representables (curvas, ecuaciones, histogramas, y espectros de potencias) deben eliminarse de las curvas antes que estas puedan borrarse. Un objeto puede borrarse de un gráfico pulsando con el botón derecho del ratón en la ventana del gestor de datos y seleccionando la curva deseada desde el submenú <guisubmenu
>Eliminar de la gráfica</guisubmenu
>. </para>
</listitem>

<listitem>
<para
>Todas las curvas que usen un vector de datos particular deben borrarse antes que se pueda borrar tal vector de datos. </para>
</listitem>

<listitem>
<para
>Todos los descendientes de un objeto de datos deben estar sin uso antes de poder borrar al objeto padre. </para>
</listitem>
</itemizedlist>

<para
>Después de una serie de borrados de curvas en los gráficos, puede percibir que quedan muchos objetos sin usar que se muestran en el gestor de datos. Para borrarlos rápidamente, puede pulsar sobre <guibutton
>Purgar</guibutton
>. </para>



</sect2>

</sect1>

<sect1 id="datatypes">
<title
>Tipos de datos</title>

<para
>Hay siete tipos principales de objetos datos en &kst;. Los objetos de datos pueden contener otros objetos de datos, como los representados en la vista en árbol en el gestor de datos. El diagrama siguiente muestra las relaciones entre los distintos tipos de datos. </para>

<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Diagram-kst-datatypes.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Tipos de datos en &kst;</phrase>
</textobject>
</inlinemediaobject>
</para>

<para
>Como puede verse en el diagrama de arriba, los objetos de datos curva, ecuación, histograma, y espectro de potencias son los únicos objetos de datos que pueden representarse. Todos los objetos de datos (excepto los vectores), tienen la capacidad de usar vectores, mientras que las ecuaciones, los espectros de potencias, los eventos y los plugins todos contienen vectores esclavos. </para>

<para
>Más abajo están las descripciones de cada tipo de datos, junto con sumarios de las opciones y elementos disponibles al crear y editar cada tipo de objeto de datos. Se han omitido los elementos comunes a casi todos los  tipos de datos&mdash;ver <link linkend="creatingdata"
>Creando nuevos tipos de datos</link
> para más información. </para>

<sect2 id="vectors">
<title
>Vectores</title>
<para
>Vectors are one of the most often-used data objects in &kst;. As their name implies, vectors are simply ordered lists of numbers. Most often they contain the x or y coordinates of a set of data points. </para>
<para
>He aquí un pantallazo de la ventana mostrada cuando se crean o se editan vectores. Más abajo están las explicaciones de los elementos. </para>

<screenshot>
<screeninfo
>Editar vectores</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-vectorwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Editar vectores</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3 id="datavectorparameters">
<title
>Parámetros de los vectores de datos</title>
<para
>Los archivos fuente y los campos a leer pueden configurarse con las opciones siguientes: </para>
<variablelist>

<varlistentry>
<term>
<guilabel
>Nombre del archivo</guilabel>
</term>
<listitem>
<para
>The path to the desired data file. Clicking the button to the right displays a file browser window that can be used to graphically browse to the file. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Campo o columna</guilabel>
</term>
<listitem>
<para
>El campo o columna del cual crear el vector. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>

<sect3 id="datarange">
<title
>Rango de datos</title>
<para
>Esta sección específica el rango de datos a usar del campo seleccionado para con el vector de datos. </para>
<variablelist>
<varlistentry>
<term
><guilabel
>Estructura de comienzo</guilabel
>, <guilabel
>Cuenta desde el final</guilabel
>, <guilabel
>Número de estructuras</guilabel
>, y <guilabel
>Leer hasta el final</guilabel
> </term>
<listitem>
<para
>Usando estas cuatro entradas, puede configurarse los valores inferior y superior del rango de datos. Por ejemplo, para leer desde las estructuras número 10 a la 900, introducir <userinput
>10</userinput
> en <guilabel
>Estructura de comienzo</guilabel
> y <userinput
>890</userinput
> para el <guilabel
>Número de estructuras</guilabel
>. Para leer desde la estructura número 500 hasta el final del archivo, introducir <userinput
>500</userinput
> para <guilabel
>Estructura de comienzo</guilabel
> y seleccionar la opción <guilabel
>Leer hasta el final</guilabel
>. Para leer solo las últimas 450 estructuras, seleccionar <guilabel
>Cuenta desde el final</guilabel
> e introducir <userinput
>450</userinput
> para el <guilabel
>Número de estructuras</guilabel
>. Las combinaciones mostradas en los dos últimos ejemplos son útiles para leer datos de un archivo que se actualiza en tiempo real. La adición posterior de datos al archivo se leerán, haciendo que los vectores asociados se actualicen también. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Leer 1 muestra por</guilabel
> y <guilabel
>Primero el filtro Boxcar</guilabel
> </term>
<listitem>
<para
>Además de los extremos inferior y superior del rango, puede configurarse el número de muestras a leer del rango seleccionado. Si no se selecciona <guilabel
>Leer 1 muestra por</guilabel
>, entonces se leerán todas las muestras en el rango seleccionado. Si se selecciona <guilabel
>Leer 1 muestra por</guilabel
>, solo se leerá 1 muestra por <literal
>N</literal
> estructuras, donde <literal
>N</literal
> es el número introducido en la casilla de selección a la derecha. El valor de 1 muestra que se usa para representar una estructura depende en si se ha seleccionado o no <guilabel
>Primero el filtro Boxcar</guilabel
>. Si no se ha  seleccionado <guilabel
>Primero el filtro Boxcar</guilabel
>, el valor es el mismo que el valor de la primera muestra en la estructura. Si se ha seleccionado <guilabel
>Primero el filtro Boxcar</guilabel
>, el valor es la media (promedio) de todas las muestras en la estructura dada. </para>
</listitem>
</varlistentry>
</variablelist>

</sect3>
</sect2>

<sect2 id="curves">
<title
>Curvas</title>
<para
>Las curvas se usan principalmente para crear objetos gráficos a partir de vectores. Las curvas se crean a partir de dos vectores - un <quote
>vector del eje X</quote
> y un <quote
>vector del eje Y</quote
>, que normalmente contienen una serie de puntos. Así, una puede pensarse que una curva es una serie de puntos de datos y las líneas que los conectan (incluso si las líneas o los puntos no están visibles en los gráficos). </para>
<para
>A continuación un pantallazo de la ventana que se muestra al crear o editar curvas. Más abajo están las explicaciones de los elementos de configuración: </para>

<screenshot>
<screeninfo
>Editar curvas</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-curvewindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Editar curvas</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3 id="curvecontents">
<title
>Contenidos de las curvas</title>
<para
>Los contenidos de las curvas pueden configurarse desde esta sección. </para>
<variablelist>
<varlistentry>
<term>
<guilabel
>Vector del eje X</guilabel>
</term>
<listitem>
<para
>El vector a usar para el eje independiente (horizontal). </para>
</listitem>

</varlistentry>

<varlistentry>
<term>
<guilabel
>Vector del eje Y</guilabel>
</term>
<listitem>
<para
>El vector a usar para el eje dependiente (vertical) </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Barra de error X</guilabel
> y <guilabel
>Barra de error Y</guilabel
> </term>
<listitem>
<para
>Los vectores que contienen valores de error correspondientes a los vectores del eje X y eje Y respectivamente. Los vectores deberían contener los tamaños de las barras de error en el mismo orden que los puntos de datos. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>
</sect2>

<sect2 id="equations">
<title
>Ecuaciones</title>
<para
>Un objeto de datos tipo ecuación consiste de una expresión matemática y de una variable independiente. La expresión se construye usando una combinación de escalares, vectores, y operadores, y normalmente representa los valores de la variable dependiente. La variable independiente puede ser un vector o puede generarse cuando se crea o se edita la ecuación. Como en última instancia, una ecuación consiste de una serie de datos de puntos, un objeto ecuación es representable.  </para>
<para
>El pantallazo siguiente muestra la ventana para crear o editar ecuaciones. A continuación se explican los elementos de configuración. </para>

<screenshot>
<screeninfo
>Editar ecuación</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-equationwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Editar ecuación</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3 id="equation">
<title
>Ecuación</title>
<para
>La expresión matemática que representa la variable dependiente puede modificarse desde esta sección. </para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Operadores</guilabel>
</term>
<listitem>
<para
>Lista de los operadores disponibles. Al elegir un operador de la lista, se inserta en la posición del cursor en la casilla de la <guilabel
>Ecuación</guilabel
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Vectores</guilabel>
</term>
<listitem>
<para
>Una lista de los objetos tipo vector en &kst;.  Al elegir un vector de la lista, se inserta en la posición del cursor en la casilla de la <guilabel
>Ecuación</guilabel
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Escalares</guilabel>
</term>
<listitem>
<para
>Una lista de los valores escalares disponibles. Esta lista se compone de los valores escalares en la sesión actual de &kst; así como algunas constantes prefabricadas. Al elegir un escalar de la lista, se inserta en la posición del cursor en la casilla de la <guilabel
>Ecuación</guilabel
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Ecuación</guilabel>
</term>
<listitem>
<para
>La expresión matemática que representa la variable independiente. Puede escribirla manualmente en esta casilla o puede seleccionar los elementos a insertar usando las listas desplegables de antes. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>


<sect3 id="independentvariable">
<title
>Variable independiente</title>
<para
>Esta sección se usa para especificar la fuente de los valores para la variable independiente. </para>
<variablelist>

<varlistentry>
<term>
<guilabel
>Usar</guilabel>
</term>
<listitem>
<para
>Seleccione esta opción para usar un vector ya existente como variable independiente. Seleccione un vector desde la lista desplegable, o cree uno rápidamente pulsando el botón de la derecha. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Interpolar al vector de resolución más elevada</guilabel>
</term>
<listitem>
<para
>Seleccionando esta opción se interpola el vector seleccionado al mayor número posible de muestras. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Generar</guilabel>
</term>
<listitem>
<para
>Seleccionar esto para generar una serie de valores para usar como variable independiente. Especificar el valor más bajo a generar en el campo <guilabel
>De</guilabel
>, y el valor más alto en el campo <guilabel
>a</guilabel
>. Asignar el valor de <guilabel
>Número de muestras</guilabel
> como el número de valores espaciados igualmente a generar entre el valor inferior y el valor superior (inclusivos). </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

</sect2>

<sect2 id="Histograms">
<title
>Histogramas</title>
<para
>Un objeto de datos histograma representa un histograma de un vector particular. Los objetos histogramas son representables. </para>
<para
>A continuación se muestra un pantallazo de la ventana mostrada al crear o editar histogramas.  A continuación se explican los elementos de configuración. </para>

<screenshot>
<screeninfo
>Editar ecuación</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-histogramwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Editar ecuación</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3 id="histogramproperties">
<title
>Propiedades de los histogramas</title>
<para
>El vector fuente, así como las propiedades básicas del histograma, pueden modificarse desde esta sección. Puede especificar manualmente las variables o usar el botón <guibutton
>Auto Bin</guibutton
>. </para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Vector de datos</guilabel>
</term>
<listitem>
<para
>El vector de datos a partir del cual se crea el histograma. Aunque se necesita un vector para crear un histograma, el vector se trata como una serie desordenada a fin de crear el histograma. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>De</guilabel
> y <guilabel
>a</guilabel
> </term>
<listitem>
<para
>El campo <guilabel
>De</guilabel
> contiene el valor más a la izquierda en el histograma. El campo <guilabel
>a</guilabel
> contiene el valor más a la derecha en el histograma.  </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Num Rect</guilabel>
</term>
<listitem>
<para
>Introducir el número total de rectángulos a usar en el campo <guilabel
>Num rect</guilabel
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guibutton
>Auto rect</guibutton>
</term>
<listitem>
<para
>En vez de especificar los valores para <guilabel
>De</guilabel
>, <guilabel
>a</guilabel
>, y <guilabel
>Num rect</guilabel
>, puede pulsar sobre <guibutton
>Auto rect</guibutton
> para generar automáticamente los valores para los tres campos, basándose en los valores superior e inferior, así como en el número de elementos que se encuentran en el vector fuente. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>


<sect3 id="yaxisnormalization">
<title
>Normalización del eje Y</title>
<para
>Esta sección se usa para especificar el tipo de normalización que se usa para el eje Y del histograma. </para>
<variablelist>

<varlistentry>
<term>
<guilabel
>Número en cada rectángulo</guilabel>
</term>
<listitem>
<para
>Seleccionando esta opción hace que el eje Y represente el número de elementos en cada rectángulo. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Fracción en cada rectángulo</guilabel>
</term>
<listitem>
<para
>Seleccionando esta opción hace que el eje Y represente la fracción del número de elementos en cada rectángulo con respecto al total.  </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Tanto por ciento en cada rectángulo</guilabel>
</term>
<listitem>
<para
>Seleccionando esta opción hace que el eje Y represente el porcentaje de elementos (a partir del número total de elementos) en cada rectángulo.  </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Rectángulo más alto = 1.0</guilabel>
</term>
<listitem>
<para
>Seleccionando esta opción hace que el eje Y represente el número de elementos en cada rectángulo dividido del número de elementos en el rectángulo con mayor número de elementos. En otras palabras, el eje Y está normalizado a 1.0.  </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>


</sect2>

<sect2 id="PowerSpectra">
<title
>Espectro de potencias</title>
<para
>Un objeto de datos tipo espectro de potencias representa el espectro de potencias de un vector definido como <quote
>la raíz cuadrada del valor absoluto de la media de las Transformadas Rápidas de Fourier (FFT) entrelazado de longitud <literal
>2^x</literal
></quote
>, donde x es el valor introducido en la casilla de <guilabel
>Longitud de la FFT</guilabel
>. La definición abajo presupone conocimientos básicos de espectros de potencias&mdash;para más detalles, ver Numerical Recipes in C: The Art of Scientific Computing, publicado por  Cambridge University Press. </para>

<screenshot>
<screeninfo
>Ventana de espectros de potencias</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-powerspectrawindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Ventana de espectros de potencias</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3 id="powerspectracurvecontents">
<title
>Contenidos de las curvas</title>
<para
>Desde esta sección se pueden modificar tanto el vector fuente, como las propiedades básicas del espectro de potencias. </para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Vector de datos</guilabel>
</term>
<listitem>
<para
>Vector de datos a partir del cual crear el espectro de potencias. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Promedio entrelazado</guilabel
> y <guilabel
>Longitud FFT</guilabel
>  </term>
<listitem>
<para
> La selección de <guilabel
>Promedio entrelazado</guilabel
> permite especificar la longitud de las Transformadas Rápidas de Fourier entrelazado. La longitud se especifica como una potencia de 2. Si el <guilabel
>Promedio entrelazado</guilabel
> no está marcado, &kst; determinará la longitud en base a la longitud del vector. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Unidades de datos</guilabel
> y <guilabel
>Unidades de tasa</guilabel
> </term>
<listitem>
<para
>Las unidades que se especifiquen en estas casillas se usarán para generar las etiquetas de los ejes de los gráficos. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guibutton
>Tasa de muestreo</guibutton>
</term>
<listitem>
<para
>La tasa de muestreo se usa para generar el eje X de los gráficos de espectros de potencias. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Limpiar la señal</guilabel>
</term>
<listitem>
<para
>Si se selecciona esta opción, los datos se limpian usando una ventana Hanning, para reducir las perdidas de bin a bin. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Eliminar la media</guilabel>
</term>
<listitem>
<para
>Seleccione esta opción para quitar la media de los datos seleccionados (esto es, traducir los datos de tal forma que la media sea cero). </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

</sect2>

<sect2 id="plugins">
<title
>Plugins</title>
<para
>Un objeto de datos tipo plugin representa un plugin &kst;. Todos los plugins tienen un formato común, y aparecen con el tipo <quote
>Plugin</quote
> en el gestor de datos. Para más información sobre los plugins, ver <link linkend="pluginsandfilters"
>Plugins y filtros</link
> </para>
</sect2>

<sect2 id="events">
<title
>Monitor de eventos</title>
<para
>Un objeto de datos tipo monitor de eventos monitoriza uno o más vectores o escalares, y realiza una acción determinada cuando se verifique una condición dada respecto de los vectores o los escalares. Los monitores de eventos se usan normalmente en conjunción con datos <quote
>en vivo</quote
>, o transmitidos (streaming). Por ejemplo, un monitor de eventos puede crearse para monitorizar si los elementos de un vector de datos representando una temperatura exceden un valor predefinido. </para>
<para
>Lo siguiente es un pantallazo de la ventana mostrada al crear o editar eventos. A continuación se explican los elementos. </para>

<screenshot>
<screeninfo
>Ventana del monitor de eventos</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-eventmonitor.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Ventana del monitor de eventos</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3 id="eventsexpression">
<title
>Expresión</title>
<para
>Desde esta sección puede modificarse la condición a monitorizar, junto con otras propiedades de los eventos.  </para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Operadores</guilabel>
</term>
<listitem>
<para
>Lista de los operadores disponibles. Al elegir un operador de la lista, se inserta en la posición del cursor en la casilla de la <guilabel
>Expresión</guilabel
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Vectores</guilabel>
</term>
<listitem>
<para
>Lista de los vectores disponibles. Al elegir un vector de la lista, se inserta en la posición del cursor en la casilla de la <guilabel
>Expresión</guilabel
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Escalares</guilabel>
</term>
<listitem>
<para
>Una lista de los valores escalares disponibles. Esta lista se compone de los valores escalares en la sesión actual de &kst; así como algunas constantes prefabricadas. Al elegir un escalar de la lista, se inserta en la posición del cursor en la casilla de la <guilabel
>Expresión</guilabel
>. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guilabel
>Expresión</guilabel>
</term>
<listitem>
<para
>La expresión a monitorizar. Puede introducirla directamente en la casilla, o seleccionar los elementos a insertar usando las listas desplegables de arriba. Asegúrese de que la expresión que introduzca en esta casilla es una expresión booleana (véase, se evalúa como verdadero o falso). Esto normalmente requiere que haya una igualdad o desigualdad en la expresión. Notar que los vectores introducidos en la casilla serán monitorizados de acuerdo a sus elementos individuales.  </para>
<para
>Cuando esta expresión sea verdad, se disparará un evento. La acción que se tome al dispararse tal evento depende de la configuración especificada en las siguientes dos secciones. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Descripción</guilabel>
</term>
<listitem>
<para
>La casilla se usa para almacenar una breve descripción del evento. La descripción está disponible como un método para monitorizar e identificar eventos múltiples. Puede introducir el texto que desee en esta casilla. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>

<sect3 id="eventskstdebuglog">
<title
>Registro de depuración de Kst</title>
<para
>Esta sección específica las variables de configuración para las entradas añadidas al registro de depuración de &kst; cuando se generan eventos. </para>
<variablelist>
<varlistentry>
<term
><guilabel
>Registrar como:</guilabel
></term>
<listitem>
<para
>Marque esta casilla para que se añadan entradas al registro de depuración de &kst; cuando se produce un evento. Hay tres tipos de entradas en el registro de depuración&mdash;noticias, avisos, y errores. Seleccionar el tipo deseado de entrada usando el botón radio correspondiente. </para>
</listitem>
</varlistentry>
</variablelist>


</sect3>

<sect3 id="eventsemailnotification">
<title
>Notificación por correo electrónico</title>
<para
>Aquí puede especificarse las opciones para enviar notificaciones por correo electrónico en caso de generarse eventos. </para>

<variablelist>
<varlistentry>
<term
><guilabel
>Notificar</guilabel
></term>
<listitem>
<para
>Marcar esta casilla para que &kst; envíe notificaciones por correo electrónico a la dirección dada cuando se genere este evento. Introducir también la dirección de correo que querría que apareciese en el campo <quote
>De</quote
> del correo en la casilla del <guilabel
>Remitente</guilabel
>. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>

<sect3 id="eventselog">
<title
>ELOG</title>
<para
>&kst; soporta añadir entradas a un libro de registro ELOG en caso de generación de eventos. Esto puede ser útil para monitorizar remotamente datos en vivo, o para obtener sumarios de la actividad de eventos. </para>

<variablelist>
<varlistentry>
<term
><guilabel
>Notificar</guilabel
></term>
<listitem>
<para
>Marcando esta casilla permite la funcionalidad de registro ELOG para este monitor de eventos. Pulsar sobre <guibutton
>Configurar...</guibutton
> para especificar el servidor y la configuración de los registros. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>

</sect2>

</sect1>


<sect1 id="thedatamenu">
<title
>El menú de datos</title>
<para
>El menú de <guimenu
>Datos</guimenu
> permite un acceso rápido a muchas características relacionadas con los objetos de datos en &kst;. Muchas de las funciones del menú </para>
<variablelist>
<varlistentry>
<term
><guimenuitem
>Recargar</guimenuitem
></term>
<listitem>
<para
>Recarga todos los vectores de datos desde los archivos fuente </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Asistente de datos...</guimenuitem
></term>
<listitem>
<para
>Muestra el <link linkend="datawizard"
>Asistente de datos</link
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Gestor de datos</guimenuitem
></term>
<listitem>
<para
>Muestra el <link linkend="datamanager"
>Gestor de datos</link
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Nuevo</guimenuitem
> [objeto de datos]</term>
<listitem>
<para
>Muestra el diálogo correspondiente para crear objetos de datos. Referirse a los <link linkend="datatypes"
>Tipos de datos</link
> para las descripciones de cada diálogo. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Ver escalares</guimenuitem
></term>
<listitem>
<para
>Muestra un diálogo en el cual se pueden ver los valores de todos los escalares en la sesión actual de &kst. El diálogo se actualiza dinámicamente si los valores cambian. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Ver vectores</guimenuitem
></term>
<listitem>
<para
>Muestra un diálogo en el cual se pueden ver los valores en todos los vectores actuales. Seleccionar un vector para ver usando la lista desplegable. El diálogo se actualiza dinámicamente si el valor cambia. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Cambiar el archivo de datos</guimenuitem
></term>
<listitem>
<para
>Muestra un diálogo para cambiar rápidamente los archivos de datos a los que están asociados los vectores. Seleccionar los vectores a cambiar, y navegar hacia un nuevo archivo de datos. Pulsar sobre <guibutton
>Aplicar</guibutton
> para guardar los cambios. </para>
</listitem>
</varlistentry>
</variablelist>

</sect1>
</chapter>
