Pivot Table 技术文档

1. 安装指南

Pivot Table 是一个简单的 Ruby gem，用于将数据集转换为电子表格风格的透视表。要安装 Pivot Table，请运行以下命令：

gem install pivot_table

确保你已经安装了 Ruby 环境。

2. 项目的使用说明

Pivot Table gem 非常适合将数据集转换为透视表格式，以便于显示和分析。下面是如何使用这个项目的简要说明。

首先，你需要有一个数据集，例如一组订单对象：

class Order
  attr_accessor :city, :quarter, :sales, :top_sales
end

obj_1 = Order.new(city: 'London', quarter: 'Q1', sales: 100)
obj_2 = Order.new(city: 'London', quarter: 'Q2', sales: 150)
# ... 更多订单对象

接着，创建一个 PivotTable::Grid 对象，并指定数据源、列名、行名以及值名：

g = PivotTable::Grid.new do |g|
  g.source_data = [obj_1, obj_2] # ... 你的数据集
  g.column_name = :quarter
  g.row_name     = :city
  g.value_name   = :sales
end

g.build

现在，g 对象就是一个包含透视表数据的逻辑网格。

3. 项目API使用文档

Pivot Table 提供了灵活的 API 来访问和处理透视表数据。以下是一些关键的 API 方法：

• g.row_headers: 返回所有行标题。
• g.columns: 返回所有列的集合。
• g.column_headers: 返回所有列标题。
• g.column_totals: 返回每列的总和。
• g.row_totals: 返回每行的总和。
• g.grand_total: 返回整个透视表的总和。

例如，获取某列的总和：

g.columns[0].total

4. 项目安装方式

Pivot Table 可以通过 Ruby gem 包进行安装。确保你的环境中已经安装了 Ruby，然后使用以下命令安装 gem：

gem install pivot_table

安装后，你可以在你的 Ruby 项目中引入并使用 pivot_table 库。

以上是关于 Pivot Table gem 的技术文档。这个工具简单易用，非常适合需要将数据转换为透视表格式的场景。希望这个文档能够帮助你更好地使用和了解这个项目。