Rubyvis 技术文档

1. 安装指南

环境要求

• Ruby 2.1 至 2.6
• JRuby（1.9 模式）

安装步骤

1. 打开终端或命令行工具。
2. 输入以下命令安装 Rubyvis gem：

   gem install rubyvis
   

3. 等待安装完成，安装成功后即可开始使用 Rubyvis。

2. 项目的使用说明

概述

Rubyvis 是 Protovis 的 Ruby 移植版本，Protovis 是一个 JavaScript 可视化工具包。Rubyvis 实现了 Protovis 的核心 API，包括所有静态标记、SVG 构建类和数据类。

主要功能

• 标记（Marks）：几乎完全实现了所有标记，除了瞬态和过渡标记。
• 布局（Layout）：实现了多种布局，如 Arc、Cluster、Grid、Horizon、Indent、Matrix、Pack、Partition、Stack、Tree 和 Treemap。

示例代码

以下是使用 Rubyvis 创建一个简单柱状图的示例：

require 'rubyvis'

vis = Rubyvis::Panel.new do 
  width 150
  height 150
  bar do
    data [1, 1.2, 1.7, 1.5, 0.7, 0.3]
    width 20
    height {|d| d * 80}
    bottom(0)
    left {index * 25}
  end
end

vis.render
puts vis.to_svg

链式方法 API

Rubyvis 还支持类似于原生 Protovis 的链式方法 API：

require 'rubyvis'

vis = Rubyvis::Panel.new.width(150).height(150);

vis.add(pv.Bar).
  data([1, 1.2, 1.7, 1.5, 0.7, 0.3]).
  width(20).
  height(lambda {|d| d * 80}).
  bottom(0).
  left(lambda {self.index * 25});

vis.render
puts vis.to_svg

3. 项目 API 使用文档

主要 API

• Rubyvis::Panel：用于创建可视化面板。
• Rubyvis::Bar：用于创建柱状图。
• Rubyvis::Line：用于创建折线图。
• Rubyvis::Dot：用于创建点图。
• Rubyvis::Label：用于创建标签。

示例

以下是使用 Rubyvis API 创建不同类型图表的示例：

require 'rubyvis'

# 创建一个面板
vis = Rubyvis::Panel.new do 
  width 200
  height 200
end

# 添加柱状图
vis.add(Rubyvis::Bar).
  data([1, 2, 3, 4, 5]).
  width(20).
  height(lambda {|d| d * 20}).
  bottom(0).
  left(lambda {index * 25})

# 添加折线图
vis.add(Rubyvis::Line).
  data([1, 2, 3, 4, 5]).
  stroke_style(Rubyvis.color("red")).
  line_width(2).
  bottom(lambda {|d| d * 20}).
  left(lambda {index * 25})

vis.render
puts vis.to_svg

4. 项目安装方式

使用 Gem 安装

gem install rubyvis

手动安装

1. 下载 Rubyvis 源代码。
2. 解压文件并进入目录。
3. 运行以下命令进行安装：

   gem build rubyvis.gemspec
   gem install rubyvis-*.gem
   

通过以上步骤，您可以成功安装并开始使用 Rubyvis 进行数据可视化。