D3.js - API Escalas

D3.js fornece funções de escala para realizar transformações de dados. Essas funções mapeiam um domínio de entrada para um intervalo de saída.

Configurando API

Podemos configurar a API diretamente usando o seguinte 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>

Métodos de API de escalas

D3 fornece os seguintes métodos de escala importantes para diferentes tipos de gráficos. Vamos entender então em detalhes.

d3.scaleLinear() - Constrói uma escala linear contínua onde podemos inserir mapas de dados (domínio) para o intervalo de saída especificado.
d3.scaleIdentity() - Construa uma escala linear onde os dados de entrada são iguais aos de saída.
d3.scaleTime() - Construa uma escala linear onde os dados de entrada estão nas datas e a saída em números.
d3.scaleLog() - Construa uma escala logarítmica.
d3.scaleSqrt() - Construa uma escala de raiz quadrada.
d3.scalePow() - Construa uma escala exponencial.
d3.scaleSequential() - Construa uma escala sequencial onde a faixa de saída é fixada pela função de interpolador.
d3.scaleQuantize() - Construa uma escala de quantização com faixa de saída discreta.
d3.scaleQuantile() - Construa uma escala de quantil onde os dados de amostra de entrada sejam mapeados para a faixa de saída discreta.
d3.scaleThreshold() - Construa uma escala onde os dados de entrada arbitrários sejam mapeados para a faixa de saída discreta.
d3.scaleBand() - As escalas de banda são como escalas ordinais, exceto que a faixa de saída é contínua e numérica.
d3.scalePoint() - Construa uma escala de pontos.
d3.scaleOrdinal() - Construa uma escala ordinal em que os dados de entrada incluam alfabetos e sejam mapeados para a faixa de saída numérica discreta.

Antes de fazer um exemplo prático, vamos primeiro entender os dois termos a seguir -

Domain - O domínio denota os valores mínimo e máximo de seus dados de entrada.
Range - O intervalo é o intervalo de saída, para o qual gostaríamos que os valores de entrada mapeassem ...

Exemplo de Trabalho

Vamos executar a função d3.scaleLinear neste exemplo. Para fazer isso, você precisa seguir as seguintes etapas -

Step 1 - Define variables - Defina variáveis e dados SVG usando a codificação abaixo.

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

Step 2 - Create linear scale - Use o seguinte código para criar uma escala linear.

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

Aqui, para o valor mínimo e máximo de nosso domínio manualmente, podemos usar o integrado d3.min() e d3.max() funções, que retornarão os valores mínimo e máximo, respectivamente, de nossa matriz de dados.

Step 3 - Append SVG attributes - Anexe os elementos SVG usando o código fornecido a seguir.

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

Step 4 - Apply transformation - Aplique a transformação usando o código abaixo.

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 - Anexe os elementos retos à escala, conforme mostrado abaixo.

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

Step 6 - Display data - Agora exiba os dados usando a codificação fornecida abaixo.

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 - Agora, vamos criar um gráfico de barras usando a função d3.scaleLinear () da seguinte maneira.

Crie uma página da web “escalas.html” e adicione as seguintes alterações a ela.

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

O código acima exibirá o seguinte resultado no navegador.