# Tutorial do &kst;

Barth Netterfield

    kst@kde.org

Rick Chern

    kst@kde.org

Pedro Morais

    morais@kde.org

Tradução
2004 A Universidade de British Columbia
&FDLNotice;
2004-06-23
0.98

O &kst; é um programa de desenho e manipulação de dados com um poderoso suporte a 'plugins'.

KDE kdeextragear kdeextragear-2 Kst desenho traçar

## Bem-vindo

Bem-vindo ao &kst;! Em alguns minutos, você estará a caminho de explorar as funcionalidades ricas deste pacote de manipulação e desenho de dados. Aqui estão algumas das tarefas que poderá efectuar com o &kst;:

- Desenhar rapidamente vários gráficos usando apenas a linha de comandos.

- Analisar os dados, usando um conjunto extenso de ferramentas, incluindo histogramas, espectros de potência e equações personalizadas.

- Ampliar e reduzir sem esforço áreas interessantes do gráfico, usando tanto o rato como o teclado

- Monitorizar os dados em tempo-real, usando as capacidades de gráficos em tempo-real do &kst;.

Este tutorial cobre as bases da instalação, execução e actividade com o &kst;. Você está convidado a investigar mais as funcionalidades em qualquer altura. Todas as funcionalidades estão documentadas no Manual Oficial do Kst, que está disponível se seleccionar o Manual do Kst no menu Ajuda do &kst;.

## Instalação

Na maioria dos casos, a instalação básica do &kst; é simples. Os únicos pré-requisitos para o &kst; são as versões 3.1 ou superiores do &kde; e do &Qt;. Contudo, algumas bibliotecas opcionais, como a &GNU; Scientific Library, permitem ao &kst; ser compilado com 'plugins' adicionais e com funcionalidades de suporte para determinados ficheiros, sendo altamente recomendadas e necessárias para certas partes deste tutorial.

Se você usar um sistema de gestão de pacotes, poderá usá-lo para instalar o &kst; em alternativa. Contudo, tenha em atenção que a versão disponível no repositório poderá não ser a última.

Primeir, deve-se certificar que as bibliotecas do &kde; e do &Qt; necessárias foram instaladas no seu sistema. O &kst; v0.99 necessita do &kde; 3.1 e do &Qt; 3.1. Quase todas as grandes distribuições de &Linux; têm pacotes para o &kde; e o &Qt;, por isso recomenda-se que você veja a documentação da sua distribuição em particular no que respeita à instalação do &kde;. Poder-se-ão encontrar mais informações página Web do &kde;.

A &GNU; Scientific Library oferece um conjunto de operações matemáticas para os 'plugins' incorporados do &kst;. A biblioteca poderá ser encontrada em ftp://ftp.gnu.org/gnu/gsl/. Em alternativa, você poderá encontrar a GSL em `/gnu/gsl` nas réplicas indicadas em http://www.gnu.org/prep/ftp.html. Obtenha o ficheiro `gsl-[ver].tar.gz`, em que o [ver] é o número de versão maior que encontrar na pasta. Depois, descomprima o pacote:

    tar -zxvf gsl-[ver].tar.gz

substituindo o [ver] com o número de versão do pacote transferido.

Leia o ficheiro `INSTALL` na pasta resultante para obter instruções de instalação mais detalhadas. Para a maioria dos sistemas, o seguinte irá resultar:

    cd gsl-[ver]
    ./configure
    make
    make install

A segunda biblioteca opcional (mas altamente recomendada) é a biblioteca CFITSIO. Ela oferece o suporte para ler e gravar no formato de dados FITS (Flexible Image Transport System - Sistema de Transporte de Imagens Flexível). A biblioteca poderá ser encontrada em ftp://heasarc.gsfc.nasa.gov/software/fitsio/c/. Obtenha a `cfitsio[ver].tar.gz`, em que o [ver] é o maior número de versão que encontrar na pasta. Depois, descomprima o ficheiro:

    tar -zxvf cfitsio[ver].tar.gz

