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.