Intervalos

Visão geral

Os gráficos do Google podem mostrar intervalos em torno de uma série. Eles podem ser usados para retratar intervalos de confiança, valores mínimos e máximos em torno de um valor, amostragem percentual ou qualquer outra coisa que exija uma margem variável em torno de uma série.

Existem seis estilos de intervalo: linha, barra, caixa, stick, ponto e área. Abaixo, você verá exemplos de cada um. Em cada exemplo, usaremos o mesmo conjunto de dados, mostrado sem intervalos:

O gráfico acima é simples: ele tem sete séries de dados, todos iguais em importância. A seguir, vamos presumir que a primeira série é a primária e as outras seis estão sendo comparadas a ela por intervalos.

Intervalos de linha

Às vezes, intervalos de linhas são usados para representar a variação de vários experimentos. No gráfico a seguir, ilustramos uma série primária e intervalos em torno dela.

<html>
 
<head>
   
<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
   
<script type="text/javascript">
      google
.charts.load('current', {'packages':['corechart']});
      google
.charts.setOnLoadCallback(drawChart);

     
function drawChart() {
       
var data = new google.visualization.DataTable();
        data
.addColumn('number', 'x');
        data
.addColumn('number', 'values');
        data
.addColumn({id:'i0', type:'number', role:'interval'});
        data
.addColumn({id:'i1', type:'number', role:'interval'});
        data
.addColumn({id:'i2', type:'number', role:'interval'});
        data
.addColumn({id:'i2', type:'number', role:'interval'});
        data
.addColumn({id:'i2', type:'number', role:'interval'});
        data
.addColumn({id:'i2', type:'number', role:'interval'});
 
        data
.addRows([
           
[1, 100, 90, 110, 85, 96, 104, 120],
           
[2, 120, 95, 130, 90, 113, 124, 140],
           
[3, 130, 105, 140, 100, 117, 133, 139],
           
[4, 90, 85, 95, 85, 88, 92, 95],
           
[5, 70, 74, 63, 67, 69, 70, 72],
           
[6, 30, 39, 22, 21, 28, 34, 40],
           
[7, 80, 77, 83, 70, 77, 85, 90],
           
[8, 100, 90, 110, 85, 95, 102, 110]]);
 
       
// The intervals data as narrow lines (useful for showing raw source data)
       
var options_lines = {
            title
: 'Line intervals, default',
            curveType
: 'function',
            lineWidth
: 4,
            intervals
: { 'style':'line' },
            legend
: 'none'
       
};
 
       
var chart_lines = new google.visualization.LineChart(document.getElementById('chart_lines'));
        chart_lines
.draw(data, options_lines);
     
}
   
</script>
 
</head>
 
<body>
   
<div id="chart_lines" style="width: 900px; height: 500px;"></div>
 
</body>
</html>
 

Nos dados acima, você pode ver que anexamos três identificadores diferentes à série complementar: i0, i2 e i3. Podemos usá-los para estilizar essas séries de maneira diferente. Abaixo, vamos fornecer cores e espessuras diferentes.

Observação:em geral, não é recomendável reutilizar IDs como fizemos acima, com i2 sendo usado quatro vezes. Isso funciona, mas podemos mudar esse comportamento no futuro.

A única diferença está nas opções:

    var options_lines = {
        title
: 'Line intervals, tailored',
        lineWidth
: 4,
        curveType
:'function',
       
interval: {
           
'i0': { 'style':'line', 'color':'#D3362D', 'lineWidth': 0.5 },
           
'i1': { 'style':'line', 'color':'#F1CA3A', 'lineWidth': 1 },
           
'i2': { 'style':'line', 'color':'#5F9654', 'lineWidth': 2 },
       
},

        legend
: 'none',
   
};

Intervalos de barra

Intervalos de barras criam barras de erros nos dados. A primeira e a última colunas do intervalo são desenhadas como barras largas paralelas ao eixo do domínio, e as colunas internas como "marcas" mais curtas. Um "stick" é adicionado para unir as barras largas. Se essas duas barras tiverem o mesmo valor, ele será renderizado como um ponto, a menos que a opção pointSize seja zero.

A largura das barras horizontais correspondentes à primeira e última colunas é controlada com intervals.barWidth, e a largura das barras horizontais correspondentes às colunas internas é controlada com intervals.shortBarWidth. Quando elas são omitidas, você recebe um gráfico como o acima com as opções abaixo:

    var options_bars = {
        title
: 'Bars, default',
        curveType
: 'function',
        series
: [{'color': '#D9544C'}],
        intervals
: { style: 'bars' },
        legend
: 'none',
   
};

Intervalos de caixa

