<chapter id="common-tasks">
<title
>Tarefas Comuns</title>

<para
>Este capítulo contém instruções para efectuar tarefas básicas com o &kst;. Ele define o método para efectuar cada tarefa da forma mais simples. Também são indicadas referências às secções do manual com informações mais detalhadas.</para>

<sect1 id="plotting-simple-graphs">
<title
>Desenhar Gráficos Simples</title>

<para
>Como desenhar um gráfico simples pontos-em-grelha</para>

<para
>A primeira coisa que irá querer fazer com o &kst; será provavelmente desenhar um gráfico simples. Aqui está o procedimento para tal:</para>

<orderedlist>

<listitem
><para
>Escolha o seu ficheiro de dados. O &kst; irá ler vários tipos de ficheiros de dados, sendo o mais simples um ficheiro de texto simples (<acronym
>ASCII</acronym
>) com os dados distribuídos em colunas. Para um exemplo definido, será usado o ficheiro de dados descrito em <xref linkend="gettingstarted"/>, com o nome de ficheiro <filename
>dados_simples.dat</filename
>.</para>
</listitem>

<listitem
><para
>Abra o &kst;. Ser-lhe-á apresentada a janela de <guilabel
>Introdução</guilabel
>: <screenshot>
<screeninfo
>A janela de Introdução</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-quickstart.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>A janela de Introdução</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Carregue no <guibutton
>Assistente de Dados</guibutton
> e, no assistente que aparece, seleccione o seu ficheiro de dados com o botão <guibutton
>Abrir um Ficheiro</guibutton
>: <inlinemediaobject
> <imageobject
> <imagedata fileref="Screenshot-kst-open-file-button.png" format="PNG"/> </imageobject
> </inlinemediaobject
>. </para>
</listitem>

<listitem>
<para
>A página <guibutton
>Seguinte</guibutton
> é onde você irá seleccionar os dados a usar. A coluna 2 do ficheiro de dados contém os valores do eixo dos Y, pelo que assinale a opção ao pé do 2 na lista <guilabel
>Campo/Coluna</guilabel
> do lado esquerdo. O campo INDEX é um campo especial criado pelo &kst;, mas não será usado para este exemplo.</para>
</listitem>

<listitem>
<para
>Nos <guilabel
>Tipos de Gráfico</guilabel
>, deixe o <guilabel
>XY</guilabel
> predefinido como está, mas altere o <guilabel
>vector do eixo dos X</guilabel
> para 1.</para>
</listitem>

<listitem>
<para
>Na próxima página, será alterada apenas uma coisa: no <guilabel
>Estilo da Curva</guilabel
>, seleccione a opção <guilabel
>Apenas os pontos</guilabel
> para desenhar apenas os pontos de dados e não desenhar as linhas que os juntam.</para>
</listitem>

<listitem>
<para
>Carregue em <guibutton
>Terminar</guibutton
> para concluir a tarefa! O gráfico novo irá aparecer na janela principal do &kst;.</para>
</listitem>

</orderedlist>

<!-- TODO: Link to other places in the handbook, perhaps with a little -->
<!-- more description -->

</sect1>

<sect1 id="curve-fitting">
<title
>Ajuste de Curvas</title>

<para
>O &kst; também oferece funções para vários tipos diferentes de ajuste das curvas: linear, quadrático, sinusoidal, entre outros. Como exemplo, será feito um ajuste polinomial simples da curva que foi desenhada anteriormente, em <xref linkend="plotting-simple-graphs"/>.</para>

<orderedlist>

<listitem
><para
>Com o gráfico terminado, abra a janela de 'plugins' em <menuchoice
><guimenu
>Dados</guimenu
><guimenuitem
>Novo 'Plugin'</guimenuitem
> </menuchoice
>.</para>
</listitem>

<listitem
><para
>A lista <guilabel
>Selecção do gráfico</guilabel
> contém todos os 'plugins' de ajuste do &kst;, entre outros. Dado que os dados de exemplo aqui são quadráticos, será usado o 'plugin' de <guilabel
>Ajuste polinomial</guilabel
>. Seleccione o <guilabel
>Vector X</guilabel
> e o <guilabel
>Vector Y</guilabel
> para o ajuste &ndash; se usou os nomes predefinidos ao produzir o gráfico, seleccione o <guilabel
>V0-1</guilabel
> para o <guilabel
>Vector X</guilabel
> e o <guilabel
>V1-2</guilabel
> para o <guilabel
>Vector Y</guilabel
>. </para>
</listitem>

<listitem
><para
>À medida que acontece, a <guilabel
>Ordem</guilabel
> do polinómio é igualada a 2, que é o valor por omissão pretendido. Poderá definir a <guilabel
>Ordem</guilabel
> com qualquer valor inteiro, uma das quantidades escalares predefinidas ou com qualquer valor estatístico, baseando-se num dos vectores disponíveis (por exemplo, o <guilabel
>V1-2-Media</guilabel
>).</para>
</listitem>

<listitem
><para
>Carregue em <guibutton
>OK</guibutton
> para gerar os valores.</para>
</listitem>

</orderedlist>

<para
>É tudo o que é necessário para gerar os valores, como tal será necessário olhar para o resultado do processo de ajuste. Seleccione a opção <menuchoice
><guimenu
>Dados</guimenu
><guimenuitem
>Ver os Resultados do Ajuste</guimenuitem
> </menuchoice
> dos menus, para que os valores do ajuste sejam mostrados na janela que aparece: os coeficientes para o x^2, o x^1 e o x^0 (a constante), em conjunto com os valores dos 'chi'-quadrados e as covariâncias entre os coeficientes.</para
> 

