D3.js - 数组 API

D3 包含模块的集合。您可以单独使用每个模块或一起使用模块集合来执行操作。本章详细介绍了 Array API。

什么是数组？

数组包含相同类型元素的固定大小的顺序集合。数组用于存储数据的集合，但将数组视为相同类型的变量的集合通常更有用。

配置API

您可以使用下面的脚本轻松配置 API。

<script src = "https://d3js.org/d3-array.v1.min.js"></script>
<body>
   <script>
   </script>
</body>

数组统计 API 方法

以下是一些最重要的数组统计 API 方法。

  • d3.min(数组)
  • d3.max(数组)
  • d3.范围（数组）
  • d3.sum(数组)
  • d3.mean(数组)
  • d3.分位数（数组）
  • d3.方差（数组）
  • d3.偏差（数组）

让我们详细讨论其中的每一个。

d3.min(数组)

它使用自然顺序返回给定数组中的最小值。

示例- 考虑以下脚本。

<script>
   var data = [20,40,60,80,100];
   console.log(d3.min(data));
</script>

结果- 上面的脚本返回控制台中数组 20 中的最小值。

d3.max(数组)

它返回给定数组中的最大值。

示例- 考虑以下脚本。

<script>
   var data = [20,40,60,80,100];
   console.log(d3.max(data));
</script>

结果- 上面的脚本返回控制台中数组 (100) 中的最大值。

d3.范围（数组）

它返回给定数组中的最小值和最大值。

示例- 考虑以下脚本。

<script>
   var data = [20,40,60,80,100];
   console.log(d3.extent(data));
</script>

结果- 上面的脚本返回范围值 [20,100]。

d3.sum(数组)

它返回给定数字数组的总和。如果数组为空，则返回 0。

示例- 考虑以下内容。

<script>
   var data = [20,40,60,80,100];
   console.log(d3.sum(data));
</script>

结果- 上面的脚本返回总和值为 300。

d3.mean(数组)

它返回给定数字数组的平均值。

示例- 考虑以下内容。

<script>
   var data = [20,40,60,80,100];
   console.log(d3.mean(data));
</script>

结果- 上面的脚本返回平均值为 60。同样，您可以检查中值。

d3.分位数（数组）

它返回给定排序数字数组的 p 分位数，其中 p 是 [0, 1] 范围内的数字。例如，可以使用 p = 0.5、p = 0.25 处的第一个四分位数和 p = 0.75 处的第三四分位数来计算中位数。此实现使用 R-7 方法、默认 R 编程语言和 Excel。

示例- 考虑以下示例。

var data = [20, 40, 60, 80, 100];
d3.quantile(data, 0); // output is 20
d3.quantile(data, 0.5); // output is 60
d3.quantile(data, 1); // output is 100

同样，您可以检查其他值。

d3.方差（数组）

它返回给定数字数组的方差。

示例- 考虑以下脚本。

<script>
   var data = [20,40,60,80,100];
   console.log(d3.variance(data));
</script>

结果- 上面的脚本返回方差值为 1000。

d3.偏差（数组）

它返回给定数组的标准差。如果数组的值少于两个，则返回未定义。

示例- 考虑以下内容。

<script>
   var data = [20,40,60,80,100];
   console.log(d3.deviation(data));
</script>

结果- 上述脚本返回偏差值 31.622776601683793。

示例- 让我们使用以下脚本执行上面讨论的所有数组 API 方法。创建一个网页“array.html”并向其添加以下更改。

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

   <body>
      <h3>D3 array API</h3>
      <script>
         var data = [20,40,60,80,100];
         console.log(d3.min(data));  
         console.log(d3.max(data));
         console.log(d3.extent(data));
         console.log(d3.sum(data));
         console.log(d3.mean(data));
         console.log(d3.quantile(data,0.5));
         console.log(d3.variance(data));
         console.log(d3.deviation(data));
      </script>
   </body>
</html>

