Gráfico de barras

Gráfico de barras

Início Anterior Próximo

Gráfico de barras

O nome do conector responsável pela geração de gráficos de barra é br.com.itx.modules.chart.BarChart. O gráfico de barras gerado por esse conector assume que o objeto que servirá como dataset contém a informaçõa de uma ou mais categorias sendo que cada uma dessas categorias pode possuir uma ou mais séries de dados.

O conector BarChart assume que o objeto que ele usará para popular o gráfico esteja com as informações das categorias dispostas ou em linha ou em coluna.

Quando a disposição dos dados das categorias estão em linha (ver exemplo abaixo) o conector BarChart faz o seguinte procedimento: os valores da primeira coluna serão usados como rótulos das categorias e os nomes das colunas a partir da segunda coluna serão usados como rótulos para a legenda das séries. Perceba que nesse caso os dados para cada uma das categorias estão na linha do nome da categoria.

Por exemplo, o gráfico em barras abaixo foi gerado a partir de um objeto onde as categorias estão sendo representadas pelos municípios Abaré, Abaíra, Acajutiba, Adustina, Aiquara, Alagoinhas e Alcobaça e para cada um desses municípios (categorias) há uma série de dados indicada pelos rótulos "Área plantada" e "Área colhida".

O objeto usado para gerar o gráfico acima possui a estrutura exibida abaixo. Perceba que os dados das séries para cada uma das categorias (municípios) estão dispostos em linha e os nomes das colunas foram usados como legenda.

Então um objeto a ser usado como dataset para geração de gráfico de barra com disposição dos dados das categorias em linha deve ter o seguinte padrão:

1. Os valores da primeira coluna do objeto contêm os nomes dos rótulos para as categorias.

2. Os nomes das colunas a partir da segunda coluna do objeto indicam os nomes dos rótulos das séries das categorias. É com base nesses nomes que será gerada a legenda para o gráfico.

3. Os valores das séries para cada uma das categorias deverão estar dispostos numa única linha.

Quando a disposição dos dados das categorias estão em coluna (ver exemplo abaixo) o conector BarChart faz o seguinte procedimento: os valores da primeira coluna serão usados como rótulos das categorias, os valores da segunda coluna serão usados como rótulos das séries e os valores da terceira coluna serão usados como os dados correspondente ao par (categoria, série) formado pelo valor das duas colunas anteriores.

Por exemplo, o gráfico de barra abaixo foi gerado a partir de um objeto onde as categorias estão sendo representadas pelos municípios listados na primeira coluna e para cada um desses municípios (categorias) há uma série de dados indicada pelos anos onde se calcula a área colhida.

O objeto usado para gerar o gráfico acima possui a estrutura exibida abaixo. Perceba que os dados das séries para cada uma das categorias (municípios) estão dispostos nas colunas.

Então um objeto a ser usado como dataset para geração de gráfico de barra com disposição dos dados das categorias em coluna deve ter o seguinte padrão:

1. Os valores da primeira coluna do objeto contêm os nomes dos rótulos para as categorias.

2. Os valores da segunda coluna do obejto contêm os nomes dos rótulos para as séries.

3. Os valores da terceira coluna do objeto contêm os valores dos dados correspondente ao par (categoria, série) formado pelas coluna anteriores.

O conector BarChart assume como padrão que os dados das categorias estão dispostos em linha no objeto, mas esse valor pode ser alterado setando a propriedade tmp.chart.bar.categoryDatasetDisposition através do campo Disposição dos dados das categorias no objeto.

Além das propriedades comuns a todos os gráficos, os gráficos em barra possuem algumas outras propriedades adicionais.

Posição das barras: indica a posição na qual serão geradas as barras. Os valores possíveis são vertical e horizontal, sendo vertical o valor default.

Empilhar barras: indica se as barras que compõem uma categoria serão empilhadas em uma única barra. Os valores possíveis são true e false, sendo false o valor default.

Rótulo do eixo X: indica o nome do rótulo que será dado ao eixo X.

Rótulo do eixo Y: indica o nome do rótulo que será dado ao eixo Y.

Disposição dos dados das categorias no objeto: indica como estão dispostos os dados de cada uma das categorias dentro do objeto. Os valores possíveis são: line, indicando que os dados das categorias estão dispostos em linha no objeto; e column, indicando que os dados das categorias estão dispostos em coluna no obejto. O valor default é line.