# Trabalhar com Dados

## Formatos de Ficheiro Suportados

De momento, o Kst suporta os ficheiros de texto em ASCII, os ficheiros em tramas do BOOMERANG e os ficheiros de directoria do BLAST como fontes de dados, assim como os ficheiros do PIOLib e do FITS com as bibliotecas apropriadas. Esta secção descreve os conceitos básicos das fontes de dados que são comuns a todos os tipos de ficheiros e, especificamente, os detalhes dos tipos de ficheiros ASCII e BLAST.

### Conceitos de Fontes de Dados

Uma fonte de dados no &kst; é simplesmente um ficheiro de dados suportado. Os conceitos seguintes são importantes para perceber como o &kst; funciona com várias fontes de dados. É também introduzida alguma terminologia nesta secção.

#### Amostras

Considera-se uma amostra como a unidade fundamental para os ficheiros de dados. Cada amostra consiste num valor de dados no ficheiro. Repare, contudo, que uma amostra poderá não corresponder a um valor num vector de dados no &kst;, devido ao conceito de tramas.

#### Campos

Um campo corresponde normalmente a um vector no &kst;. Por exemplo, uma coluna num ficheiro de dados em ASCII corresponde a um campo. Cada campo poderá ter um nome explícito ou implícito. Os leitores das fontes de dados oferecem funções para ler e obter os campos e os seus nomes.

#### Tramas

Uma trama corresponde a um número definido de amostras e cada campo de um ficheiro de dados poderá ter a sua própria relação de amostras por trama. O tamanho de um ficheiro de dados é medido pelo número de tramas que contém. Para os ficheiros de dados em ASCII, o número de amostras por trama é 1 mas, para alguns ficheiros de dados, poderão existir várias amostras por trama. Na ilustração abaixo, são mostradas as três primeiras tramas de um ficheiro de dados imaginário. Neste ficheiro de dados em particular, o Campo 1 tem uma relação de 5 amostras por trama, o Campo 2 tem uma relação de 2 amostras por trama, o Campo 3 corresponde a 3 amostras por trama e, finalmente, o Campo 4 corresponde a 1 amostra por trama.

Dependendo da configuração específica dos vectores de dados no &kst;, os dados dos ficheiros poderão ser lidos como tramas em vez de amostras, com a primeira amostra numa trama ou com a média de todas as amostras numa trama, o que irá representar o valor da trama.

#### Campo INDEX

Alguns ficheiros de dados poderão não ter um campo que representa o eixo dos X num gráfico. Contudo, o &kst; cria implicitamente um campo INDEX (índice) para todas as fontes de dados. O campo INDEX contém simplesmente números inteiros de 0 a N-1, em que N é o número de tramas no ficheiro de dados.

### Ficheiros de Entrada em ASCII

O formato de ficheiros de entrada mais simples é o ficheiro de texto em ASCII. Estes ficheiros são normalmente legíveis para o utilizador e poderão ser criados facilmente à mão ou com programas simples, se for o desejado. Segue-se o exemplo de um ficheiro de entrada em ASCII.

    112.5 3776 428
    187.5 5380 429
    262.5 5245 345
    337.5 2942 184
    412.5 1861 119
    487.5 2424 138
    567.5 2520 162
    637.5 1868 144
    712.5 1736 211
    787.5 1736 211
    862.5 2172 292
    937.5 1174 377
    1000.5 499 623

Cada coluna deste ficheiro representa um campo, no qual cada linha representa uma trama. As colunas são separadas por tabulações ou espaços, enquanto as linhas são separadas por mudanças de linha. Repare que, devido à sua estrutura, os ficheiros ASCII não podem ter várias amostras por trama. Do mesmo modo, dado que as colunas não têm legendas atribuídas, os nomes dos campos são atribuídos pelo &kst; com base na ordem das colunas (a coluna mais à esquerda tem um nome de campo igual a `1`).

As linhas comentadas nos ficheiros ASCII começam com um dos caracteres do conjunto `{#, !, /, ;, c}`. Todas as linhas comentadas e em branco são ignoradas pelo &kst;. Os números válidos incluem os com pontos decimais, sinais de menos ou negativo ou o `e`, para indicar a notação científica. Os números inválidos (como as palavras) são substituídos por 0 pelo &kst;.

