<appendix id="command-lineoptions">

<appendixinfo>
<author
><firstname
>Barth</firstname
> <surname
>Netterfield</surname
> <affiliation
> <address
><email
>kst@omega.astro.utoronto.ca</email
></address>
</affiliation>
</author>
</appendixinfo>

<title
>Uso de la línea de órdenes y ejemplos</title>
<para
>Un uso típico de kst es desde la línea de órdenes para producir gráficos X-Y o Z desde archivos de datos. kst puede leer datos en ASCII, o leer archivos y directorios binarios de datos compatibles, y opcionalmente (con bibliotecas externas) imágenes FITS, archivos PIOLib, archivos netCDF y archivos HEALPix FITS. </para>

<refentry id="command-linesynopsis">

<refmeta>
<refentrytitle
>Resumen de la línea de órdenes de &kst;</refentrytitle>
</refmeta>

<refnamediv>
<refname
>kst</refname>
<refpurpose
>Un programa para ver gráficos y datos</refpurpose>
</refnamediv>


<refsynopsisdiv>
<para
>Las opciones son:</para>
<cmdsynopsis
><command
>kst</command
> <arg
>opciones-Qt</arg
> <arg
>opciones-KDE</arg
> <arg
>opciones</arg
> <arg rep="repeat"
><replaceable
>archivo</replaceable
></arg
> </cmdsynopsis>
</refsynopsisdiv>

<refsect1 id="cmdline-options">
<title
>Opciones</title>

<variablelist>
<!-- TODO: Add <replaceable
>s here -->
<varlistentry>
<term
><option
>[archivo...]</option
></term>
<listitem>
<para
>Un archivo .kst, o uno o más archivos de datos. Los formatos soportados son columnas en ASCII, archivos de estructuras BOOMERANG, archivos de directorios BLAST, y opcionalmente otros tipos que se soporten. Un archivo .kst guarda todas las opciones que pueden establecerse por parte de otros parámetros. Los parámetros siguientes sirven para sobreescribir las opciones dadas en el archivo .kst: <option
>-F archivodatos</option
>, <option
>-n NS</option
>, <option
>-s NS</option
>, <option
>-f F0</option
>, <option
>-a</option
>. El resto no se puede sobreescribir. Si se da un parámetro, se aplica a todos los vectores en el gráfico. </para>
<para
>Los datos ASCII desde la entrada estándar (stdin) pueden representarse incluyendo «stdin» en la lista <option
>[archivo...]</option
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-y Y</option
></term>
<listitem>
<para
>La fuente para los datos del eje Y. En archivos ASCII, ésta es la columna. Para archivos binarios, éste es el nombre del campo. Para representar varias curvas, puede darse varias veces. Se presupone el mismo archivo de datos, rango de los datos, y datos del eje X. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-e E</option
></term>
<listitem>
<para
>Las barras de error para los datos del eje Y. En archivos ASCII, es la columna que contiene los datos. Para archivos binarios, éste es el nombre del campo. Si se han dado varias entradas <option
>-y Y</option
>, esta opción puede usarse varias veces. Cada entrada Y individual se asocia en orden con las entradas E. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-x X</option
></term>
<listitem>
<para
>La fuente para los datos del eje X. En archivos ASCII, ésta es la columna. Para archivos binarios, este es el nombre del campo. Si esta opción no se especifica, se usará el número de la fila en el archivo. Esta opción sólo puede darse una vez. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-z Z</option
></term>
<listitem>
<para
>La fuente para los datos de la matriz Z (que se muestran como una imagen). Para los arhivos ASCII, ésta es la columna que contiene los datos z. Para otros formatos opcionales (HEALPix, imagen FITS, etc.), éste es el nombre del campo deseado de la matriz, tal y como se muestra en el diálogo de la matriz. Algunas fuentes de datos compatibles con la matriz también permiten utilizar apodos que es el número del campo de la matriz deseada. Para dibujar múltiples matrices, se debe especificar varias veces. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-p P</option
></term>
<listitem>
<para
>La fuente para los espectros de potencias. En archivos ASCII, esta es la columna. Para archivos binarios, este es el nombre del campo. Para representar espectros de potencias en varias curvas, puede darse varias veces. Se presupone el mismo archivo de datos, rango de los datos, y longitudes de las fft para todos los espectros de potencias que se pidan desde la línea de órdenes. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-l P</option
></term>
<listitem>
<para
>La longitud de la FFT usada en la estimación del espectro de potencias es 2^P. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-h H</option
></term>
<listitem>
<para
>La fuente de los histogramas. En archivos ASCII, ésta es la columna. Para archivos binarios, éste es el nombre del campo. Se pueden definir múltiples histogramas desde la línea de órdenes. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-m NC</option
></term>
<listitem>
<para
>Se usa cuando se han definido varias curvas. En vez de dibujar todas las curvas en el mismo gráfico, cada curva se dibuja en su propio gráfico, </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-f F0</option
></term>
<listitem>
<para
>El número de la estructura en la que comenzar la lectura (para archivos binarios), o línea (para archivos ASCII). </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-n</option
></term>
<listitem>
<para
>El número de estructuras (para archivos binarios) o filas (para archivos ASCII) a leer. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-s NS</option
></term>
<listitem>
<para
>El número de estructuras o líneas a saltar en cada lectura. Esto es útil al trabajar con archivos de datos muy grandes, para agilizar la respuesta y conservar la memoria, en el caso en que los datos cambien de manera lenta. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-a</option
></term>
<listitem>
<para
>Se usa con la opción <option
>-s NS</option
>: en vez de saltarse cada NS estructuras, se promedia sus datos. Esto da una combinación de un filtrado básico y de conservación de memoria. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-F Datafile</option
></term>
<listitem>
<para
>Leer los datos desde el archivo dado para todos los vectores listados en el archivo .kst. Solo puede usarse en conjunción con un archivo kst. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--print psfile</option
></term>
<listitem>
<para
>En vez de representar el gráfico, exportar la imagen a un archivo postcript y salirse. Nota de error: aunque no se abren ventanas en la pantalla, se requiere acceso al servidor X. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--png pngfile</option
></term>
<listitem>
<para
>En vez de representar el gráfico, exportar la imagen a un archivo png de dimensiones 640x480 y salirse. Nota de error: aunque no se abren ventanas en la pantalla, se requiere acceso al servidor X. </para>
</listitem>
</varlistentry>


