Geração de Legenda
A interface de geração de legenda, mostrada na Figura 1, permite criar um novo ou importar um agrupamento de outro tema.

Fig. 1 - Interface de geração de legenda.
A importação serve para recuperar valores de agrupamento usados em outros temas. Ela é feita ativando-se o check box "Importar". A Figura 2 mostra a caixa de importação desativada e a Figura 3 mostra a caixa depois da ativação do check box.

Fig. 2 - Caixa de importação de agrupamento desativada.

Fig. 3 - Caixa de importação de agrupamento ativada.
Para importar, ative o check box "Importar" e selecione o tema desejado. Ao pressionar o botão "Importar" os parâmetros de agupamento do tema selecionado são recuperados pelo módulo.
OBS: A lista de temas para importação é filtrada de modo que mostre apenas temas com agrupamento por passos iguais ou quantil. Temas agrupados por desvio padrão ou valor único não são possíveis de serem importados.
A importação é feita mesmo que os temas não usem o mesmo plano de informação. Caso o tema corrente não possua o mesmo nome do atributo do tema importado, é enviada uma mensagem de aviso. Neste caso, tudo é recuperado menos o nome do atributo.
Após a importação, não mude os parâmetros da caixa "Parâmetros de Agrupamento" mostrada na Figura 4. Qualquer mudança nos parâmetros de agrupamento anula a legenda recuperada. Para finalizar a legenda importada pressione o botão "Executar" na parte inferior da interface.

Fig. 4 - Parâmetros de agrupamento para criar legenda.
Criar nova legenda
Para criar uma legenda é necessário configurar os parâmetros da Figura 4.
O combo "Modo" tem uma lista com os tipos de agrupamento disponíveis que são:
O combo "Atributo" tem uma lista com todos os atributos do tema.
O combo "Número de Fatias", utilizado em passos iguais e quantil, possibilita gerar legenda com até 200 grupos.
O combo "Desvio Padrão", utilizado em agrupamento por desvio padrão, permite gerar grupos separados por:
1 desvio padrão,
1/2 desvio padrão ou
1/4 desvio padrão.
O combo "Precisão" define o número de casas decimais para geração da legenda.
O combo "Função" é aplicado quando o atributo necessita de uma função de agregação.
Os parâmetros referentes a dados temporais (Crono, Intervalo de Crono e Data/Tempo) encontram-se desativados nesta versão.
Esses parâmetros, uma vez configurados, são utilizados para calcular e mostrar a legenda na parte inferior da interface. A aplicação desses parâmetros é feito pelo botão "Aplicar".
Definição das cores
Uma vez mostrada a legenda, pode-se ajustar as cores através da caixa "Cores" mostrada na Figura 5.

Fig. 5 - configuração de cores da legenda.
As cores da legenda são definidas a partir da barras de cores.
De acordo com a sequência das cores selecionadas são produzidas as cores da legenda.
O botão "Limpar" retira as corers da barra e o botão "Inverter" inverte a sequencia de cores da barra.
O botão "Salvar" permite que o usuário crie sua própria barra de cores e a salve no banco de dados.
O botão "Intervalos iguais" espaça igualmente as cores presentes na barra.
A lista no quadro "Carregar barra de cores" permite recuperar uma das barras salvas.
Nota: O estilo do visual não é alterado neste módulo. O visual utilizado contem o estilo do visual default do tema.
Edição manual da legenda
A edição manual deve ser feita sobre a legenda mostrada na parte inferior da interface com o auxílio do mouse e do teclado.
Durante e após a edição não mude a configuração da caixa "Parâmetros de Agrupamento". Qualquer alteração nos parâmetros faz perder a edição porque isso apaga a legenda mostrada. Também não pressione o botão "Aplicar" porque isso recalcula e gera uma nova legenda.
O ajuste de cores pode ser feito a qualquer momento sem que haja perda de edição.
Após concluida a edição pressione o botão "Executar" para salvar e desenhar o tema.
Nota: Quando é feito uma edição, o campo "Contagem" fica desatualizado até que botão "Executar" seja pressionado.
Outros modos de agrupamento
Quando nenhum dos modos aqui implementados são desejados, pode-se criar uma nova legenda através da edição manual. Neste caso, aplique um agrupamento por passos iguais selecionando o atributo e o número de fatias. Em seguida faça as edições sobre a legenda mostrada na parte inferior da interface. Por fim, ajuste as cores e pressione o botão "Executar".
Considerações sobre as formas de agrupamento
O modo de agrupamento por passos iguais produz o mesmo intervalo de valores em cada grupo. Para exemplificar, caso o valor mínimo de um atributo seja 0, o valor máximo 20 e o número de fatias 5, o módulo calcula o range de valores em cada grupo da seguinte forma:
substituindo, temos:
Então, neste exemplo, cada grupo tem intervalo de valores igual a 4. Portanto, resulta em:
grupo 1: 0 ~ 4 (note que o intervalo é 4 - 0 = 4)
grupo 2: 4 ~ 8 (note que o intervalo é 8 - 4 = 4)
grupo 3: 8 ~12 (note que o intervalo é 12 - 8 = 4)
grupo 4: 12 ~16 (note que o intervalo é 16 - 12 = 4)
grupo 5: 16 ~20 (note que o intervalo é 20 - 16 = 4)
A Figura 6 mostra a legenda criada por esse agrupamento.
Fig. 6 - Resultado de um agrupamento por passos iguais.
Considerações sobre a forma de apresentação e execução da legenda
Na legenda, a fim de simplificar, não são mostrados os sinais matemáticos de inclusão e exclusão.
Do primeiro ao penúltimo grupo os intervalos considerados vão de inclusive a exclusive. Assim, neste exemplo temos:
0 <= v < 4 (valores entre 0 e 4, onde 0 é inclusive e 4 é exclusive)
4 <= v < 8 (valores entre 4 e 8, onde 4 é inclusive e 8 é exclusive)
8 <= v < 12 (valores entre 8 e 12, onde 8 é inclusive e 12 é exclusive)
12 <= v < 16 (valores entre 12 e 16, onde 12 é inclusive e 16 é exclusive)
No último grupo os intervalos vão de inclusive a inclusive, ou seja:
16 <= v <= 20 (valores entre 16 e 20, onde 12 é inclusive e 20 tambem é inclusive)
O modo de agrupamento por quantil procura gerar a mesma quantidade de objetos em cada grupo. Dessa forma não é o intervalo de valores que é constante. O que deve ser mantido aqui é número de objetos constante em cada grupo. Essa forma de agrupamento ajuda a visualizar como um dado é percentualmente distribuido. A Figura 6 mostra o resultado de um agrupamento por quantil efetuado pelo módulo.
Fig. 6 - Resultado de um agrupamento por quantil.
Na Figura 6 observa-se que a Contagem de objetos é próxima de 18 em cada grupo.
O modo de agrupamento por desvio padrão produz os intervalos em função do valor de desvio padrão em torno da média. Neste caso, o número de fatias ou de grupos depende dos dados do tema. Essa forma de agrupamento ajuda a analizar o comportamento dos dados em torno da média. A Figura 7 mostra o resultado de um agrupamento por desvio padrão efetuado pelo módulo.
Fig. 7 - Resultado de um agrupamento por desvio padrão usando a cor laranja.
No agrupamento por desvio padrão, o módulo produz uma linha a mais em sua legenda para exibir o valor da média. Observe que cada intervalo de valores, abaixo e acima da média, é igual ao valor do desvio configurado na interface que pode ser: 1, 1/2 ou 1/4.
Neste tipo de agrupamento as cores são dispostas de forma que possa distinguir quais são os objetos que estão perto da média e quais se afastam da média. Note que, conforme se afasta da média, a cor se torna cada vez mais clara. A barra de cores que produziu esse resultado é ilustrado na Figura 8.

