Statsample 项目技术文档

1. 安装指南

1.1 安装 Ruby

首先，确保你已经安装了 Ruby 环境。你可以通过以下命令检查是否已安装 Ruby：

ruby -v

如果未安装，请根据你的操作系统选择合适的安装方法。例如，在 Ubuntu 上可以使用以下命令安装：

sudo apt-get install ruby-full

1.2 安装 Statsample

使用以下命令安装 Statsample 及其依赖：

sudo gem install statsample

1.3 可选依赖安装

如果你需要进行高级统计分析或绘图，可以安装以下可选依赖：

• GSL 库：用于因子分析和多项相关分析。

sudo gem install rb-gsl

• Statsample-optimization：用于加速某些方法。

sudo gem install statsample-optimization

• Statsample-sem：用于结构方程建模。

sudo gem install statsample-sem

2. 项目的使用说明

2.1 基本统计分析

Statsample 提供了丰富的统计分析功能，包括描述性统计、相关性分析、ANOVA、回归分析等。以下是一个简单的示例，展示如何计算一组数据的均值和标准差：

require 'statsample'

data = [10, 20, 30, 40, 50]
vector = Statsample::Vector.new(data)

puts "Mean: #{vector.mean}"
puts "Standard Deviation: #{vector.sd}"

2.2 数据导入与导出

Statsample 支持从 CSV、Excel 等文件格式导入数据，并可以将分析结果导出为这些格式。以下是一个导入 CSV 文件的示例：

require 'statsample'

dataset = Statsample::CSV.read('data.csv')
puts dataset.summary

2.3 绘图功能

Statsample 提供了基本的绘图功能，如直方图、箱线图和散点图。以下是一个绘制箱线图的示例：

require 'statsample'

data = [10, 20, 30, 40, 50, 100]
vector = Statsample::Vector.new(data)

boxplot = Statsample::Graph::Boxplot.new(vector)
boxplot.export_to_file('boxplot.svg')

3. 项目API使用文档

3.1 描述性统计

• Statsample::Vector：用于存储和操作一维数据，提供均值、标准差、中位数等统计方法。
• Statsample::Dataset：用于存储和操作二维数据，类似于 R 中的数据框。

3.2 相关性分析

• Statsample::Bivariate.correlation_matrix：计算相关性矩阵。
• Statsample::Bivariate::Tetrachoric：计算四分相关。
• Statsample::Bivariate::Polychoric：计算多项相关。

3.3 回归分析

• Statsample::Regression::Simple：简单线性回归。
• Statsample::Regression::Multiple：多元线性回归。
• Statsample::Regression::Binomial::Logit：Logit 回归。
• Statsample::Regression::Binomial::Probit：Probit 回归。

3.4 因子分析

• Statsample::Factor::PCA：主成分分析。
• Statsample::Factor::Varimax：Varimax 旋转。
• Statsample::Factor::ParallelAnalysis：并行分析。

3.5 可靠性分析

• Statsample::Reliability::ScaleAnalysis：计算 Cronbach's Alpha 等可靠性指标。

4. 项目安装方式

4.1 使用 Gem 安装

Statsample 可以通过 RubyGems 安装：

sudo gem install statsample

4.2 源码安装

如果你需要从源码安装，可以克隆 GitHub 仓库并运行安装脚本：

git clone https://github.com/sciruby/statsample.git
cd statsample
sudo ruby setup.rb

4.3 可选依赖安装

根据你的需求，安装可选依赖以增强功能：

sudo gem install rb-gsl statsample-optimization statsample-sem

通过以上步骤，你可以顺利安装并使用 Statsample 进行各种统计分析。