### Ficheiros de directoria do BLAST

As fontes de dados do BLAST são de facto pastas de ficheiros. Cada pasta representa uma fonte de dados e cada ficheiro da pasta, com a excepção de um ficheiro chamado `format`, representa um único campo. O ficheiro `format` corresponde a cada campo e às suas propriedades. Em baixo, está um exemplo deste tipo de ficheiros:

    scount RAW f 1
    fcount RAW f 20
    sine RAW f 20
    ssine RAW f 1
    cos RAW f 20

Neste exemplo, `scount`, `fcount`, `sine`, `ssine` e `cos` são nomes de campos. `RAW` indica um ficheiro escrito no formato "raw", e o último número de cada linha indica o número de amostras por trama.

Ao seleccionar um ficheiro de directoria do BLAST para o usar no &kst;, a pasta que contém os ficheiros do campo deverá ser seleccionada. O &kst; irá então procurar automaticamente por um ficheiro `format`, se existir, para determinar os campos e as suas propriedades.

## O Assistente de Dados

O Assistente de Dados oferece uma forma rápida e simples de criar vectores, curvas, espectros de potência e gráficos no &kst; a partir dos ficheiros de dados. Para lançar o assistente, seleccione a opção Assistente de Dados... do menu Dados. Ser-lhe-á pedido para seleccionar uma fonte de dados. Escolha um ficheiro de dados válido (ou indique a sua localização) e carregue em Próximo. Será mostrada a seguinte janela.

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

Seleccione os campos que deseja importar para o &kst;. Poderá filtrar a lista de campos se indicar um texto para correspondência (os caracteres especiais como o `*` são suportados) no campo de texto por cima da lista.

A secção da Gama de Dados é usada para indicar o intervalo de dados a ler a dos vectores seleccionados no ficheiro de entrada. A seguinte descrição assume algum conhecimento sobre as tramas. Para uma descrição detalhada deste conceito, veja os Formatos de Ficheiros.

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

  Usando estas quatro opções, pode-se definir os limites inferior e superior do intervalo de dados. Por exemplo, para ler da trama 10 à 900, indique `10` na Trama inicial e `890` para o Número de tramas. Para ler da trama 500 até ao fim do ficheiro, indique `500` para a Trama inicial e seleccione a opção Ler até ao fim. Para ler apenas as últimas 450 tramas do ficheiro, seleccione a opção Contar do fim e indique `450` no Número de tramas. As combinações usadas nos dois exemplos anteriores são normalmente úteis para ler os dados de um ficheiro que é actualizado em tempo-real. As alterações subsequentes ao ficheiro são lidas, o que causa também uma actualização dos vectores associados.

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

  Para além dos limites inferior e superior do intervalo, podem-se definir as amostrar a ler do intervalo seleccionado. Se a opção Ler 1 amostra por N tramas (em que o N é o valor introduzido) não estiver seleccionada, serão lidas todas as amostras do intervalo indicado. Em alternativa, poder-se-ão ignorar algumas tramas do ficheiro de dados se seleccionar a opção Ler 1 amostra por N tramas. O valor da amostra que é usada para representar uma trama depende da selecção da opção Primeiro o filtro 'boxcar'. Se esta opção não estiver seleccionada, o valor é o mesmo que o da primeira amostra da trama. Se a opção estiver seleccionada, então o valor é a média de todas as amostras dessa trama em particular.

As opções do Espectro de Potência e do eixo dos X poderão ser configuradas na secção dos Tipos de Gráficos. Estas opções são descritas em baixo.

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

  Seleccione se deseja desenhar apenas o espectro de potência, apenas os dados (XY) ou ambos. Se o espectro de potência estiver seleccionado para o desenho, as opções adicionais desta secção ficam disponíveis.

Vector do Eixo dos X

  O vector a ser usado como vector independente para os gráficos. Poderá seleccionar um campo dos seus ficheiros de dados ou o vector INDEX. O vector INDEX é apenas um vector que contém os elementos de 0 a N-1, em que o N é o número de tramas do ficheiro de dados.