Fig. 8 - Barras de cores utilizadas no agrupamento por desvio padrão.
A barra superior configura as cores para definir as legendas que ficam abaixo da média e a barra inferior para definir as legendas que ficam acima da média. No exemplo da Figura 7 , em particular, não é possivel distinguir, pelas cores, quais objetos se afastam da média para cima e da média para baixo. Entretanto, alterando-se as cores das barras pode-se definir legendas de forma a produzir adequadamente essas distinções. A Figura 9 mostra a mesma legenda produzida pelas barras de cores da Figura 10.

Fig. 9 - Resultado de um agrupamento por desvio padrão usando a cor azul e vermelha.

Fig. 10 - Resultado de um agrupamento por desvio padrão usando a cor azul e vermelha.
As mesmas legendas pode ser gerada com as tonalidades invertidas. Isso é feito pressionando-se o botão "Inverter" da caixa "Cores". A Figura 11 mostra a legenda com as tonalidade invertidas.

Fig. 11 - Legenda com as tonalidades invertidas.
O agrupamento por desvio padrão é representado graficamente pela Figura 12. Esse gráfico ilustra uma típica curva de distribuição normal com média e intervalos de desvio padrão igua a 1. Os intervalos podem variar de 1, 1/2 e 1/4, onde cada intervalo é pintado com uma cor.

Fig. 10 - Típica curva de distribuição normal mostrando a média e os intervalos de desvio padrão.
O modo de agrupamento por valor único é utilizado para qualquer tipo de atributo (INTEIRO, REAL, STRING, TEMPO, etc). Nesse tipo de agrupamento é dado um visual para cada valor distinto de atributo. Ele é usado, normalmente, para ilustrar um dado qualitativo. Por exemplo, tipo de soja, tipo de solo, raça, etc. Enfim, valores que não são grandes em número ou variedade. Geralmente, ele não deve ser usado em dados quantitativos porque podem produzir uma enorme quantidade de legendas. Por exemplo, população, etc.
A Figura 11 mostra o resultado de um agrupamento por valor único efetuado pelo módulo.

Fig. 11 - Resultado de um agrupamento por valor único.
O limite máximo para o número de grupos em uma legenda é de 200 grupos. Quando esse número é ultrapassado é enviado uma mensagem. Neste caso a legenda não é gerada.
A Função de agregação é utilizada na sumarização de dados. No módulo ela é ativada toda vez que o atributo utilizado no agrupamento vem de uma tabela externa ou temporal. Nesse caso, cada objeto pode ter vários valores e é sumarizado por uma função estatistica. As funções válidas são:
MIN (mínimo)
MAX (máximo)
SUM (soma)
AVG (média) e
COUNT (contagem)
Missing Data
Objetos com valores desconhecidos são agrupados no grupo chamado "Missing data". Esse grupo é automaticamente gerado quando existe algum valor desconhecido no atributo utilizado para fazer o agrupamento. Esse grupo é sempre representado, por default, com a cor branca e aparece em último na legenda.