# O Manual do &cantor;

## Introdução

O &cantor; é uma aplicação que lhe permite usar as suas aplicações matemáticas favoritas dentro de uma interface de área de trabalho agradável e integrada no &kde;. Oferece janelas de assistência para as tarefas mais comuns e permite-lhe partilhar as suas folhas de cálculo com os outros.

## Usar o &cantor;

Imagem: Aqui está uma imagem do &cantor; Imagem

### Funcionalidades do &cantor;

- Uma área de trabalho agradável para avaliar expressões.

- Área para visualizar os gráficos dos resultados na área de trabalho.

- Uma estrutura simples e baseada em 'plugins' para adicionar diferentes infra-estruturas.

- Integração do GetHotNewStuff para obter folhas de cálculo de exemplo (ou enviá-las.)

- Formatação das fórmulas matemáticas com o &latex;.

- Realce de sintaxe ciente da infra-estrutura.

- Janelas de assistência baseadas em 'plugins' para as tarefas mais comuns, como a integração de uma função ou a introdução de uma matriz.

### As infra-estruturas do &cantor;

O &cantor; oferece-lhe diversas opções para a infra-estrutura que poderá usar à vontade. A sua escolha deverá depender da tarefa que pretende efectuar.

De momento, estão disponíveis as seguintes infra-estruturas:

Sage:

- O Sage é um sistema de 'software' matemático livre e 'open-source', licenciado segundo a GPL. Combina o poder de muitos pacotes 'open-source' existentes com uma interface comum e baseada em Python. Veja mais informações em http://sagemath.org.

Maxima:

- O Maxima é um sistema para a manipulação de expressões simbólicas e numéricas, incluindo a derivação, a integração, as séries de Taylor, as transformadas de Laplace, as equações diferenciais ordinárias, os sistemas de equações lineares, os polinómios e os conjuntos, listas, vectores, matrizes e tensores. O Maxima oferece resultados numéricos de alta precisão, usando fracções exactas, inteiros de precisão arbitrária e números de vírgula flutuante de precisão variável. O Maxima pode desenhar gráficos das funções e de dados em duas e três dimensões. Veja o http://maxima.sourceforge.net para obter mais informações.

R:

- O R é uma linguagem e um ambiente para a computação e gráficos estatísticos, de forma semelhante à da linguagem e ambiente S. Oferece uma grande variedade de técnicas gráficas e estatísticas (modelação linear e não-linear, testes estatísticos clássicos, análises de séries temporais, classificação, agrupamentos, ...), sendo também altamente extensível. A linguagem S é normalmente o veículo de escolha para a investigação de metodologias estatísticas, sendo que o R oferece uma rota 'open-source' para participar nessa actividade. Veja mais informações em http://www.r-project.org.

KAlgebra:

- O KAlgebra é uma calculadora gráfica, baseada em MathML, que vem com o projecto de educação do KDE. Veja mais informações em http://edu.kde.org/kalgebra/.

Qalculate!:

- O Qalculate! não é uma réplica em 'software' da sua calculadora barata normal. O Qalculate! tenta tirar partido completo da interface superior, das potencialidades e da flexibilidade dos computadores modernos. O foco de atenção no Qalculate! é a introdução da expressão. Em vez de introduzir cada número numa expressão matemática separada, poderá introduzir directamente a expressão inteira e depois modificá-la. A interpretação das expressões é flexível e tolerante a erros e, caso faça algo de errado à mesma, o Qalculate! dizer-lhe-á qualquer coisa. Nem todas as expressões solúveis são de facto erros. O Qalculate! irá simplificar ao máximo e responder com uma expressão. Para além dos números e operações aritméticas, uma expressão poderá conter uma combinação arbitrária de variáveis, unidades e funções. Veja mais informações em http://qalculate.sourceforge.net/.

Scilab:

- O Scilab é um pacote de computação numérica livre e multi-plataforma, assim como uma linguagem de programação numérica.

  O Scilab está distribuído segundo a licença CeCILL (compatível com a GPL). Veja mais informações em http://www.scilab.org/.

  É necessário ter instalado o Scilab na versão 5.4 ou superior no seu sistema para que esta infra-estrutura possa ser usada.

Octave:

- O Octave da GNU é uma linguagem de alto-nível, destinada principalmente para cálculos numéricos. Oferece uma interface conveniente por linha de comandos para resolver problemas lineares e não-lineares de forma numérica e para fazer outras experiências matemáticas, usando uma linguagem que é compatível de um modo geral com o MATLAB. Para mais informações, veja em http://www.gnu.org/software/octave/.