Intervalos de caixa renderizadas as colunas na tabela de dados como um conjunto de retângulos aninhados: a primeira e a última colunas formam o retângulo mais externo, e as colunas internas são renderizadas como retângulos mais escuros dentro da caixa que os contém.

Confira como especificar intervalos de caixa:

    var options = {
        series
: [{'color': '#1A8763'}],
       
intervals: { style: 'boxes' },
        legend
: 'none',
   
};

É possível destacar mais as caixas com as opções intervals.lineWidth e intervals.barWidth:

As opções relevantes:

    var options = {
        title
:'Boxes, thick',
        curveType
:'function',
        lineWidth
: 4,
        series
: [{'color': '#1A8763'}],
       
intervals: { 'lineWidth':2, 'barWidth': 0.5, style: 'boxes' },
        legend
: 'none',
   
};

Intervalos de stick

Os intervalos de pontos mostram pares de colunas como um conjunto de faixas paralelas ao eixo de destino. Um conjunto de altura zero é renderizado como um ponto, que pode ser suprimido definindo a opção pointSize como zero.

É possível criá-las com um style de 'sticks':

    var options_sticks = {
        title
:'Sticks, default',
        curveType
:'function',
        series
: [{'color': '#E7711B'}],
       
intervals: { style: 'sticks' },
        legend
: 'none',
   
};

Intervalos de pontos

Intervalos de pontos mostram dados de intervalo como círculos pequenos:

O tamanho do ponto pode ser controlado com a opção intervals.pointSize. Aqui, é o número 2:

    var options_points = {
        title
:'Points, default',
        curveType
:'function',
        lineWidth
: 4,
        series
: [{'color': '#D3362D'}],
       
intervals: { 'style':'points', pointSize: 2 },
        legend
: 'none',
   
};

Veja como fica no 8:

Intervalos de área

Um intervalo de área renderiza dados de intervalo como um conjunto de áreas sombreadas aninhadas. O aninhamento de pares de colunas é semelhante ao de intervalos de caixas, exceto pelo fato de que um número par de colunas é necessário.

Isso é feito ao definir style como 'area':

    var options = {
        title
:'Area, default',
        curveType
:'function',
        series
: [{'color': '#F1CA3A'}],
       
intervals: { 'style':'area' },
        legend
: 'none',
   
};

Combinar estilos de intervalo

Para uma personalização ainda maior, combine estilos de intervalos em um gráfico.

Veja um gráfico que combina intervalos de área e barra:

No gráfico acima, especificamos um style de 'bars' para intervalos marcados com i0 e i1 e um estilo 'area' para i2. Em seguida, usamos pointSize para limitar as barras:

    var options = {
        title
:'Bar/area interval chart',
        curveType
:'function',
        intervals
: { 'color':'series-color' },
       
interval: {
           
'i0': { 'color': '#4374E0', 'style':'bars', 'barWidth':0, 'lineWidth':4, 'pointSize':10, 'fillOpacity':1 },
           
'i1': { 'color': '#E49307', 'style':'bars', 'barWidth':0, 'lineWidth':4, 'pointSize':10, 'fillOpacity':1 },
           
'i2': { 'style':'area', 'curveType':'function', 'fillOpacity':0.3 }},

        legend
: 'none',
   
};

Confira um gráfico de linhas de intervalo de barras com os intervalos i2 representados como faixas:

    var options = {
        title
:'Sticks, horizontal',
        curveType
:'function',
        lineWidth
: 4,
        series
: [{'color': '#E7711B'}],
        intervals
: { 'lineWidth': 4, 'barWidth': 0.5 },
        interval
: {
           
'i2': { 'style':'sticks', 'color':'grey', 'boxWidth': 2.5,
           
'lineWidth': 1 }
       
},
        legend
: 'none',
   
};

Confira um gráfico de linhas de intervalo que usa caixas de baixa opacidade para colocar intervalos selecionados em segundo plano:

    // Focus is the error bars, but boxes are visible in the background.
   
var options_boxes_background = {
        title
:'Background boxes',
        curveType
:'function',
        lineWidth
: 4,
        series
: [{'color': '#1A8763'}],
       
intervals: { 'lineWidth':2, 'barWidth': 0.5 },
        interval
: {
           
'i2': { 'style':'boxes', 'color':'grey', 'boxWidth': 2.5,
           
'lineWidth': 0, 'fillOpacity': 0.2 }
       
},

        legend
: 'none',
   
};

Podemos criar um gráfico de intervalo de "pontos e bigodes" especificando um estilo 'points' de baixa opacidade para um intervalo com um boxWidth:

    var options = {
        title
:'Points and whiskers',
        curveType
:'function',
        lineWidth
: 4,
        series
: [{'color': '#D3362D'}],
       
intervals: { 'lineWidth':2, 'barWidth': 0.5 },
        interval
: {
           
'i2': { 'style':'points', 'color':'grey', 'pointSize': 10,
           
'lineWidth': 0, 'fillOpacity': 0.3 }
       
},

        legend
: 'none',
   
};

