D3.js: scala API

D3.js fornisce funzioni di scala per eseguire trasformazioni di dati. Queste funzioni associano un dominio di input a un intervallo di output.

Configurazione dell'API

Possiamo configurare l'API direttamente utilizzando il seguente script.

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

Metodi API di scala

D3 fornisce i seguenti importanti metodi di ridimensionamento per diversi tipi di grafici. Cerchiamo quindi di capire in dettaglio.

  • d3.scaleLinear() - Costruisce una scala lineare continua in cui possiamo inserire mappe di dati (dominio) nell'intervallo di output specificato.

  • d3.scaleIdentity() - Costruisci una scala lineare in cui i dati di input sono gli stessi dell'output.

  • d3.scaleTime() - Costruisci una scala lineare in cui i dati di input sono nelle date e l'output in numeri.

  • d3.scaleLog() - Costruisci una scala logaritmica.

  • d3.scaleSqrt() - Costruisci una scala di radice quadrata.

  • d3.scalePow() - Costruisci una scala esponenziale.

  • d3.scaleSequential() - Costruire una scala sequenziale in cui l'intervallo di output è fissato dalla funzione di interpolatore.

  • d3.scaleQuantize() - Costruisci una scala di quantizzazione con un intervallo di uscita discreto.

  • d3.scaleQuantile() - Costruire una scala quantile in cui i dati del campione di input si mappano all'intervallo di output discreto.

  • d3.scaleThreshold() - Costruire una scala in cui i dati di input arbitrari vengono mappati all'intervallo di output discreto.

  • d3.scaleBand() - Le scale di banda sono come le scale ordinali tranne per il fatto che l'intervallo di output è continuo e numerico.

  • d3.scalePoint() - Costruisci una scala a punti.

  • d3.scaleOrdinal() - Costruire una scala ordinale in cui i dati di input includano alfabeti e sono mappati all'intervallo di output numerico discreto.

Prima di fare un esempio funzionante, dobbiamo prima comprendere i seguenti due termini:

  • Domain - Il dominio indica i valori minimo e massimo dei dati di input.

  • Range - L'intervallo è l'intervallo di output, a cui vorremmo mappare i valori di input ...

Esempio di lavoro

Eseguiamo la funzione d3.scaleLinear in questo esempio. Per fare ciò, è necessario attenersi ai seguenti passaggi:

Step 1 - Define variables - Definisci variabili e dati SVG utilizzando la codifica seguente.

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

Step 2 - Create linear scale - Usa il codice seguente per creare una scala lineare.

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

Qui, per il valore minimo e massimo per il nostro dominio manualmente, possiamo usare il built-in d3.min() e d3.max() funzioni, che restituiranno rispettivamente i valori minimo e massimo dal nostro array di dati.

Step 3 - Append SVG attributes - Aggiungi gli elementi SVG utilizzando il codice fornito di seguito.

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

Step 4 - Apply transformation - Applicare la trasformazione utilizzando il codice sottostante.

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 - Aggiungi gli elementi rect al ridimensionamento come mostrato di seguito.

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

Step 6 - Display data - Ora visualizza i dati utilizzando la codifica fornita di seguito.

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 - Ora, creiamo un grafico a barre usando la funzione d3.scaleLinear () come segue.

Crea una pagina web "scales.html" e aggiungi le seguenti modifiche.

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

Il codice sopra mostrerà il seguente risultato nel browser.