substituindo o [ver] com o número de versão do pacote transferido.

Leia o ficheiro `README` na pasta resultante para obter as instruções de instalar. Para a maioria dos sistemas, o seguinte irá resultar:

    cd cfitsio
    ./configure --prefix=/usr
    make
    make install

Poderá ter de modificar a opção `--prefix` para o seu sistema em particular mas, para a maioria dos sistemas, a `/usr` irá funcionar.

Logo que todos os pré-requisitos tenham sido cumpridos no seu sistema, você poderá compilar e instalar o &kst;. Obtenha o último pacote de código-fonte em separado na página Web do &kst;. Depois, escreva o seguinte:

    tar -zxvf kst-[ver].tar.gz
    cd kst-[ver]
    ./configure --enable-final --prefix=`kde-config --prefix`
    make
    make install

substituindo o [ver] pela versão do &kst; que tiver.

Repare que o `kde-config --prefix` está rodeado por plicas invertidas. É muito importante que o utilitário `kde-config` devolva a localização correcta (muito provavelmente a `/usr`), caso contrário o &kst; não se irá instalar convenientemente. Você poderá verificar com mais cuidado se o executar directamente:

    kde-config --prefix

Garanta que não é mostrada nenhuma localização em branco.

Você poderá ler as mensagens que são mostradas pelo programa `configure` — se indicar que faltam algumas bibliotecas (como a GSL) que deveriam existir, por favor volte atrás e garanta que as bibliotecas e os ficheiros de inclusão foram instalados correctamente nos locais apropriados. Se a instalação foi bem sucedida, você poderá passar à próxima secção deste tutorial.

## Iniciar o &kst; a partir da Linha de Comandos

Uma utilização comum do &kst; é para produzir rapidamente gráficos de dados a partir da linha de comandos. Este método para produzir gráficos não necessita de quase nenhum conhecimento acerca da interface gráfica do &kst;, mas produz à mesma resultados imediatos e úteis.

Este tutorial usa um pacote de demonstração dos ficheiros de dados que estão disponíveis aqui. Obtenha e descomprima o pacote e mude para a pasta resultante:

    tar -zxvf kst_tutorialdata.tgz
    cd kst_tutorialdata

Para ter uma ideia geral de todas as opções da linha de comandos do &kst;, escreva:

    kst --help

Será apresenta uma descrição da sintaxe e uma lista dos comandos semelhante à seguinte:

    Usage: kst [Qt-options] [KDE-options] [options] [Files]

    Kst: a data viewing program.

    Generic options:
      --help                    Show help about options
      --help-qt                 Show Qt specific options
      --help-kde                Show KDE specific options
      --help-all                Show all options
      --author                  Show author information
      -v, --version             Show version information
      --license                 Show license information
      --                        End of options

    Options:
      -F <dataFile>             Specify data file: used to override a kst file default [|]
      -y <Y>                    Field for Y axis (multiple allowed)
      --ye <equation>           Equation for Y axis (multiple allowed)
      -e <E>                    Field for Y errors (multiple allowed)
      -x <X>                    Field or range for X axis [INDEX]
      --xe <X>                  X vector for equations x0:x1:n [INDEX]
      -p <Y>                    Field for power spectrum (multiple allowed)
      -h <Y>                    Field for histogram (multiple allowed)
      -r <f>                    Sample rate for power spectrum [60.0]
      --ru <U>                  Units for psd sample rate [Hz]
      --yu <U>                  Units for y vectors [V]
      -l <P>                    Length of FFTs is 2^P [10]
      -f <F0>                   First frame to read [-2]
      -n <NS>                   Number of frames to read [-2]
      -s <NS>                   Number of frames to skip each read [-1]
      -a                        Apply boxcar filter before skipping frames
      -m <NC>                   Separate plots arranged in <NC> columns
      -d                        Display as points rather than curves
      -g                        Provide a legend box
      --print <file>            Print to file and exit [<none>]
      --png <file>              Save as a png file and exit [<none>]

    Arguments:
      Files                     Data files (if -y given) or *.kst file