A secção das Opções de FFT em Tipos de Gráficos está disponível apenas se for para desenhar um espectro de potência. As definições em baixo assumem um conhecimento básico sobre os espectros de potência — para mais detalhes, baseie-se na obra "Numerical Recipes in C: The Art of Scientific Computing", publicada pela Cambridge University Press.

Média interpolada e Comprimento da FFT

  O espectro de potência é definido como a raiz quadrada do valor absoluto da média das Transformadas de Fourier Rápidas (FFT) interpoladas com um tamanho `2^x`, em que o 'x' é o valor indicado no campo de selecção do Comprimento da FFT. Se seleccionar a Média interpolada, permite indicar o tamanho das Transformadas de Fourier Interpoladas. Se a opção Média interpolada estiver desligada, o &kst; irá determinar o comprimento com base no tamanho do vector.

Unidades dos dados e Unidades da taxa

  As unidades indicadas nestes campos de texto são usadas para gerar automaticamente as legendas dos eixos para os gráficos.

Taxa de amostragem

  A taxa de amostragem é usada para gerar o eixo dos X dos gráficos do espectro de potência.

Apodizar

  Se esta opção estiver seleccionada, os dados são apodizados com uma janela de Hanning para reduzir as fugas.

Subtrair Média

  Seleccione esta opção para remover a média dos dados seleccionados (i.e., transladar os dados para que a média seja zero).

Logo que esteja satisfeito com todas as opções, carregue em Próximo para passar à próxima janela. Seleccione os filtros que desejar aplicar aos dados e carregue de novo em Próximo para passar à janela final.

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

A partir daqui, poderá alterar as opções gerais do gráfico. A maior parte das opções são auto-explicativas. Será dada uma ideia geral sobre cada secção em baixo.

Estilo da Curva

  Seleccione se deseja apenas desenhar os pontos de dados, as linhas que ligam os pontos de dados ou ambos. Por omissão, as linhas são contínuas e com espessura 0, enquanto os dados são marcados com cruzes. As cores das linhas e dos pontos dos dados são escolhidas para que as curvas com cores idênticas sejam minimizadas. Lembre-se que as opções do estilo da curva aplicam-se tanto aos Espectros de Potência como aos gráficos XY.

Colocação da Curva

  Seleccione os gráficos onde colocar as novas curvas. O Circular distribui as curvas nos gráficos, circulando por cada um deles. Lembre-se que as opções de colocação aplicam-se tanto aos Espectros de Potência como aos gráficos XY.

Geração de Legendas

  Seleccione as legendas desejadas para colocar nos gráficos.

Colocação do Gráfico

  Seleccione as janelas desejadas onde colocar os novos gráficos. As janelas novas podem ser criadas para os gráficos se seleccionar a opção Numa nova janela.

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

## O Gestor de Dados

O Gestor de Dados oferece um local central para adicionar, remover e modificar todos os objectos de dados usados no &kst;. Poderá ser acedido se seleccionar o Gestor de Dados do menu Dados.

### Criar Novos Objectos de Dados

Para criar um novo objecto de dados do Gestor de Dados, carregue num dos botões listados em Novo:. Irá aparecer uma nova janela que permite a definição das opções do objecto de dados.

Você poderá também criar curvas novas se carregar com o botão direito do rato num vector e escolher Criar Curva...

Dado que você está a criar um novo objecto de dados, poderá indicar um nome único para identificar o objecto. O nome por omissão também pode ser usado (se for único).

As opções para todos os objectos de dados desenháveis, excepto as imagens, têm duas secções comuns — a Aparência e a Colocação (as imagens só têm a secção Colocação). Estas secções são descritas em baixo. Para as opções específicas dos dados, veja os Tipos de Dados.

#### Aparência

A secção Aparência permite-lhe mudar a aparência do objecto de dados quando é desenhado.

  Se carregar neste botão irá mostrar uma janela de selecção de cores que poderá ser usada para mudar a cor das linhas e dos pontos.

Mostrar pontos

  Se seleccionar esta opção, irá mostrar os pontos de dados usados para desenhar o objecto de dados. A lista à direita permite alterar a forma dos pontos.