### O Espaço de Trabalho do &cantor;

Imagem do Espaço de Trabalho do &cantor; Imagem do Espaço de Trabalho do &cantor;

A interface da folha de cálculo do &cantor; consiste em três partes:

1. A barra de páginas, onde poderá circular entre as folhas de cálculo abertas.

2. Um painel de ajuda, onde poderá obter ajuda sobre um determinado comando com a sintaxe "? comando".

3. Um painel de Gestão de Variáveis, onde poderá ver uma lista com todas as variáveis disponíveis na folha de trabalho actual. O painel de Ajuda e de Gestão de Variáveis serão apresentados como páginas na barra lateral de uma janela do &cantor;. O gestor de variáveis poderá ser usado apenas para as infra-estruturas do Maxima (se estiver activo na página Configuração Configurar o &cantor;... Maxima), o KAlgebra, o Octave e no Qualculate.

4. A folha de cálculo em si.

#### A Folha de Cálculo

A folha de cálculo é a área básica para trabalhar com o &cantor;. Nela, poderá introduzir as expressões, deixar que a infra-estrutura faça os seus cálculos e olhar para os resultados. Os comandos que as folhas de cálculo aceitam dependem da infra-estrutura escolhida, pelo que deverá aprender a Documentação apropriada (o botão Mostrar a Ajuda leva-o lá directamente). Se souber o comando, mas se necessitar de informações adicionais, poderá escrever "? `comando`", para que apareça uma ajuda de contexto à direita da área de trabalho. Se quiser ver folhas de exemplo, poderá ir à opção Obter Folhas de Exemplo no menu Ficheiro e obter as folhas que outros utilizadores tiverem publicado.

Para controlar cada elemento de comando na folha de trabalho, poderá usar os botões de controlo que aparecem à direita da folha de trabalho, ao passar o cursor do rato sobre o campo de um elemento. Existem três acções básicas para cada elemento: Avaliar o Elemento, para actualizar o resultado do cálculo do elemento, Arrastar o Elemento para passar o elemento para outro local da folha de trabalho actual e Remover o Elemento para retirar o elemento da folha de trabalho actual.

As definições do tipo de letra e alinhamento das folhas de trabalho poderão ser alterados com a barra de ferramentas por cima da folha de trabalho.

##### Configuração

O menu de Configuração permite-lhe alterar algumas opções da aparência da sua folha de cálculo actual.

Formatação com o &latex;

- Esta opção muda a forma como os resultados são apresentados a si. Se estiver activada, irá passar o resultado pelo sistema &latex;, de modo a produzir fórmulas apelativas visualmente. Por exemplo, o 3*x^2*sqrt(2)*x+2/3 transforma-se em 3*x^2*sqrt(2)*x+2/3

Realce de Sintaxe

- O Realce de Sintaxe aumenta a legibilidade do código, realçando as palavras-chave ou os parêntesis correspondentes com cores diferentes.

Completação

- Quando esta opção estiver activa, o &cantor; mostrar-lhe-á completações possíveis para o comando que estiver a escrever de momento, ao usar a tecla Tab. Se só existir uma escolha possível, irá inserir o resto do comando para si.

Números de Linha

- Esta opção controla se as diferentes expressões deverão ter um número à frente, de modo que, se possível, possa por exemplo no Maxima voltar a invocar os resultados mais antigos com o comando %O1.

Avaliar a Folha de Cálculo

- Esta definição controla se as diferentes animações serão usadas para realçar as alterações de uma folha de cálculo.

## Referência de Comandos

### A janela principal do &cantor;

O &cantor; tem os itens de menu comuns do &kde;; para mais informações, leia o capítulo do Menu dos Fundamentos do &kde;.

Itens adicionais ou especiais do &cantor;:

#### O Menu Ficheiro

&Ctrl;N Ficheiro Novo

- Cria uma nova folha de trabalho com a infra-estrutura predefinida.

Ficheiro Novo `Infra-Estrutura`

- Cria uma nova folha de trabalho com a infra-estrutura escolhida.

Ficheiro Obter uma Folha de Exemplo

- Abre a janela para obter exemplos enviados por outros utilizadores do &cantor; com o GetHotNewStuff.

Ficheiro Abrir um Exemplo

- Abre a janela para escolher um exemplo a carregar. Os exemplos deverão ser transferidos com a opção Ficheiro Obter uma Folha de Trabalho de Exemplo de antemão.

Ficheiro Gravar Como Texto Simples

