间隔

概览

Google 图表可以按数据系列显示间隔。它们可用于描述置信区间、值周围的最小值和最大值、百分位采样,或需要系列周围有不同外边距的任何其他信息。

间隔有六种样式:线条、条形、方框、棒、点和面积。下面列出了每种类型的示例。在每个示例中,我们将使用相同的数据集,如下所示(没有间隔):

上面的图表很简单:包含七个系列的数据,而且所有数据的重要性都相同。在接下来的内容中,我们假设第一个数据系列是主要数据系列,其他六个数据系列通过间隔进行比较。

行间隔

行间隔有时用于描述多个实验的方差。在下面的图表中,我们展示了主要数据系列及其前后的区间。

<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>
 

在上面的数据中,您可以看到我们在补充系列中附加了三个不同的标识符:i0i2i3。我们可以使用这些元素为这些系列设定不同的样式;在下面,我们为它们指定不同的颜色和粗细。

注意:一般情况下,像上文那样重复使用 ID 是一种不好的做法,因为 i2 使用了四次。这可行,但将来我们可能会更改此行为。

唯一的区别在于选项:

    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',
   
};

条形间隔

条形间隔用于围绕数据创建误差条。间隔的第一列和最后一列绘制为与域轴平行的宽条,而内列绘制为较短的“刻度线”。系统会添加一个“棒”来连接宽条(如果这两个条形的值相同,则棒会渲染为一个点,除非 pointSize 选项为零)。

第一列和最后一列对应的水平条的宽度由 intervals.barWidth 控制,与内部列对应的水平条的宽度由 intervals.shortBarWidth 控制。忽略这些信息后,您会看到类似上面所示的图表,其中包含以下选项:

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

方框间隔

方框间隔在数据表中以一组嵌套矩形的形式呈现列:第一列和最后一列构成最外侧的矩形,内列在包含框内渲染为较深的矩形。

指定框间隔的方法如下:

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

您可以使用 intervals.lineWidthintervals.barWidth 选项使框更加显眼:

相关选项:

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

固定间隔

粘滞间隔将列对显示为一组与目标轴平行的粘滞杆。高度为零的棍子渲染为一个点,可通过将 pointSize 选项设为 0 来抑制该点。

您可以使用 'sticks'style 创建这些类:

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

点间隔

点间隔以小圆圈的形式显示间隔数据:

可使用 intervals.pointSize 选项控制点大小。这里是 2:

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

以下是 8 时的内容:

面积间隔

区域间隔会将间隔数据渲染为一组嵌套的阴影区域。列对的嵌套类似于框间隔的嵌套,不同之处在于需要偶数列。

这是通过将 style 设置为 'area' 来实现的:

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

组合间隔样式

如需进一步实现自定义,您可以将区间样式合并到一个图表中。

以下图表结合了面积和条形间隔:

在上图中,我们为标记为 i0i1 的区间指定了 style'bars',为 i2 指定了 'area' 样式。然后,我们使用 pointSize 设置条形上限:

    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',
   
};

下面是一个条形图间隔折线图,其中 i2 间隔表示为柱形:

    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',
   
};

下面是一个间隔折线图,它使用低不透明度框将选定的间隔放在背景中:

    // 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',
   
};

我们可以创建一个“点和胡须”间隔图表,方法是为一个时间间隔指定一个低不透明度 'points' 样式,并指定一个 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',
   
};

箱形图

最后,根据上面的“点和胡须”图表,我们可以使用箱形间隔和柱形间隔创建基本的箱形图。

      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);
   
}