Mostrar linhas

  Se seleccionar esta opção irá mostrar as linhas que juntam os pontos de dados para o objecto de dados. A espessura da linha, assim como o seu estilo, poderão ser alterados.

#### Colocação

A secção de Colocação indica a localização no gráfico dos novos objectos a desenhar.

Janela de desenho

  Indique a janela na qual irá desenhar o objecto de dados. Você poderá criar uma janela nova se carregar no botão Nova....

Colocar no gráfico existente, Colocar num novo gráfico e Não colocar em nenhum gráfico

  Poderá escolher se deseja ou não desenhar imediatamente o objecto de dados num gráfico existente ou num novo. Se o Colocar num novo gráfico estiver seleccionado, poderá também optar por reorganizar a disposição do gráficos se seleccionar colocar a grelha de novo e indicar o número de colunas a usar para a nova grelha da disposição.

Logo que todas as opções desejadas para o novo objecto de dados tenham sido definidas, carregue no botão OK para criar o novo objecto de dados.

### Editar e Apagar Objectos de Dados Existentes

Para editar um objecto de dados existente, basta seleccioná-lo na janela do Gestor de Dados e carregar no botão Editar. Será então mostrada a janela de configuração para o objecto seleccionado. Este janela é idêntica à que aparece quando são criados novos objectos de dados (com a excepção do facto de a secção Colocação poder estar ausente), por isso veja a opção Criar Novos Objectos de Dados para mais informações sobre as opções e configurações.

Para remover um objecto de dados, seleccione-o na janela do Gestor de Dados e carregue no botão Remover. Repare que o item na coluna # Usado de um objecto deverá ser 0 antes de o objecto poder ser removido. A coluna # Usado indica o número de vezes que um dado objecto de dados e os seus filhos (se existirem) são usados por outro objecto de dados ou pelos gráficos. Em baixo, estão algumas consequências desta restrição a ter em mente ao tentar remover objectos de dados.

- Todos os objectos desenháveis (curvas, equações, histogramas, espectros de potência e imagens) necessitam ser removidos dos gráficos antes de estes poderem ser removidos. Um objecto poderá ser removido de um gráfico se o seleccionar com o botão direito na janela do Gestor de Dados e o escolher no sub-menu Remover do Gráfico.

- Todos os objectos de dados que usam um dado vector de dados deverão ser removidos antes que o vector de dados possa ser removido.

- Todos os filhos de um objecto-pai deverão estar livres de utilização antes de o objecto-pai poder ser removido.

Depois de uma sequência de remoções dos objectos desenháveis do gráfico, o utilizador poderá concluir que existem vários objectos de dados não usados no Gestor de Dados. Para remover rapidamente estes objectos, poderá carregar no botão Apagar.

## Tipos de Dados

Existem tipos principais de objectos de dados no &kst;. Os objectos de dados poderão conter outros objectos de dados, tal como é representado pela estrutura me árvore no Gestor de Dados. O diagrama seguinte ilustra as relações entre os diferentes tipos de dados.

Tipos de Dados do &kst;

Como pode ser visto no diagrama acima, os objectos de curvas, equações, histogramas, espectros de potência e imagens são os únicos objectos de dados desenháveis. Todos os objectos de dados (que não os vectores) têm a capacidade de usar os vectores, enquanto as equações, espectros de potência, eventos e os 'plugins' contêm todos vectores-filhos.

As descrições de cada tipo de dados encontram-se em baixo, em conjunto com as opções e configurações disponíveis ao criar ou editar cada um dos tipos de objectos de dados. As opções comuns a quase todos os tipos de dados foram omitidas — veja em Criar Novos Objectos de Dados para mais informações.

### Vectores

Os vectores são um dos objectos de dados mais usados no &kst;. Como o seu nome indica, os vectores são apenas listas ordenadas de números. Na maior parte do tempo, eles contêm as coordenadas em X e Y de um conjunto de pontos de dados.

Dado que os vectores poderão ser potencialmente muito grandes, é uma boa ideia ter uma noção da quantidade de memória que o &kst; reservou para eles. A memória disponível de momento é mostrada no canto inferior direito da barra de estado da janela principal do &kst;.

Se a barra de estado não estiver disponível, garanta que a opção Mostrar a Barra de Estado está assinalada no menu Configuração.