As opções específicas do &kst; estão listadas sob a secção `Opções:`. Sempre que for apropriado, os valores por omissão são indicados com parêntesis rectos no fim da descrição da opção — estes valores serão usados para as opções não especificadas.

Vai-se dar uma vista de olhos no ficheiro ASCII `gyrodata.dat`, incluído no pacote de demonstração. Os ficheiros em ASCII são um dos muitos tipos de ficheiros que o &kst; é capaz de ler. Nos ficheiros ASCII, os dados são organizados em colunas, onde cada coluna corresponde a um campo e onde os números das colunas (a começar em 1, da esquerda para a direita) correspondem aos nomes dos campos. Este ficheiro ASCII em particular contém 3 colunas e, como tal, tem os nomes de campos 1, 2 e 3. Para produzir um gráfico da primeira coluna, basta escrever:

    kst -y 1 gyrodata.dat

Todos os dados da primeira coluna serão desenhados:

Repare que não foi indicado nenhum campo para o eixo dos X do gráfico, como tal o &kst; usou o vector predefinido INDEX, como seria de esperar. O vector INDEX é um vector especial no &kst; que contém os inteiros de 0 a N-1, em que o N é o número de valores de dados que existem no vector correspondente ao eixo dos Y. Feche o &kst;, seleccionando para tal a opção Sair do menu Ficheiro ou carregando em Ctrl Q.

O `gyrodata.dat` contém 20 000 tramas, como tal você poderá desejar ver apenas uma porção dos dados. Para desenhar apenas 10 000 tramas, a começar na trama 7 000, escreva:

    kst -y 1 -f 7000 -n 10000 gyrodata.dat

Uma das potencialidades do &kst; é a sua capacidade de desenhar dados em tempo-real. Imagine que vão sendo adicionados dados novos ao fim do ficheiro `gyrodata.dat`. Nesse caso, seria útil desenhar apenas a parte mais recente dos dados. Para desenhar apenas as últimas 10 000 tramas do ficheiro do `gyrodata.dat`, indique o seguinte:

    kst -y 1 -n 10000 gyrodata.dat

Se o `gyrodata.dat` estiver a ser actualizado, o gráfico continuaria a deslocar-se continuamente para mostrar apenas as últimas 10 000 tramas.

Em vez de ler directamente um ficheiro de entrada, o &kst; poderá usar os dados em ASCII directamente a partir do 'standard input' como fonte de dados. Para indicar o 'standard input' como fonte de dados, basta indicar `stdin` como um dos nomes de ficheiros. Existem vários usos para esta capacidade, como a utilização do &kst; como parte de uma sequência de 'pipes':

    cat gyrodata.dat | awk '{print $1 + 2}' | kst -y 1 stdin

O comando acima usa o `awk` para adicionar 2 à primeira coluna do `gyrodata.dat`, antes de enviar o resultado para o &kst;.

Repare que a descrição da opção `y` indica que são permitidas várias instâncias da opção. Isto permite um desenho gráfico de mais do que uma curva ou mesmo de um gráfico. Para desenhar todos os três campos no `gyrodata.dat` em gráficos separados, escreva o seguinte:

    kst -y 1 -y 2 -y 3 -m 1 gyrodata.dat

A opção `m` indica que deverão ser usados gráficos separados em vez de um único gráfico, como é demonstrado em baixo:

## Uma Visita Rápida ao Assistente de Dados

Embora o uso do &kst; a partir da linha de comandos seja rápido e conveniente, poderão existir situações em que seja mais fácil importa dados da interface gráfica do utilizador — por exemplo, se você já tiver o &kst; aberto com outros dados carregados. Ou, simplesmente, poderá preferir usar a interface gráfica. Ao familiarizar-se com ambos os métodos de importação de dados poderá tirar uma utilização mais eficiente do &kst;.

