D3.js - Ölçeklendirme API'si

D3.js, veri dönüşümlerini gerçekleştirmek için ölçekleme işlevleri sağlar. Bu işlevler, bir giriş alanını bir çıkış aralığına eşler.

API'yi Yapılandırma

API'yi doğrudan aşağıdaki komut dosyasını kullanarak yapılandırabiliriz.

<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 Yöntemlerini Ölçekler

D3, farklı grafik türleri için aşağıdaki önemli ölçeklendirme yöntemlerini sağlar. O halde ayrıntılı olarak anlayalım.

  • d3.scaleLinear() - Belirtilen çıktı aralığına veri (alan) haritalarını girebileceğimiz sürekli bir doğrusal ölçek oluşturur.

  • d3.scaleIdentity() - Giriş verilerinin çıktıyla aynı olduğu doğrusal bir ölçek oluşturun.

  • d3.scaleTime() - Giriş verilerinin tarihlerde ve çıktının sayılarda olduğu doğrusal bir ölçek oluşturun.

  • d3.scaleLog() - Logaritmik bir ölçek oluşturun.

  • d3.scaleSqrt() - Bir karekök ölçeği oluşturun.

  • d3.scalePow() - Üstel bir ölçek oluşturun.

  • d3.scaleSequential() - Çıkış aralığının enterpolatör işlevi ile sabitlendiği sıralı bir ölçek oluşturun.

  • d3.scaleQuantize() - Ayrık çıktı aralığı ile niceleme ölçeği oluşturun.

  • d3.scaleQuantile() - Giriş örnek verilerinin ayrık çıkış aralığı ile eşleştiği bir nicelik ölçeği oluşturun.

  • d3.scaleThreshold() - Rasgele giriş verilerinin ayrık çıkış aralığı ile eşleştiği bir ölçek oluşturun.

  • d3.scaleBand() - Bant ölçekleri, çıkış aralığının sürekli ve sayısal olması dışında sıra ölçekleri gibidir.

  • d3.scalePoint() - Bir puan ölçeği oluşturun.

  • d3.scaleOrdinal() - Giriş verilerinin alfabe içerdiği ve ayrık sayısal çıktı aralığına eşlendiği bir sıra ölçeği oluşturun.

Çalışan bir örnek yapmadan önce, önce aşağıdaki iki terimi anlayalım -

  • Domain - Etki Alanı, giriş verilerinizin minimum ve maksimum değerlerini belirtir.

  • Range - Aralık, giriş değerlerinin eşlenmesini istediğimiz çıkış aralığıdır ...

Çalışma Örneği

Bu örnekte d3.scaleLinear işlevini gerçekleştirelim. Bunu yapmak için aşağıdaki adımlara uymanız gerekir -

Step 1 - Define variables - Aşağıdaki kodlamayı kullanarak SVG değişkenlerini ve verilerini tanımlayın.

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

Step 2 - Create linear scale - Doğrusal bir ölçek oluşturmak için aşağıdaki kodu kullanın.

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

Burada, alan adımızın minimum ve maksimum değeri için manuel olarak yerleşik olarak kullanabiliriz. d3.min() ve d3.max() veri dizimizden sırasıyla minimum ve maksimum değerleri döndürecek işlevler.

Step 3 - Append SVG attributes - Aşağıda verilen kodu kullanarak SVG öğelerini ekleyin.

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

Step 4 - Apply transformation - Aşağıdaki kodu kullanarak dönüşümü uygulayın.

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

Step 5 - Append rect elements - Aşağıda gösterildiği gibi ölçeklendirmeye dikdörtgen öğeleri ekleyin.

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

Step 6 - Display data - Şimdi aşağıda verilen kodlamayı kullanarak verileri görüntüleyin.

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

Step 7 - Working Example - Şimdi, aşağıdaki gibi d3.scaleLinear () işlevini kullanarak bir çubuk grafik oluşturalım.

Bir "scales.html" web sayfası oluşturun ve aşağıdaki değişiklikleri buna ekleyin.

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

Yukarıdaki kod, tarayıcıda aşağıdaki sonucu gösterecektir.