Segue-se uma imagem da janela apresentada ao criar ou editar vectores. As explicações das opções seguem-se em baixo.

Editar Vectores
Editar Vectores

#### Parâmetros do Vector de Dados

O ficheiro de origem e o campo a ler poderão ser definidos com as seguintes opções.

Nome do ficheiro

  A localização do ficheiro de dados desejado. Se carregar no botão à direita irá mostrar uma janela de selecção de ficheiros que poderá ser usada para escolher graficamente o ficheiro.

Campo ou coluna

  O campo ou coluna a partir do qual criar o vector.

#### Gama de Dados

Esta secção define o intervalo de dados a usar do campo seleccionado para o vector de dados.

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

  Usando estas quatro opções, pode-se definir os limites inferior e superior do intervalo de dados. Por exemplo, para ler da trama 10 à 900, indique `10` na Trama inicial e `890` para o Número de tramas. Para ler da trama 500 até ao fim do ficheiro, indique `500` para a Trama inicial e seleccione a opção Ler até ao fim. Para ler apenas as últimas 450 tramas do ficheiro, seleccione a opção Contar do fim e indique `450` no Número de tramas. As combinações usadas nos dois exemplos anteriores são normalmente úteis para ler os dados de um ficheiro que é actualizado em tempo-real. As alterações subsequentes ao ficheiro são lidas, o que causa também uma actualização dos vectores associados.

Ler 1 amostra por e Primeiro o filtro 'boxcar'

  Para além dos limites inferior e superior do intervalo, podem-se definir as amostrar a ler do intervalo seleccionado. Se a opção Ler 1 amostra por N tramas (em que o `N` é o valor introduzido) não estiver seleccionada, serão lidas todas as amostras do intervalo indicado. Em alternativa, poder-se-ão ignorar algumas tramas do ficheiro de dados se seleccionar a opção Ler 1 amostra por N tramas. O valor da amostra que é usada para representar uma trama depende da selecção da opção Primeiro o filtro 'boxcar'. Se esta opção não estiver seleccionada, o valor é o mesmo que o da primeira amostra da trama. Se a opção estiver seleccionada, então o valor é a média de todas as amostras dessa trama em particular.

### Curvas

As curvas são usadas principalmente para criar objectos desenháveis a partir de vectores. As curvas são criadas a partir de dois vectores - um vector no eixo dos X e um vector no eixo dos Y, que oferecem presumidamente um conjunto de pontos de dados. Como tal, uma curva pode ser vista como um conjunto de pontos de dados e as linhas que os ligam (ainda que os pontos ou linhas possam não estar visíveis nos gráficos).

Segue-se uma imagem da janela apresentada ao criar ou editar curvas. As explicações das opções seguem-se em baixo.

Editar Curvas
Editar Curvas

#### Conteúdo da Curva

O conteúdo da curva pode ser escolhido nesta secção.

Vector do eixo X

  O vector a utilizar para o eixo independente (horizontal).

Vector do eixo Y

  O vector a utilizar para o eixo dependente (vertical).

Barra de erro em +X e Barra de erro em +Y

  Os vectores que contêm os valores de erros que correspondem ao vector do eixo dos X e dos Y, respectivamente. Os vectores deverão conter os tamanhos das barras de erros pela mesma ordem que os pontos de dados.

Usar a barra de erros +X/Y para o -X/Y

  Se este item estiver assinalado, as barras de erros são desenhadas de forma simétrica em torno do ponto de dados. Para desenhar barras de erro assimétricas na direcção X ou Y, desligue a opção e escolha um vector para o comprimento da barra de erros, por baixo do ponto de dados, na lista barra de erros -X/Y.

Barra de erros -X/Y

  O vector a usar para a barra de erros por baixo do ponto de dados. Veja o item anterior para mais detalhes sobre a utilização de barras de erros assimétricas.

### Equações

Um objecto de dados de uma equação consiste numa expressão matemática e numa variável independente. A expressão é criada com uma combinação de valores escalares, vectores e operadores e representam normalmente os valores da variável dependente. A variável independente poderá ser um vector existente ou poderá ser gerada quando o objecto da equação for criado ou editado. Dado que uma equação consiste, em última instância, a um conjunto de pontos de dados, um objecto de uma equação pode ser desenhado.