<para
>A curva gerada pelo ajuste não é sobreposta automaticamente aos pontos de dados. Para o fazer, use a janela de <guilabel
>Nova Curva</guilabel
>, seleccionando a opção <menuchoice
><guimenu
>Dados</guimenu
><guimenuitem
>Nova Curva...</guimenuitem
> </menuchoice
>. Para o <guilabel
>Vector do eixo dos X</guilabel
>, seleccione o V0-1 (se estiver a usar os nomes gerados automaticamente) e para o <guilabel
>vector do eixo dos Y</guilabel
>, escolha o <quote
>P1-kstfit_polynomial_unweighted-Y Fitted</quote
>. Carregue em <guibutton
>OK</guibutton
>, logo que tenha definido as outras opções que desejar. A curva é desenhada na sua própria janela: para o exemplo em questão, não é isso o pretendido, pelo que deverá remover o gráfico novo, carregando com o botão direito do rato e escolhendo a opção <guimenuitem
>Remover</guimenuitem
> do menu de contexto que aparece.</para>

<para
>Agora, para adicionar o ajuste da curva ao gráfico dos dados, abra a janela do Gráfico em <menuchoice
><guimenu
>Gráficos</guimenu
><guimenuitem
>Editar o Gráfico...</guimenuitem
> </menuchoice
>. Na página do <guilabel
>Conteúdo</guilabel
> que aparece, o vector que contém os dados ajustados é mostrado nos <guilabel
>Objectos disponíveis</guilabel
>. Seleccione este vector e adicione-o à <guilabel
>Objectos visíveis</guilabel
>, carregando na seta para a esquerda. Carregue em <guibutton
>Aplicar as Edições</guibutton
> e depois em <guibutton
>Fechar</guibutton
> para que então termine.</para>

</sect1>

<sect1 id="plotting-a-power-spectrum">
<title
>Desenhar um Espectro de Potência</title>

<para
>O &kst; torna os gráficos de espectros de potência extremamente simples de criar. Existem duas formas de os criar: com o Assistente de Dados ou criando um espectro de potência a partir de um vector existente.</para>

<sect2 id="power-spectra-data-wizard">
<title
>Espectro de potência com o Assistente de Dados</title>

<para
>Este é quase o mesmo que desenhar um gráfico simples. Aqui estão as instruções completas:</para>

<para
>Abra o <guibutton
>Assistente de Dados</guibutton
> e seleccione o seu ficheiro de dados com o botão <guibutton
>Abrir um Ficheiro</guibutton
>: <inlinemediaobject
> <imageobject
> <imagedata fileref="Screenshot-kst-open-file-button.png" format="PNG"/> </imageobject
> </inlinemediaobject
>. </para>

<orderedlist>
<listitem>
<para
>A página <guibutton
>Seguinte</guibutton
> é onde vocêẽ selecciona os dados dos quais desenhar o gráfico do espectro de potência. A coluna 2 do ficheiro de dados contém os valores do eixo dos Y, como tal assinale a opção perto do 2 na lista <guilabel
>Campo/Coluna</guilabel
> do lado esquerdo.</para>
</listitem>

<listitem>
<para
>Em <guilabel
>Tipos de Gráfico</guilabel
>, seleccione a opção <guilabel
>Espectro de potência</guilabel
>. Existem também algumas opções que definem como é calculado o espectro de potência, que serão deixadas com os seus valores predefinidos neste exemplo.</para>
</listitem>

<listitem>
<para
>Na página <guilabel
>Seguinte</guilabel
>, as opções específicas dos espectros de potências encontram-se no <guilabel
>Modo do Eixo do Espectro de Potência</guilabel
>. Os eixos do X e do Y podem ser tornados ambos logarítmicos aqui.</para>
</listitem>

<listitem>
<para
>Carregue em <guibutton
>Terminar</guibutton
> para concluir a tarefa! O gráfico novo irá aparecer na janela principal do &kst;.</para>
</listitem>

</orderedlist>


</sect2>

<sect2 id="power-spectra-existing-plot">
<title
>Espectro de potência de um gráfico existente</title>
<para
>Se usar o exemplo dos <filename
>dados_simples.dat</filename
> da secção <xref linkend="plotting-simple-graphs"/>, poderá ser feito o seguinte para produzir o seu espectro de potência:</para>

<orderedlist>

<listitem
><para
>Abra a <guilabel
>janela do Espectro de Potência</guilabel
> na opção <menuchoice
><guimenu
>Dados</guimenu
><guimenuitem
>Novo Espectro de Potência...</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem
><para
>Na lista <guilabel
>Vector de dados</guilabel
>, escolha o vector que representa os seus dados. No exemplo dos <filename
>dados_simples.dat</filename
>, o vector necessário chama-se V1-2.</para>
</listitem>

<listitem
><para
>Carregue em <guibutton
>OK</guibutton
> para mostrar o espectro de potência num gráfico novo.</para>
</listitem>

</orderedlist>

</sect2>

</sect1>

<sect1 id="using-kst-from-the-command-line">
<title
>Utilizar o &kst; a partir da Linha de Comandos</title>

<para
>As opções da linha de comando para efectuas as tarefas acima</para>

</sect1>

<!--
The interface for this is not finalized, so it's commented out for -->
<!--now, but definitely something useful to have in the future -->

<!--
<sect1 id="making-a-color-map">
<title
>Making a Color Map</title>
<para
>How to make a color map, since the interface isn't very intuitive</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:
-->