现在，请求浏览器，我们将看到以下响应。

大批

数组搜索 API 方法

以下是几个重要的数组搜索 API 方法。

  • d3.扫描（数组）
  • d3.升序（a，b）

让我们详细了解这两者。

d3.扫描（数组）

该方法用于对指定数组进行线性扫描。它将最小元素的索引返回给指定的比较器。下面定义了一个简单的示例。

示例-

var array = [{one: 1}, {one: 10}];
console.log(d3.scan(array, function(a, b) { return a.one - b.one; })); // output is 0
console.log(d3.scan(array, function(a, b) { return b.one - a.one; })); // output is 1

d3.升序（a，b）

该方法用于执行比较器功能。它可以实现为 -

function ascending(a, b) {
   return a < b ? -1 : a > b ? 1 : a > =  b ? 0 : NaN;
}

如果没有为内置排序方法指定比较器函数，则默认顺序为字母顺序。如果a小于b，上面的函数返回-1；如果a大于b，则返回1；如果a大于b，则返回0。

类似地，您可以执行递减（a，b）方法。如果 a 大于 b，则返回 -1；如果 a 小于 b，则返回 1；如果 a 小于 b，则返回 1；如果 a 小于 b，则返回 0。此函数执行逆自然顺序。

示例-

创建网页array_search.html并向其添加以下更改。

现场演示 
<html>
   <head>
      <script type = "text/javascript" src = "https://d3js.org/d3.v4.min.js"></script>
   </head>

   <body>
      <h3>D3 array API</h3>
      <script>
         var array = [{one: 1}, {one: 10}];
         console.log(d3.scan(array, function(a, b) { return a.one - b.one; })); // 0
         console.log(d3.scan(array, function(a, b) { return b.one - a.one; })); // 1
      </script>
   </body>
</html>

现在，请求浏览器，我们将看到以下结果。

数组转换 API

以下是一些最著名的数组转换 API 方法。

  • d3.cross(a, b[, 减速器])
  • d3.merge(数组)
  • d3.pairs(数组[, 减速器])
  • d3.permute(数组，索引)
  • d3.zip（数组）

让我们详细了解其中的每一个。

d3.cross(a, b[, 减速器])

此方法用于返回给定两个数组 a 和 b 的笛卡尔积。下面定义了一个简单的例子。

d3.cross([10, 20], ["a", "b"]); // output is [[10, "a"], [10, "b"], [20, "a"], [20, "b"]]

d3.merge(数组)

该方法用于合并数组，其定义如下。

d3.merge([[10], [20]]); // output is [10, 20]

d3.pairs(数组[, 减速器])

该方法用于对数组元素进行配对，定义如下。

d3.pairs([10, 20, 30, 40]); // output is [[10, 20], [20, 30], [30, 40]]

d3.permute(数组，索引)

该方法用于根据指定的数组和索引执行排列。您还可以将对象中的值执行到数组中。下面对此进行解释。

var object = {fruit:"mango", color: "yellow"},
   fields = ["fruit", "color"];
d3.permute(object, fields); // output is "mango" "yellow"

d3.zip（数组）

该方法用于返回数组的数组。如果数组仅包含单个数组，则返回的数组包含单元素数组。如果未指定参数，则返回的数组为空。它的定义如下。

d3.zip([10, 20], [30, 40]); // output is [[10, 30], [20, 40]]

示例- 创建网页array_transform并向其添加以下更改。

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

   <body>
      <h3>D3 array API</h3>
      <script>
         console.log(d3.cross([10, 20], ["a", "b"]));
         console.log(d3.merge([[10], [30]]));
         console.log(d3.pairs([10, 20, 30, 40]));
         var object = {fruit:"mango", color: "yellow"},
         fields = ["fruit", "color"];
         console.log(d3.permute(object, fields)); 
         console.log(d3.zip([10, 20], [30, 40]));
      </script>
   </body>
</html>

现在，请求浏览器，我们将看到以下响应。

数组变换