O Assistente de Dados oferece uma forma rápida e simples de criar vectores, curvas e gráficos no &kst; a partir dos ficheiros de dados. Para lançar o assistente, seleccione o Assistente de Dados... do menu Dados ou carregue no botão da barra de ferramentas. Ser-lhe-á pedida uma fonte de dados. Escolha o ficheiro `gyrodata.dat` usado nos exemplos da linha de comandos e carregue em Próximo. Será apresentada a seguinte janela.

Ecrã 2 do Assistente de Dados
Ecrã 2 do Assistente de Dados

Os campos disponíveis no `gyrodata.dat` estão listados à esquerda. Você poderá filtrar a lista de campos seleccionados se indicar um texto de correspondência (os caracteres especiais como o `*` são suportados) no campo de texto por cima da lista. Indique `*` para corresponder a tudo (i.e., selecciona todos os campos disponíveis) e carregue depois em Assinalar os Seleccionados para seleccionar todos os campos realçados (que, neste caso, são de facto todos os campos).

A Gama de Dados é usada para indicar o intervalo de dados a ler dos vectores seleccionados no ficheiro de entrada. A discussão seguinte assume algum conhecimento sobre as tramas. Em resumo, uma trama é simplesmente um conjunto de amostras de dados e cada ficheiro de dados é composto por um conjunto de tramas. Para uma descrição mais detalhada deste conceito, veja o Manual do Kst.

Trama inicial, Contar do fim, Número de tramas e Ler até ao fim

  Ao usar estas quatro opções, poderão ser definidos os limites inferior e superior do intervalo de dados. Por exemplo, seleccione o Contar do fim e indique 10000 para o Número de tramas para ler apenas as últimas 10000 tramas. Se o `gyrodata.dat` estava a ser actualizado em tempo-real, as adições subsequentes ao fim do ficheiro seriam lidas.

Ler 1 amostra por N tramas e Primeiro o filtro 'boxcar'

  Para além dos limites inferior e superior do intervalo, podem-se definir também as amostras a ler do intervalo seleccionado. Se a opção Ler 1 amostra por N tramas (em que o N é o valor indicado) não estiver seleccionada, serão lidas todas as amostras do intervalo seleccionado. Em alternativa, algumas tramas do ficheiro de dados poderão ser ignoradas se seleccionar a opção Ler 1 amostra por N tramas. Por agora, deseleccione a opção Ler 1 amostra por N tramas.

O Espectro de Potência e a configuração do eixo dos X poderão ser definidos na secção dos Tipos de Gráficos.

XY, Espectro de Potência e XY e Espectro de Potência

  Seleccione a opção XY e Espectro de Potência para produzir gráficos tanto dos dados em si como do seu espectro de potência.

Vector do Eixo X

  O vector a usar como vector independente para os gráficos. Você poderá seleccionar um campo do seu ficheiro de dados ou o vector INDEX. Dado que o `gyrodata.dat` não contém nenhum vector do eixo dos X, deixe a selecção igual a INDEX.

A sub-secção das Opções do FFT da secção dos Tipos de Gráfico está disponível apenas se for para desenhar um espectro de potência. Este tutorial não irá lidar com os detalhes dos espectros de potência, como tal use as opções por omissão para esta sub-secção.

Logo que esteja satisfeito com todas as opções, carregue em Próximo para passar à janela seguinte.

Ecrã 3 do Assistente de Dados
Ecrã 3 do Assistente de Dados

A partir daqui, você poderá alterar as opções gerais do gráfico. A maioria das opções são auto-explicativas. Seleccione 1 novo gráfico por curva para a Colocação da Curva e Numa janela nova para a Colocação do Gráfico. Isto irá colocar todos os seis gráficos (as três curvas e os três espectros de potência) na mesma janela.

