<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
>Utilização da Linha de Comando e Exemplos</title>
<para
>Uma utilização típica do &kst; é através da linha de comandos para criar gráficos X-Y dos ficheiros de dados. O &kst; consegue ler dados em ASCII ou ficheiros binários compatíveis com o 'readdata'. </para>



<refentry id="command-linesynopsis">

<refmeta>
<refentrytitle
>Sinopse da Linha de Comando do &kst;</refentrytitle>
</refmeta>

<refnamediv>
<refname
>kst</refname>
<refpurpose
>Um utilitário de desenho e visualização de dados</refpurpose>
</refnamediv>


<refsynopsisdiv>
<para
>As opções são:</para>
<cmdsynopsis
><command
>kst</command
> <arg
>opções-Qt</arg
> <arg
>opções-KDE</arg
> <arg
>opções</arg
> <arg rep="repeat"
><replaceable
>ficheiro</replaceable
></arg
> </cmdsynopsis>
</refsynopsisdiv>

<refsect1 id="cmdline-options">
<title
>Opções</title>

<variablelist>
<!-- TODO: Add <replaceable
>s here -->
<varlistentry>
<term
><option
>[ficheiro...]</option
></term>
<listitem>
<para
>Um ficheiro .kst ou um ou mais ficheiros de dados. Os formatos suportados são as colunas em ASCII, os ficheiros de tramas do BOOMERANG ou os ficheiros BLAST do 'dirfile'. Um ficheiro .kst guarda todas as opções que podem ser definidas através de outras. As seguintes opções podem ser usadas para sobrepor as que estão definidas no ficheiro .kst: <option
>-F ficheiro_dados</option
>, <option
>-n NS</option
>, <option
>-s NS</option
>, <option
>-f F0</option
>, <option
>-a</option
>. As restantes opções não poderão ser sobrepostas. Se alguma opção de sobreposição for indicada, é aplicada a todos os vectores do gráfico. </para>
<para
>Os dados ASCII do 'stdin' podem ser desenhados se incluir o "stdin" na lista <option
>[ficheiro...]</option
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-y Y</option
></term>
<listitem>
<para
>A origem dos dados do eixo dos Y. Para os ficheiros ASCII, esta é a coluna. Para os ficheiros binários, isto é o nome do campo. Para desenhar várias curvas, este poderá ser indicado várias vezes. Assume-se o mesmo ficheiro de origem, os intervalos de amostragem e os dados do eixo dos X. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-e E</option
></term>
<listitem>
<para
>As barras de erros para os dados do eixo dos Y. Para um ficheiro ASCII, refere-se à coluna que contém os dados. Para os ficheiros binários, use o nome do camop. Se forem indicadas várias opções <option
>-y Y</option
>, esta também poderá ser usada várias vezes. Os itens em Y individuais estão associados por ordem a vários itens em E. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-x X</option
></term>
<listitem>
<para
>A origem dos dados do eixo dos X. Para os ficheiros ASCII, esta é a coluna. Para os ficheiros binários, isto é o nome do campo. Se esta opção não for indicada, é usado o número de linha no ficheiro. Esta opção só pode ser indicada uma vez. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-p P</option
></term>
<listitem>
<para
>A origem para o espectro de potência. Para os ficheiros ASCII, esta é a coluna. Para os ficheiros binários, isto é o nome do campo. Para desenhar o espectro de potência de várias curvas, este poderá ser indicado várias vezes. Assume-se o mesmo ficheiro de origem, os intervalos de amostragem e o tamanho dos FFT para todos os Espectros de Potência pedidos na linha de comandos. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-l P</option
></term>
<listitem>
<para
>O comprimento da FFT usada na estimativa do espectro de potência é igual a 2^P. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-h H</option
></term>
<listitem>
<para
>A origem para os histogramas. Para os ficheiros ASCII, esta é a coluna. Para os ficheiros binários, isto é o nome do campo. Poderão ser definidos vários histogramas a partir da linha de comandos. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-m NC</option
></term>
<listitem>
<para
>Usado quando foram definidas várias curvas. Em vez de desenhar todas as curvas no mesmo gráfico, desenha cada uma no seu próprio gráfico. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-f F0</option
></term>
<listitem>
<para
>O número de trama (para os ficheiros do 'readdata') ou linha (para os ficheiros ASCII) a partir da qual se começa a ler. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-n</option
></term>
<listitem>
<para
>A quantidade de tramas (para os ficheiros do 'readdata') ou linhas (para os ficheiros ASCII) que serão lidas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-s NS</option
></term>
<listitem>
<para
>O número de tramas ou linhas a saltar em cada leitura. Isto é útil quando se lida com ficheiros de dados demasiado grandes, para acelerar a capacidade de resposta e manter a memória, no caso de os dados variarem de forma lenta. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-a</option
></term>
<listitem>
<para
>Usado com a opção <option
> -s NS</option
>: em vez de saltar de NS em NS tramas, calcula a sua média. Isto oferece uma combinação de uma filtragem passa-alto com a conservação de memória. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-F ficheiro_de_dados</option
></term>
<listitem>
<para
>Usa outro ficheiro para ler os dados de todos os vectores enumerados no ficheiro .kst. Só pode ser usado em conjunto com um ficheiro .kst. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--print ficheiro_ps</option
></term>
<listitem>
<para
>Em vez de mostrar o gráfico, exporta a imagem para um ficheiro PostScript e sai. *Nota de ERRO: ainda que não seja aberta nenhuma janela no ecrã, é necessário o acesso ao servidor X à mesma.* </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--png ficheiro_png</option
></term>
<listitem>
<para
>Em vez de mostrar o gráfico, exporta a imagem para um ficheiro PNG de dimensões 640x480 e sai. *Nota de ERRO: ainda que não seja aberta nenhuma janela no ecrã, é necessário o acesso ao servidor X à mesma.* </para>
</listitem>
</varlistentry>


</variablelist>

</refsect1>

<refsect1 id="command-lineexamples">
<title
>Exemplos de Linha de Comando</title>

<para
>Seguem-se vários exemplos de utilizações típicas. </para>

<informalexample>
<para
>Para desenhar a coluna 1 de um ficheiro (tmp.dat) de dados ASCII: <screen
><userinput
><command
>kst -y 1
tmp.dat</command
></userinput
></screen>
</para>
</informalexample>

<informalexample>
<para
>Para desenhar as colunas 2, 3 e 4 em relação à coluna 1 de um ficheiro de dados ASCII, num só desenho: <screen
><userinput
><command
>kst -x 1 -y 2 -y 3 -y 4 tmp.dat</command
></userinput
></screen>
</para>
</informalexample>


<informalexample>
<para
>Para desenhar as colunas 2, 3 e 4 em relação à coluna 1 de um ficheiro de dados ASCII, em 3 desenhos, dispostos numa coluna: <screen
><userinput
><command
>kst -x 1 -y 2 -y 3 -y 4 -m 1 tmp.dat</command
></userinput
></screen>
</para>
</informalexample>

<informalexample>
<para
>Para desenhar 500 linhas da coluna 2 de um ficheiro ASCII, a começar na linha 100: <screen
><userinput
><command
>kst -y 2 -f 100 -n 500 tmp.dat</command
></userinput
></screen>
</para>
</informalexample>

<informalexample>
<para
>Para desenhar as primeiras 100 000 linhas da coluna 2 de um ficheiro ASCII, calculando a média a cada 100 linhas: <screen
><userinput
><command
>kst -y 2 -f 0 -n 100000 -s 100 -a tmp.dat</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:
-->