Segue-se uma imagem da janela apresentada ao criar ou editar equações. As explicações das opções seguem-se em baixo.

Editar Equação
Editar Equação

#### Equação

A expressão matemática que representa a variável dependente poderá ser modificada nesta secção.

Operadores

  Uma lista com os operadores disponíveis. Se escolher um operador na lista irá inseri-lo na posição actual no campo de texto Equação.

Vectores

  Uma lista com os objectos actuais do vector no &kst;. Se escolher um vector na lista irá inseri-lo na posição actual do campo de texto Equação.

Escalares

  Uma lista com os valores escaláveis disponíveis. Esta lista é composta tanto pelos valores escalares na sessão actual do &kst; como por algumas constantes predefinidas. Se escolher um valor escalar na lista irá inseri-lo na posição actual do campo de texto Equação.

Equação

  A expressão matemática que representa a variável independente. Poderá escrever manualmente neste campo de texto ou poderá seleccionar os itens a inserir com as listas descritas acima.

#### Variável Independente

Este secção é utilizada para indicar a fonte dos valores da variável independente.

Utilizar

  Seleccione esta opção para usar um vector existente como variável independente. Seleccione um vector da lista ou crie rapidamente um ao carregar no botão à direita.

Interpolar para o vector-solução mais elevado

  Se seleccionar esta opção, irá interpolar o vector seleccionado para o número máximo de amostras possível.

Gerar

  Seleccione isto para gerar um conjunto de valores a usar como variável independente. Indique o valor mais baixo a gerar no campo De, assim como o valor máximo no campo até. Indique o valor do Número de amostras como sendo o número de valores com intervalos de igual modo a gerar entre o valor mínimo e o máximo (inclusive).

### Histogramas

Um objecto de dados de histograma representa um histograma de um dado vector. Os objectos de histogramas poderão ser desenhados.

Segue-se uma imagem da janela apresentada ao criar ou editar histogramas. As explicações das opções seguem-se em baixo.

Editar Equação
Editar Equação

#### Propriedades do Histograma

O vector de origem, assim como as propriedades básicas do histograma, poderão ser modificadas nesta secção. Tanto poderá indicar manualmente as opções como usar o botão Grupo Automático.

Vector de dados

  O vector de dados a partir do qual criar o histograma. Ainda que seja necessário um vector para criar um histograma, o vector é usado como um conjunto não ordenado.

De e até

  O campo De contém o limite esquerdo do grupo mais à esquerda do histograma. O campo Até contém o limite direito do grupo mais à direita no histograma.

Número de grupos

  Indique o número total de grupos a usar no campo Número de grupos.

Grupos Automáticos

  Em vez de indicar valores para os campos De, Até e Número de grupos, poderá criar em Grupo Automático para gerar automaticamente os valores para todos os três campos, baseando-se nos valores mínimo e máximo, assim como no número de elementos encontrado no vector de origem.

#### Normalização do Eixo Y

Esta secção é usada para indicar o tipo de normalização usada para o eixo dos Y no histograma.

Número no grupo

  Se seleccionar esta opção o eixo dos Y no histograma indica o número de amostras no grupo.

Fracção no grupo

  Se seleccionar esta opção faz com que o eixo dos Y represente a fracção dos elementos em cada grupo face ao número total de elementos.

Percentagem no grupo

  Se seleccionar esta opção faz com que o eixo dos Y represente a percentagem dos elementos (face ao número total de elementos) em cada grupo.

Grupo de pico = 1.0

  Se seleccionar esta opção faz com que o eixo dos Y represente o número de elementos em cada grupo, dividido pelo número de elementos no grupo maior (o grupo com o maior número de elementos). Por outras palavras, o eixo dos Y fica normalizado a 1,0.

### Espectro de Potência

Um objecto de dados do espectro de potência representa o espectro de potência de um vector, que é definido como a raiz quadrada do valor absoluto da média das Transformadas de Fourier Rápidas (FFT) interpoladas com um tamanho `2^x`, em que o 'x' é o valor indicado no campo de selecção do Comprimento da FFT. As definições em baixo assumem um conhecimento básico sobre os espectros de potência — para mais detalhes, baseie-se na obra "Numerical Recipes in C: The Art of Scientific Computing", publicada pela Cambridge University Press.