Diagrama

Por fim, com base no gráfico de pontos e bigodes acima, podemos usar intervalos de caixa e barra para criar um gráfico de caixa básico.

      var options = {
          title
:'Box Plot',
          height
: 500,
          legend
: {position: 'none'},
          hAxis
: {
            gridlines
: {color: '#fff'}
         
},
          lineWidth
: 0,
          series
: [{'color': '#D3362D'}],
          intervals
: {
            barWidth
: 1,
            boxWidth
: 1,
            lineWidth
: 2,
            style
: 'boxes'
         
},
          interval
: {
            max
: {
              style
: 'bars',
              fillOpacity
: 1,
              color
: '#777'
           
},
            min
: {
              style
: 'bars',
              fillOpacity
: 1,
              color
: '#777'
           
}
         
}
     
};
   
    google.charts.load('current', {'packages':['corechart']});
    google
.charts.setOnLoadCallback(drawBoxPlot);

   
function drawBoxPlot() {

     
var array = [
       
['a', 100, 90, 110, 85, 96, 104, 120],
       
['b', 120, 95, 130, 90, 113, 124, 140],
       
['c', 130, 105, 140, 100, 117, 133, 139],
       
['d', 90, 85, 95, 85, 88, 92, 95],
       
['e', 70, 74, 63, 67, 69, 70, 72],
       
['f', 30, 39, 22, 21, 28, 34, 40],
       
['g', 80, 77, 83, 70, 77, 85, 90],
       
['h', 100, 90, 110, 85, 95, 102, 110]
     
];

     
var data = new google.visualization.DataTable();
      data
.addColumn('string', 'x');
      data
.addColumn('number', 'series0');
      data
.addColumn('number', 'series1');
      data
.addColumn('number', 'series2');
      data
.addColumn('number', 'series3');
      data
.addColumn('number', 'series4');
      data
.addColumn('number', 'series5');
      data
.addColumn('number', 'series6');

      data
.addColumn({id:'max', type:'number', role:'interval'});
      data
.addColumn({id:'min', type:'number', role:'interval'});
      data
.addColumn({id:'firstQuartile', type:'number', role:'interval'});
      data
.addColumn({id:'median', type:'number', role:'interval'});
      data
.addColumn({id:'thirdQuartile', type:'number', role:'interval'});

      data
.addRows(getBoxPlotValues(array));

     
/**
       * Takes an array of input data and returns an
       * array of the input data with the box plot
       * interval data appended to each row.
       */

     
function getBoxPlotValues(array) {

       
for (var i = 0; i < array.length; i++) {

         
var arr = array[i].slice(1).sort(function (a, b) {
           
return a - b;
         
});

         
var max = arr[arr.length - 1];
         
var min = arr[0];
         
var median = getMedian(arr);

         
// First Quartile is the median from lowest to overall median.
         
var firstQuartile = getMedian(arr.slice(0, 4));

         
// Third Quartile is the median from the overall median to the highest.
         
var thirdQuartile = getMedian(arr.slice(3));

          array
[i][8] = max;
          array
[i][9] = min
          array
[i][10] = firstQuartile;
          array
[i][11] = median;
          array
[i][12] = thirdQuartile;
       
}
       
return array;
     
}

     
/*
       * Takes an array and returns
       * the median value.
       */

     
function getMedian(array) {
       
var length = array.length;

       
/* If the array is an even length the
         * median is the average of the two
         * middle-most values. Otherwise the
         * median is the middle-most value.
         */

       
if (length % 2 === 0) {
         
var midUpper = length / 2;
         
var midLower = midUpper - 1;

         
return (array[midUpper] + array[midLower]) / 2;
       
} else {
         
return array[Math.floor(length / 2)];
       
}
     
}

     
var options = {
          title
:'Box Plot',
          height
: 500,
          legend
: {position: 'none'},
          hAxis
: {
            gridlines
: {color: '#fff'}
         
},
          lineWidth
: 0,
          series
: [{'color': '#D3362D'}],
          intervals
: {
            barWidth
: 1,
            boxWidth
: 1,
            lineWidth
: 2,
            style
: 'boxes'
         
},
          interval
: {
            max
: {
              style
: 'bars',
              fillOpacity
: 1,
              color
: '#777'
           
},
            min
: {
              style
: 'bars',
              fillOpacity
: 1,
              color
: '#777'
           
}
         
}
     
};

     
var chart = new google.visualization.LineChart(document.getElementById('box_plot'));

      chart
.draw(data, options);
   
}