間隔

  1. 概要
  2. 行間隔
  3. バー区間
  4. ボックスの間隔
  5. スティックの間隔
  6. ポイント間隔
  7. エリアの間隔
  8. インターバル スタイルの組み合わせ

概要

Google グラフでは、系列の周囲に間隔を表示できます。これらの値は、信頼区間、特定の値に関する最小値と最大値、パーセンタイル サンプリングなど、一連の指標に対してそれぞれ異なるマージンを必要とする場合に使われます。

間隔には、ライン、バー、ボックス、スティック、ポイント、エリアの 6 種類があります。以下にそれぞれの例を示します。それぞれの例で、同じデータセットを、間隔なしで示しています。

上のグラフは単純です。データの系列が 7 個あり、どれも重要度は同じです。以下では、最初のシリーズがメインのシリーズであり、他の 6 つは期間間で比較されていると仮定します。

行間隔

行間隔は、複数のテストの差異を表すために使用されることがあります。次の図では、プライマリ シリーズとその周囲の間隔を示しています。

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

上記のデータでは、補足シリーズに 3 つの異なる識別子（i0、i2、i3）が付加されていることがわかります。これを使用して、これらのシリーズのスタイルを変更できます。以下では、さまざまな色と厚さを示します。

注: 一般的に、上記のように ID を再利用することは適切ではなく、i2 は 4 回使用されます。現在は機能しますが、今後この動作が変更される可能性があります。

唯一の違いはオプションです。

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

バーの間隔

バー間隔は、データの周囲にエラーバーを作成します。間隔の最初と最後の列はドメイン軸に平行な幅の広いバーとして描画され、内側の列は短い「ティック」として描画されます。「スティック」を追加して幅の広いバーを結合します（この 2 つのバーが同じ値である場合、スティックは 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.lineWidth オプションと intervals.barWidth オプションを使用すると、ボックスをより目立つようにできます。

関連オプション:

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

スティック間隔

スティックの間隔は、ターゲットの軸に平行なスティックのセットとして列のペアを表示します。高さがゼロのスティックは、ポイントとしてレンダリングされます。これは、pointSize オプションをゼロに設定すると抑制できます。

これは、'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',
    };

インターバル スタイルの組み合わせ

さらにカスタマイズする場合は、1 つのグラフ内に間隔スタイルを組み合わせることができます。

下のグラフは、領域の間隔と棒の間隔を組み合わせたものです。

上のグラフでは、i0 と i1 でタグ付けされた間隔に 'bars' の style を指定し、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',
    };

boxWidth とともに 1 つの間隔で不透明度の低い 'points' スタイルを指定することで、「ポイントとひげ」の間隔グラフを作成できます。

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