</variablelist>

</refsect1>

<refsect1 id="command-lineexamples">
<title
>Ejemplos de línea de órdenes</title>

<para
>Veamos varios ejemplos de uso típico. </para>

<informalexample>
<para
>Para representar la columna 1 de un archivo (tmp.dat) de datos ASCII: <screen
><userinput
><command
>kst -y 1
tmp.dat</command
></userinput
></screen>
</para>
</informalexample>

<informalexample>
<para
>Para representar las columnas 2,3 y 4 frente a la columna 1 de un archivo ASCII, en 1 gráfico: <screen
><userinput
><command
>kst -x 1 -y 2 -y 3 -y 4 tmp.dat</command
></userinput
></screen>
</para>
</informalexample>


<informalexample>
<para
>Para representar las columnas 2, 3 y 4 vs. la columna 1, en 3 gráficos, dispuestos en 1 columna: <screen
><userinput
><command
>kst -x 1 -y 2 -y 3 -y 4 -m 1 tmp.dat</command
></userinput
></screen>
</para>
</informalexample>

<informalexample>
<para
>Para representar 500 filas de la columna 2 de un archivo ASCII, comenzando en la línea 100: <screen
><userinput
><command
>kst -y 2 -f 100 -n 500 tmp.dat</command
></userinput
></screen>
</para>
</informalexample>

<informalexample>
<para
>Para representar las primeras 100.000 filas de la columna 2 de un archivo ASCII, promediando cada 100 filas: <screen
><userinput
><command
>kst -y 2 -f 0 -n 100000 -s 100 -a tmp.dat</command
></userinput
></screen>
</para>
</informalexample>

<informalexample>
<para
>(Utilizar fuentes de datos HEALPix opcionales) Para dibujar los 3 primeros mapas en un archivo HEALPix FITS en una rejilla de 2x2: <screen
><userinput
><command
>kst -z 1 -z 2 -z 3 -m 2 ejemplo_healpix_sm.fits</command
></userinput
></screen>
</para>
</informalexample>

<informalexample>
<para
>(Utilizar fuentes de datos HEALPix opcionales) Para dibujar un mapa con un nombre de campo específico en un archivo HEALPix FITS: <screen
><userinput
><command
>kst -z "1 - TEMPERATURA (Kelvin)" ejemplo_healpix_sm.fits</command
></userinput
></screen>
</para>
</informalexample>

</refsect1>

</refentry>

</appendix>


<!-- 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" "appendix")
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->