Logo que esteja satisfeito com todas as opções, carregue em Terminar para que os gráficos sejam gerados:

Os Gráficos Gerados
Os Gráficos Gerados

A geração destes gráficos necessitou de algum esforço, como tal dever-se-ia gravar a sessão actual do &kst; (ela será usada na próxima secção deste tutorial). Seleccione a opção Gravar Como... do menu Ficheiro e grave a sessão como `minha_sessao.kst`:

Gravar uma sessão do KST
Gravar uma sessão do KST

A gravação de uma sessão do &kst; grava todos os gráficos, os objectos de dados (irá aprender sobre estes mais tarde) e as disposições que existam na altura da gravação.

Logo que o ficheiro tenha sido gravado, poderá sair do &kst;.

## As Bases da Manipulação dos Gráficos

Agora que está à vontade com a criação de gráficos no &kst;, poder-se-á explorar algumas das funcionalidades de manipulação de gráficos disponíveis através da interface gráfica do utilizador do &kst;. Inicie o &kst; a partir da linha de comandos com o ficheiro `minha_sessao.kst` que gravou anteriormente:

    kst minha_sessao.kst

Todos os gráficos que criou anteriormente deverão estar agora carregados pelo &kst;. Examine o gráfico com a legenda do eixo dos Y igual a `PSD de Coluna 2 (V/Hz^{1/2})`. Para dar uma vista de olhos com mais atenção no gráfico, carregue com o botão direito e seleccione o item do menu Maximizar, como é mostrado em baixo:

Maximizar um gráfico
Maximizar um gráfico

O gráfico está agora maximizado na janela actual .Repare que tudo o que está para além dos 4 Hz não parece interessante neste gráfico, por isso seria útil ver apenas a área do gráfico que parecesse interessante. Para o fazer, verifique que está no modo de Ampliação com o Rato em XY (seleccione a opção Ampliação de Rato XY do menu Gráficos ou carregue no botão da barra de ferramentas). Agora, basta arrastar um rectângulo de aproximadamente (4; 0,025) até (0; 0), acomo é mostrado em baixo. Repare que as coordenadas do cursor do rato são apresentadas no campo inferior direito da janela do &kst; (se não estiverem, verifique que a opção Mostrar a Barra de Estado está assinalada no menu Configuração).

Ampliar um gráfico
Ampliar um gráfico

Os eixos do gráfico irão mudar para ampliar a zona seleccionada do gráfico. Irá reparar que existe um pico do lado esquerdo do espectro de potência que se extende para além do novo limite superior do eixo dos Y. Suponha que deseja ver o topo deste pico. Carregue com o botão direito no gráfico e seleccione Subir no sub-menu Deslocar. O gráfico deverá subir um pouco. Claro, é provaveĺmente mais simples usar a tecla de atalho associada com este item do menu ; isto é verdade para a maior parte das funções de ampliação e deslocação. Neste caso, a tecla de atalho é a Cima, por isso a forma mais simples de se deslocar para cima seria manter carregada a tecla de cursor para Cima. Para voltar à ampliação máximo em qualquer altura, carregue com o botão direito no gráfico e seleccione Ampliação Máxima do menu Ampliar (ou carregue em M, a tecla de atalho associada à Ampliação Máxima).

Reponha o tamanho do gráfico do espectro de potência, carregando com o botão direito no mesmo e desligando a opção Maximizar.

Agora veja os gráficos com os eixos do Y chamados `Coluna 2` e `Coluna 3`. Estes são gráficos dos giroscópios do voo do BOOMERANG de 1998. Dado que estes dois gráficos estão relacionados, poderá ser útil ampliá-los e deslocá-los em simultâneo. Carregue nos rectângulos localizados nos cantos superiores direitos dos dois gráficos. Eles deverão ficar escuros para indicar que os dois gráficos estão ligados ou associados um ao outro:

Ampliação Ligada
Ampliação Ligada