- Permite gravar a folha de trabalho actual como um documento em texto simples.

Ficheiro Exportar para LaTeX

- Permite gravar a folha de trabalho actual como um documento em &latex;.

Ficheiro Publicar a Folha de Trabalho

- Abre a janela para publicar a sua folha de trabalho actual e disponibilizá-la para os outros utilizadores do &cantor; através do GetHotNewStuff.

Ficheiro Executar o Programa

- Permite carregar e executar os programas em lote da infra-estrutura actual.

#### O Menu Ver

&Ctrl;+ Ver Ampliar

- Amplia a folha de trabalho actual em 10%.

&Ctrl;- Ver Reduzir

- Reduz a folha de trabalho actual em 10%.

Ver Mostrar o Editor de Programas

- Abre a janela de edição de programas em lote para a infra-estrutura actual.

Ver Painéis Ajuda

- Activa ou desactiva a visibilidade da barra de Ajuda na barra lateral.

Ver Painéis Gestor de Variáveis

- Activa ou desactiva a visibilidade da barra de Gestão de Variáveis na barra lateral.

#### O Menu Folha de Trabalho

Folha de Trabalho Avaliar a Folha de Trabalho

- Despoleta a avaliação da folha de trabalho por inteiro.

&Shift;Return Folha de Trabalho Avaliar o Item

- Despoleta a avaliação do item actual.

&Ctrl;Return Folha de Trabalho Inserir um Item de Comando

- Introduz um novo item de comando abaixo da posição actual do cursor.

Folha de Trabalho Inserir um Item de Texto

- Introduz um novo item de texto abaixo da posição actual do cursor.

Folha de Trabalho Inserir uma Imagem

- Introduz o modelo de imagem abaixo da posição actual do cursor. Terá de carregar com o &RMB; no modelo para configurar os detalhes da imagem.

Folha de Trabalho Inserir uma Quebra de Página

- Introduz uma quebra de página abaixo da posição actual do cursor.

&Shift;Del Folha de Trabalho Remover o Item Actual

- Remove o item actual da folha de trabalho.

#### O Menu Configuração

Este menu contém os itens de Configuração normais do &kde;, assim como os itens descritos na secção de Configuração.

#### O Menu Ajuda

&help.menu.documentation;

## Guia de Programação do &cantor;

O &cantor; é facilmente extensível com 'plugins'. Poderá criar

Infra-estruturas:

- Uma nova infra-estrutura permite-lhe usar a interface do &cantor; com um programa diferente.

Assistentes:

- Os assistentes são janelas que automatizam as tarefas mais comuns (como a introdução de uma matriz ou a execução de um programa.)

De momento, não existem nenhuns tutoriais de desenvolvimento ou documentação da API; por isso, se precisar de criar um 'plugin', terá de consultar o código. Todas as definições da interface estão na pasta `lib`. Para as implementações de exemplo, veja alguns dos 'plugins' que vêm com o &cantor;.

## Perguntas e Respostas

&reporting.bugs; &updating.documentation;

O Item do Menu Formatação com o LaTeX não está disponível

Nem todas as infra-estruturas suportam todas as opções. A versão actual suporta o resultado em &latex; para as infra-estruturas Maxima, Qualculate! e Sage.

Instalei o Sage/Maxima, mas a infra-estrutura apropriada não aparece.

Talvez o &cantor; não tenha detectado a localização correctamente. Vá à janela em Configuração Configurar o &kappname;... e mude a localização da aplica apropriada.

Que nome mais estranho - o que é que tem a ver com matemática?

Cantor vem do matemático Alemão Georg Cantor, o criador da teoria dos conjuntos.

## Créditos e Licença

&cantor;

Programa com 'copyright' 2009-2011 de Alexander Rieder alexanderrieder@gmail.com

Documentação com 'copyright' © 2009-2011 de Alexander Rieder alexanderrieder@gmail.com

Tradução de José Nuno Pires zepires@gmail.com

&underFDL; &underGPL;

## Instalação

### Como obter o &cantor;

&install.intro.documentation;

### Requisitos

Para poder usar com sucesso o &cantor;, necessita do &kde; 4. Se quiser suporte para a formatação dos dados, necessita do &latex; e da LibSpectre. Para usar as diferentes infra-estruturas, é necessário o pacote matemático apropriado.

### Compilação e Instalação

&install.compile.documentation;

### Configuração

Dependendo do seu sistema, poderá ter de ajustar as localizações para as diferentes aplicações usadas pelo &cantor;.

&documentation.index;