Double énonciation

Todas as variáveis que foram referidas nas opções de processamento, com exceção das variáveis opcionais são justamente as variáveis a mapear em variáveis visuais do mapa. As opções de mapeamento que veremos de seguida servem precisamente para esse efeito. Nestas opções, para cada variável que será mapeada por uma variável visual, tem de ser fornecida informação adicional que será depois usada para o referido mapeamento.

A API Temporal Gisplay conta com as seguintes variáveis visuais: cor, forma, textura, tamanho e orientação. Para cada uma delas é preciso determinar quais os mapeamentos possíveis, sendo possível ver precisamente isso na tabela5.2.

Variável Visual Variável Categórica Variável Contínua

Cor Sim Sim

Forma Sim Não

Textura Sim Não

Tamanho Não Sim

Orientação Sim Sim

Tabela 5.2: Disponibilidade de cada tipo de mapeamento para cada variável visual. Para cada uma das variáveis visuais e os seus mapeamentos, é importante saber quais serão as formas possíveis de fornecer esta informação.

5.1.2.1 Cor

Começando pela cor, o mapeamento da cor é opcional, e a razão para ser opcional é que a API Temporal Gisplay faz uso do ColorBrewer para decidir quais as cores indicadas em cada situação.

A cor pode ser mapeada de duas formas diferentes: através de uma variável categórica ou através de uma variável contínua. Para que uma variável categórica possa ser mapeada na cor, os seus valores de mapeamento (mapping) terão de ser dados na forma dearray

de cores, contendo em cada posição destearray o nome da cor ou o valor hexadecimal

da cor. Na listagem 5.10, pode ser visto um exemplo em que as cores são dadas pelo respetivo nome, sendo que os nomes dados terão de estar na lista de nomes aceites pela API Temporal Gisplay. A lista de nomes de cores1aceites pela API Temporal Gisplay é a lista de cores da especificação do HTML e CSS.

1 color: {

2 externalName: " gender ",

3 mapping: [" blue ", " pink "],

4 }

Listagem 5.10: Exemplo de cor mapeada por variável categórica

Se verificarmos nas opções de processamento, para a variável que tem nome externo “gender”, é possível ver que os seus valores possíveis são “M” e "F". Sendo assim, o ma-

peamento (mapping) será atribuído ao respetivo índice dos valores (values). Ou seja,

"M"→“blue” e "F"→“pink”, sendo que o mesmo se verificaria se a cor fosse dada em hexadecimal.

Por outro lado, para que uma variável contínua seja mapeada na cor, os seus valores de mapeamento terão de ser dados na forma hexadecimal. Dar as cores pelo seu nome no caso das variáveis contínuas não faz sentido pois como a variável é contínua, o que altera é a tonalidade da cor. Cada elemento dado no mapeamento da cor (mapping) na listagem

5.11é atribuída à respetiva classe.

1 color: {

2 externalName: " age ",

3 mapping: ["# ece7f2 ", "# a6bddb ", " #2 b8cbe "]

4 }

Listagem 5.11: Exemplo de cor mapeada por variável contínua

5.1.2.2 Forma

Depois da cor, temos a forma, sendo que esta pode ser mapeada por uma variável ca- tegórica. O seu mapeamento, ao contrário da cor, terá de ser dado na forma de mapa chave-valor. Cada chave é um dos valores (values) das opções de processamento e o valor

associado à referida chave é uma forma (triângulo, quadrado, etc) que esteja disponível na API Temporal Gisplay. Um exemplo do fornecimento da forma está na listagem5.12.

1 shape: { 2 externalName: ' gender ', 3 mapping: { 4 "M" : " triangle ", 5 "F" : " square " 6 } 7 }

Listagem 5.12: Exemplo das opções para a forma

As formas atualmente disponíveis na API Temporal Gisplay são: triângulo, quadrado, círculo e cruz. Estas formas estão numa imagem sendo que a forma de funcionamento desta imagem e dos índices respetivos apresentados na secção4.4do capítulo anterior. 5.1.2.3 Textura 1 texture: { 2 externalName: ' gender ', 3 mapping: { 4 "M" : " points ", 5 "F" : " triangles " 6 } 7 }

Listagem 5.13: Exemplo das opções para a textura

A próxima variável visual é a textura, que pode ser mapeada por uma variável categó- rica, e a maneira de fornecimento do seu mapeamento é em tudo idêntica à variável visual anterior, a forma. Para cada categoria da variável categórica é dado o nome do padrão que se pretende usar. Os padrões atualmente disponíveis na API Temporal Gisplay são: pontos, triângulos, vertical e horizontal. Estes padrões estão numa imagem que contém múltiplos padrões sendo a forma de funcionamento desta imagem e dos índices respe- tivos apresentados na secção4.4do capítulo anterior. Um exemplo do fornecimento da textura pode ser visto na listagem5.13.

5.1.2.4 Tamanho

O tamanho, pode ser mapeado através de uma variável contínua. A forma de fornecer as suas opções passa por indicar o tamanho que cada classe desta variável irá possuir.

1 size: {

2 internalName: 'age ',

3 mapping: [5 , 40 , 100]

4 }

Como podemos ver no pedaço de código5.14, no mapeamento existem 3 tamanhos diferentes (5, 40, 100). Ou seja, cada classe da variável contínua terá o tamanho de acordo com este mapeamento. A primeira classe verá os seus elementos serem desenhados com tamanho 5x5 pixeis, a segunda com tamanho 40x40 pixeis e a terceira classe com tamanho 100x100 pixeis.

5.1.2.5 Orientação

Por fim, temos a orientação, sendo que nesta variável visual é possível usar tanto para uma variável categórica como uma variável contínua, e os valores a serem fornecidos dizem respeito aos graus da orientação.

Para uma variável categórica, tal como nas outras variáveis visuais que aceitem variá- veis categóricas, é dado um objeto com chaves e valores, sendo a chave uma das categorias que existem nos dados e o respetivo valor é o número de graus, sendo possível ver um exemplo na listagem5.15 1 orientation: { 2 externalName: ' gender ', 3 mapping: { 4 "M" : 0, 5 "F" : 40 6 } 7 }

Listagem 5.15: Exemplo das opções para a orientação com uma variável categórica Para uma variável contínua, são fornecidos os graus da orientação, que todos os ele- mentos de cada classe irão ter no mapa temático, sendo possível ver um exemplo na listagem5.16.

1 orientation: {

2 internalName: ' Number of deaths ',

3 mapping: [0 , 40 , 80]

4 }

Listagem 5.16: Exemplo das opções para a orientação

Resumindo, para as opções de mapeamento (mappingOptions), o nome externo é obrigatório, pois este permite referenciar qual a variável que estamos a referir nas opções de processamento, o mapeamento da variável (mapping) é obrigatório em todos os casos exceto quando a variável visual for a cor.