Janela de Espectro de Potência
Janela de Espectro de Potência

#### Conteúdo da Curva

O vector de origem, assim como as propriedades básicas do espectro de potência, poderão ser modificadas nesta secção.

Vector de dados

  O vector de dados a partir do qual criar o espectro de potência.

Média interpolada e Comprimento da FFT

  Se seleccionar a Média interpolada permite indicar o tamanho das Transformadas de Fourier Rápidas. O comprimento é indicado como uma potência de 2. Se a Média interpolada não for indicada, o &kst; irá determinar o tamanho com base no comprimento do vector.

Unidades dos dados e Unidades da taxa

  As unidades indicadas nestes campos de texto são usadas para gerar automaticamente as legendas dos eixos para os gráficos.

Taxa de amostragem

  A taxa de amostragem é usada para gerar o eixo dos X dos gráficos do espectro de potência.

Apodizar

  Se esta opção estiver seleccionada, os dados são apodizados com uma janela de Hanning para reduzir as fugas.

Subtrair Média

  Seleccione esta opção para remover a média dos dados seleccionados (i.e., transladar os dados para que a média seja zero).

### 'Plugins'

Um objecto de dados de um 'plugin' representa um 'plugin' do &kst;. Todos os 'plugins' têm um formato comum e aparecem como o tipo Plugin no Gestor de Dados. Para mais informações sobre os 'plugins', veja por favor os 'Plugins' e Filtros

### Monitores de Eventos

Um objecto de dados de um monitor de eventos representa uma instância de um monitor de eventos. Para mais informações sobre a monitorização de eventos, veja a secção respectiva.

### Matrizes

Uma matriz representa um conjunto de pontos de dados tridimensionais (x, y, z) organizados numa grelha bidimensional. Os valores do Z para a matriz são obtidos a partir de um vector e a estrutura em grelha é indicada manualmente com a janela para Editar ou Nova Matriz. As descrições em baixo referem-se ao diagrama seguinte, demonstrando a estrutura em matriz do &kst;.

Segue-se uma imagem e uma explicação da janela de matrizes.

Janela de Matrizes
Janela de Matrizes

#### Escolha de Vector

Vector Z

  O vector de dados a partir do qual obter os valores de z.

#### Parâmetros da Grelha

X Mínimo e Y Mínimo

  A origem da matriz é indicada pelas coordenadas (X Mínimo, Y Mínimo). A localização da origem é representada por um círculo vermelho no diagrama acima.

Tamanho do Passo em X e Tamanho do Passo em Y

  Estes dois valores definem as dimensões de cada célula rectangular na grelha da matriz. Todas as células na matriz têm dimensões idênticas.

Dimensões e Usar o comprimento em X máximo

  Indique o número de passos para a dimensão X da matriz, seguido do número de passos para a dimensão Y da mesma matriz. Se a opção Usar o comprimento em X máximo estiver assinalada, a dimensão em X da matriz será determinada com base no comprimento do vector e na dimensão em Y introduzida. Se esta opção estiver assinalada e o comprimento do vector alterar em consequência disso, a dimensão em X da matriz será actualizada adequadamente.

  Lembre-se que a dimensão mínima permitida em Y é 1, enquanto que a mínima permitida em X é 0.

### Imagens

As imagens são representações gráficas das Matrizes. As imagens poderão ser desenhadas como mapas de cores, mapas de contorno ou ambas.

Janela de Imagem
Janela de Imagem

#### Escolha de Matriz

Matriz

  Seleccione a matriz a usar para esta imagem. As matrizes novas podem ser criadas ao carregar no botão à direita.

#### Tipo de Imagem

Mapa de Cores, Mapa de Contorno e Mapa de Cores e Mapa de Contorno

  Seleccione o tipo de imagem a desenhar. Se alterar esta selecção irá activar ou desactivar certas secções da janela da forma que for apropriada.

#### Parâmetros do Mapa de Cores

