D3.js-Scales API

D3.jsは、データ変換を実行するためのスケール関数を提供します。これらの関数は、入力ドメインを出力範囲にマップします。

APIの構成

次のスクリプトを使用して、APIを直接構成できます。

<script src = "https://d3js.org/d3-array.v1.min.js"></script>
<script src = "https://d3js.org/d3-collection.v1.min.js"></script>
<script src = "https://d3js.org/d3-color.v1.min.js"></script>
<script src = "https://d3js.org/d3-format.v1.min.js"></script>
<script src = "https://d3js.org/d3-interpolate.v1.min.js"></script>
<script src = "https://d3js.org/d3-time.v1.min.js"></script>
<script src = "https://d3js.org/d3-time-format.v2.min.js"></script>
<script src = "https://d3js.org/d3-scale.v1.min.js"></script>
<script>

</script>

スケールAPIメソッド

D3は、さまざまなタイプのチャートに次の重要なスケーリング方法を提供します。その後、詳細に理解しましょう。

* d3.scaleLinear（）*-指定された出力範囲にデータ（ドメイン）マップを入力できる連続線形スケールを作成します。
* d3.scaleIdentity（）*-入力データが出力と同じである線形スケールを構築します。
* d3.scaleTime（）*-入力データが日付であり、出力が数値である線形スケールを構築します。
* d3.scaleLog（）*-対数目盛を作成します。
* d3.scaleSqrt（）*-平方根スケールを構築します。
* d3.scalePow（）*-指数スケールを構築します。
* d3.scaleSequential（）*-出力範囲が補間関数によって固定されている順次スケールを構築します。
* d3.scaleQuantize（）*-離散出力範囲で量子化スケールを構築します。
* d3.scaleQuantile（）*-入力サンプルデータが離散出力範囲にマッピングされる分位スケールを構築します。
* d3.scaleThreshold（）*-任意の入力データが離散出力範囲にマッピングされるスケールを構築します。
* d3.scaleBand（）*-バンドスケールは、出力範囲が連続的かつ数値であることを除いて、順序スケールに似ています。
* d3.scalePoint（）*-点スケールを作成します。
* d3.scaleOrdinal（）*-入力データにアルファベットが含まれ、離散数値出力範囲にマップされる順序スケールを作成します。

作業例を行う前に、まず次の2つの用語を理解しましょう-

ドメイン-ドメインは、入力データの最小値と最大値を示します。
範囲-範囲は出力範囲であり、入力値をマッピングしたい…

実施例

この例でd3.scaleLinear関数を実行してみましょう。これを行うには、次の手順に従う必要があります-

ステップ1 *-*変数の定義-以下のコーディングを使用してSVG変数とデータを定義します。

var data = [100, 200, 300, 400, 800, 0]
   var width = 500,
      barHeight = 20,
      margin = 1;

ステップ2 *-*線形スケールの作成-次のコードを使用して線形スケールを作成します。

var scale = d3.scaleLinear()
   .domain([d3.min(data), d3.max(data)])
   .range([100, 400]);

ここで、ドメインの最小値と最大値を手動で使用するには、組み込みの* d3.min（）および d3.max（）*関数を使用できます。これらの関数は、データ配列からそれぞれ最小値と最大値を返します。

ステップ3 *- SVG属性の追加*-以下のコードを使用してSVG要素を追加します。

var svg = d3.select("body")
   .append("svg")
   .attr("width", width)
   .attr("height", barHeight * data.length);

ステップ4 *-*変換の適用-以下のコードを使用して変換を適用します。

var g = svg.selectAll("g")
   .data(data).enter().append("g")
   .attr("transform", function (d, i) {
      return "translate(0," + i * barHeight + ")";
});

ステップ5 *- rect要素の追加*-下に示すように、rect要素をスケーリングに追加します。

g.append("rect")
   .attr("width", function (d) {
      return scale(d);
   })
   .attr("height", barHeight - margin)

ステップ6 *-*データの表示-次に、以下のコーディングを使用してデータを表示します。

g.append("text")
   .attr("x", function (d) { return (scale(d)); })
   .attr("y", barHeight/2)
   .attr("dy", ".35em")
   .text(function (d) { return d; });

ステップ7 *-*作業例-次に、次のようにd3.scaleLinear（）関数を使用して棒グラフを作成します。

ウェブページ「scalesl」を作成し、以下の変更を加えます。

<!DOCTYPE html>
<html>
   <head>
      <script type = "text/javascript" src = "https://d3js.org/d3.v4.min.js"></script>
   </head>

   <body>
      <script>
         var data = [100, 200, 300, 350, 400, 250]
         var width = 500, barHeight = 20, margin = 1;

         var scale = d3.scaleLinear()
            .domain([d3.min(data), d3.max(data)])
            .range([100, 400]);

         var svg = d3.select("body")
            .append("svg")
            .attr("width", width)
            .attr("height", barHeight *data.length);

         var g = svg.selectAll("g")
            .data(data)
            .enter()
            .append("g")
            .attr("transform", function (d, i) {
               return "translate(0," + i* barHeight + ")";
         });

         g.append("rect")
         .attr("width", function (d) {
            return scale(d);
         })

         .attr("height", barHeight - margin)
         g.append("text")
         .attr("x", function (d) { return (scale(d)); })
         .attr("y", barHeight/2).attr("dy", ".35em")
         .text(function (d) { return d; });
      </script>
   </body>
</html>

上記のコードは、ブラウザに次の結果を表示します。

D3js-scales-api

目次

D3.js-Scales API

APIの構成

スケールAPIメソッド

実施例