Antes de tentar a ampliação, deverá remover todos os gráficos, excepto os dois em que se está a trabalhar. Seleccione o Modo de Disposição do menu Gráficos ou carregue no botão da barra de ferramentas. Para cada gráfico que não os dois que se pretendem manter, carregue com o botão direito no gráfico e seleccione Remover. Depois, carregue com o botão direito em qualquer lado dentro da janela e seleccione Limpar a Disposição. Agora, os dois gráficos deverão partilhar o espaço máximo dentro da janela. Volte ao modo de Ampliação do Rato em XY quando terminar.

Agora tente ampliar qualquer pedaço do gráfico de cima. Irá concluir que o gráfico de baixo irá ficar em branco. Isto tem a ver com o facto de os eixos do gráfico inferior terem mudado para corresponder aos eixos do gráfico superior e não existem nenhuns dados nessa região em particular do gráfico inferior. Carregue em M, enquanto o cursor do rato está por cima de ambos os gráficos para voltar à ampliação máxima em ambos os gráficos. Agora, mantenha carregado o Ctrl (isto é equivalente a seleccionar o Modo de Ampliação do Rato X do menu Gráficos ou a carregar no botão da barra de ferramentas). O cursor do rato irá mudar a sua forma para dar alguma reacção visual. Ao manter o Ctrl carregado, arraste um rectângulo no gráfico de cima. Repare que a altura do rectângulo ponteado está restrita de forma que só o eixo dos X será ampliado. Agora ambos os gráficos irão mostrar dados quando forem ampliados, dado que o eixo dos Y para ambos os gráficos não foi alterado.

Você poderá associar ou dissociar rapidamente todos os gráficos na janela se seleccionar a opção Ampliação Ligada do menu Gráficos ou carregando no botão da barra de ferramentas.

Quando acabar de experimentar as funcionalidades de ampliação, poderá então fechar o &kst;. Não há necessidade de gravar os gráficos desta vez (a menos que o queira).

## Uma Breve Introdução aos Objectos de Dados

Existe mais no &kst; do que a simples visualização e representação em gráficos dos dados. A partir do assistente de dados, você já viu que o &kst; tem a capacidade de criar espectros de potência dos dados. De facto, o &kst; também é capaz de criar outros objectos de dados como, por exemplo, os histogramas, as equações e os 'plugins'. Um utilitário chamado de Gestor de Dados podê-lo-á ajudar a manter um registo de todos os objectos de dados que criar.

Inicie o &kst; com o ficheiro `demo.kst`, incluído no pacote de demonstração:

    kst demo.kst

Kst com o demo.kst
Kst com o demo.kst

Esta sessão do &kst; contém vectores e outros objectos de dados criados a partir dos dados em `gyrodata.dat`. O desenho de cima contém os dados do azimute, o gráfico do meio contém os dados da inclinação a azul e o gráfico de baixo mostra o espectro de potência dos dados de inclinação a azul. Vamos ver primeiro os gráficos com mais atenção. Associe os dois gráficos de cima em conjunto com as técnicas que aprendeu na secção anterior. Depois, mantenha carregado o Ctrl para entrar no modo de Ampliação do Rato em X. Depois amplie uma região pequena do gráfico de cima (por exemplo de 50000 até 53000), para que ambos os gráficos ligados ampliem. Irá reparar que a curva de inclinação a azul está correlacionada negativamente com o azimute a vermelho. Isto tem a ver com o facto de giroscópio de inclinação ter rodado ligeiramente em relação ao eixo do azimute (em -0,69 graus). A inclinação real `p'` é:

onde o `p` é a inclinação original, o é a rotação do giroscópio face ao eixo do azimute e o `a` é o giroscópio do azimute. O `p'` é desenhado como a curva a preto no gráfico do meio. O espectro de potência do `p'` é a curva a preto no gráfico de baixo.