Um mapa de cores representa o valor do Z de cada célula da matriz com uma cor. Esta secção só fica disponível se o Mapa de Cores ou o Mapa de Cores e Mapa de Contorno estiverem seleccionados no Tipo de Imagem.

Paleta de cores

  Seleccione a paleta de cores a usar para o mapa de cores. Por omissão, estão instaladas para o &kst; duas paletas de cores adequadas para os mapas de cores —a Kst Grayscale 256 (uma paleta com 256 tons de cinzento) e a Kst Spectrum 1021 (uma paleta em arco-íris com 1021 cores que vai do azul ao vermelho). Poder-se-ão instalar novas paletas se copiar ficheiros de paletas compatíveis com o GIMP para a subpasta `colors` da pasta de configuração do utilizador (por exemplo, a `/usr/share/config/colors/`). Repare que as imagens gravadas que usem uma paleta não-predefinida poderão não ser visíveis por outros utilizadores do &kst; se eles não tiverem essa paleta. Nesse casos, é usada uma paleta de tons de cinzento por omissão.

Limite inferior do Z, Limite superior do Z e Limite Automático

  Indique os limites inferior e superior a usar para o mapeamento das cores. As cores da paleta são distribuídas de forma uniforme entre o Limite inferior do Z e o Limite superior do Z. Todas as células da matriz seleccionada com valores em Z inferiores ao Limite inferior do Z serão mapeados à primeira cor da paleta. Todas as células da matriz seleccionada com valores em Z maiores do que o Limite superior do Z serão mapeados na última cor da paleta. Se carregar no Limite Automático, irá preencher os valores do limite inferior e superior com os valores mínimos e máximos de Z encontrados na matriz seleccionada.

#### Parâmetros do Mapa de Contorno

Um mapa de contorno desenha um conjunto de linhas, em que cada linha representa um dado valor em Z. Esta secção só fica disponível se o Mapa de Contorno ou o Mapa de Cores e Mapa de Contorno estiver seleccionado no Tipo da Imagem.

Número de níveis de contorno

  Seleccione o número de níveis de contorno a usar. Os níveis de contorno serão distribuídos de forma uniforme entre o valor mínimo e máximo do Z na matriz.

Cor

  Seleccione a cor a usar para as linhas de contorno. Se carregar neste botão irá abrir uma janela de selecção de cores normal do &kde;.

Espessura e Utilizar espessura de linha variável

  Seleccione a espessura das linhas de contorno. Se a opção Utilizar espessura de linha variável, as linhas de contorno que representem elevações maiores são desenhadas mais grossas do que as de menor elevação. Use alguma discrição ao usar esta opção, dado que as imagens com grandes densidades de linhas de contorno grossas podem-se tornar ilegíveis.

## O Menu Dados

O menu de Dados oferece um acesso rápido a muitas funcionalidades relacionadas com os objectos de dados no &kst;. A maioria das funções do menu duplicam as funções existentes noutros locais, como tal só são dadas algumas breves descrições em baixo.

Actualizar

  Actualiza os dados actuais a partir dos seus ficheiros de origem.

Assistente de Dados...

  Mostra o Assistente de Dados.

Gestor de Dados

  Mostra o Gestor de Dados.

Novo [objecto de dados]

  Mostra a janela correspondente para criar o objecto de dados. Veja os Tipos de Dados para uma descrição de cada janela.

Ver os Escalares

  Mostra uma janela na qual todos os valores escalares da sessão actual do &kst; poderão ser vistos. A janela é actualizada dinamicamente se os valores mudarem.

Ver os Vectores

  Mostra uma janela na qual todos os vectores actuais poderão ser vistos. Seleccione o vector a visualizar na lista respectiva. A janela é actualizada dinamicamente se os valores mudarem.

Ver os Resultados de Ajuste

  Mostra uma janela que apresenta todos os valores resultantes dos ajustes efectuados. Seleccione um resultado de um ajuste com a lista respectiva. A janela é actualizada dinamicamente se os valores mudarem.

Mudar o Ficheiro de Dados

  Mostra uma janela para alterar rapidamente os ficheiros de dados com os quais estão associados os vectores. Seleccione os vectores a alterar e escolha depois um ficheiro de dados diferente. Carregue em Aplicar para gravar as alterações.