<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 ou imagens do Z a partir dos ficheiros de dados. O kst consegue ler dados em ASCII ou ficheiros binários compatíveis com o 'readdata'/'dirfile', imagens do FITS, ficheiros do POILib, do netCDF e do HEALPix FITS. </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 campo. 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
>-z Z</option
></term>
<listitem>
<para
>A origem dos dados da matriz em Z (que é apresentada como uma imagem). Para os ficheiros ASCII, esta é a coluna que contém os dados em Z. Para os outros formatos opcionais (HEALPix, imagem do FITS, etc), este é o nome do campo da matriz desejada, como aparece na janela da matriz. Algumas fontes de dados compatíveis com as matrizes permitem também usar um nome alternativo que é o número do campo da matriz desejada. Para desenhar várias matrizes, isto poderá ser indicado várias vezes. </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>

<informalexample>
<para
>(A usar o Fonte de Dados opcional HEALPix) Para desenhar os 3 primeiros mapas num ficheiro FITS do HEALPix numa grelha 2x2: <screen
><userinput
><command
>kst -z 1 -z 2 -z 3 -m 2 exemplo_healpix_sm.fits</command
></userinput
></screen>
</para>
</informalexample>

<informalexample>
<para
>(A usar o Fonte de Dados opcional HEALPix) Para desenhar um mapa com um nome de campo específico num ficheiro FITS do HEALPix: <screen
><userinput
><command
>kst -z "1 - TEMPERATURA (Kelvin)" exemplo_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:
-->