Agora, dar-se-á uma vista de olhos na forma como os três gráficos foram criados. Para mostrar o Gestor de Dados, seleccione o Gestor de Dados... do menu Dados ou carregue no botão da barra de ferramentas:

O Gestor de Dados
O Gestor de Dados

O Gestor de Dados contém a lista definitiva dos objectos de dados na sessão actual do &kst;. Também lhe permite editar ou criar objectos de dados novos. Como pode ver, existem três curvas (cada uma criada a partir de um par de vectores), uma equação, dois espectros de potência e quatro vectores de dados listados nela. Carregue no C2-GY_PITCH e seleccione o J1-P1 no submenu Remover do Gráfico. Isto remove a curva do gráfico P1 da janela J1. Remova também o PSD2-V3-GY_PITCH do gráfico P3 da janela J1, usando o mesmo procedimento. Agora, só as curvas corrigidas é que deverão estar visíveis nos gráficos:

Apenas as Curvas Corrigidas
Apenas as Curvas Corrigidas

Para ver como é que o giroscópio de inclinação corrigido foi criado, seleccione o C4-cleaned_pitch e carregue no botão Editar. A janela para Editar a Equação deverá ficar visível:

Editar Equação
Editar Equação

Repare que a equação usada para calcular o `p'` foi introduzida no campo de texto Equação (foi usada uma aproximação de 1 para o `cos(-0,69)`). Sinta-se à vontade para experimentar as opções desta janela. Carregue em OK (para gravar as alterações que tenha feito) ou em Cancelar quando terminar.

Repare que todos os objectos de dados têm um número indicado por baixo da coluna # Utilizado. Este número indica o número de vezes que o objecto de dados está a ser usado por outros objectos de dados ou pelos gráficos. Dado que foi removida uma curva e um espectro de potência, pelo menos dois objectos deverão ter um 0 listado nesta coluna. Carregue em Apagar para remover permanentemente todos os objectos não usados.

Carregue em Fechar para fechar o Gestor de Dados. Poderá sair agora do &kst; se o desejar.

## Uma Vista de Olhos nos 'Plugins' e nos Eventos

Para terminar a jornada sobre o &kst;, falta falar em dois tipos de dados específicos — os 'plugins' e os monitores de eventos.

Um 'plugin' é um objecto de dados flexível cujo comportamento depende por inteiro do ficheiro de 'plugin' seleccionado. O ficheiro do 'plugin' poderá ser um que venha incluído com a distribuição normal do &kst; ou poderá ser um ficheiro de 'plugin' de terceiros. De facto, o Manual do Kst inclui instruções para aprender a criar e a compilar ficheiros de 'plugins' personalizados. Os 'plugins' permitem ao &kst; efectuar operações arbitrárias sobre um conjunto de dados, dado que os únicos requisitos para um ficheiro de 'plugin' sejam a recepção de um conjunto de vectores e valores escalares de entrada e devolver outro conjunto de vectores e valores escalares.

Por exemplo, vai-se tentar ajustar uma linha simples a um pequeno conjunto de pontos de dados. Inicie o &kst; com um desenho do primeiro campo do ficheiro de dados `maxima.dat`, que vem incluído com o pacote de demonstração:

    kst -y 1 -d maxima.dat

A opção `d` indica que apenas os pontos deverão ser desenhados, não as linhas. O gráfico dos pontos de dados deverá agora ser apresentado:

Gráfico dos Pontos de Dados
Gráfico dos Pontos de Dados

Agora, abra o Gestor de Dados. Carregue em 'Plugin'... na secção Novo para criar um novo objecto de um 'plugin'. Na Selecção do 'Plugin', seleccione o 'plugin' de Ajuste linear. Este 'plugin' em particular necessita de dois vectores de entrada — um que contém os valores em X e outro que contém os valores em Y dos pontos de dados a serem ajustados. Seleccione o V1-INDEX para o Vector de Entrada - Lista X, e o V2-1 para o Vector de Entrada - Lista Y. Depois, carregue em OK. Irá reparar que o novo 'plugin' criou vectores-escravos para armazenar os seus resultados. Carregue em Curva... para criar uma curva nova a partir dos vectores de saída. Seleccione o V1-INDEX para o Vector do eixo X e o P1-kstfit_linear_unweighted-Y Fitted para o vector do eixo Y. Deseja-se colocar a curva por cima dos pontos de dados no gráfico existente, por isso em Colocação da Curva, seleccione o Colocar no gráfico existente e deseleccione o Colocar num novo gráfico. Finalmente, carregue em OK para criar a curva. Feche o gestor de dados para ver a linha ajustada:

Linha Ajustada
Linha Ajustada

Um procedimento semelhante ao que você acabou de seguir permitir-lhe-á criar e desenhar o resultado de qualquer tipo de objecto de 'plugin'. Contudo, existem um atalho para criar 'plugins' de ajuste. Se carregar com o botão direito num gráfico irá mostrar um menu de contexto que contém um submenu Ajustar.... Se seleccionar uma curva do submenu irá mostrar a janela da Função de Ajuste com os vectores do X e do Y pré-seleccionados. Depois de o 'plugin' de ajuste ser seleccionado, ao carregar no botão OK irá criar o objecto do 'plugin', criar a curva a partir do resultado do 'plugin' e irá colocar a curva no desenho existente.

Vejamos agora os eventos. Os objectos dos eventos normalmente vigiam outros vectores ou valores escalares e efectuam determinadas acções quando certas acções que envolvam esses objectos sejam avaliadas como verdadeiras. Carregue em Monitor de Eventos... na secção Novo do Gestor de Dados para criar um evento novo:

Monitor de Eventos
Monitor de Eventos

Suponha que os dados do giroscópio de inclinação estão a ser actualizados em tempo-real e que se pretende ser notificado sempre que o giroscópio corrigido saia para fora do intervalo `[-0,60, -0,40]`. Para configurar o evento desta forma, indique o seguinte no campo de texto Expressão:

`[C4-cleaned_pitch-sv]>(-0.40) | [C4-cleaned_pitch-sv]<(-0.60)`

Repare que tudo o que introduzir como expressão deverá ser uma expressão booleana. Esta expressão booleana será avaliada como verdadeira sempre que uma das desigualdades seja verdadeira. Seleccione tanto a opção Registar como e Notificar e indique o seu endereço de e-mail à direita da opção Notificar. Carregue em OK para que o evento seja criado.

Agora seleccione a opção Depurar o Kst... do menu Ajuda. Carregue na página Registo para ver o registo de depuração. Se o evento foi configurado correctamente, você deverá ver avisos a indicar os valores de X para os quais o evento foi disparado. Verifique se os valores correspondem aproximadamente aos que estaria à espera ao olhar para o gráfico:

Registo de Depuração
Registo de Depuração

Se os dados do giroscópio de inclinação fossem alterados em tempo-real, o monitor de eventos seria disparado também para os dados novos, sempre que fosse apropriado.

Quando terminar, poderá fechar o &kst;.

## Conclusão

Isto conclui o tutorial do &kst;. Espera-se que você tenha adquirido conhecimentos suficientes para se sentir confortável com o &kst;. Tenha em mente que este tutorial não cobre todas as funcionalidades do &kst; — existe ainda muito para explorar e experimentar. O Manual do Kst, disponível no menu Ajuda do &kst;, poderá ser o seu guia aprofundado para os conceitos que vão dos fundamentos da disposição da janela até à criação de 'plugins' personalizados e leitores de fontes de dados. Encoraja-se o utilizador a usar o &kst; de forma interessante e inovadora — irá provavelmente achar que não só corresponde como excede as suas expectativas e necessidades.

## Créditos e Licença

Este tutorial baseia-se na Viagem Rápida pelo &kst; original do Barth Netterfield.

&underFDL;