Pycel 项目技术文档

1. 安装指南

1.1 环境要求

• Python 3.6 或更高版本
• 以下 Python 库：
  • dateutil
  • networkx
  • numpy
  • openpyxl
  • ruamel.yaml
  • 可选：matplotlib 和 pydot

1.2 安装步骤

1. 使用 pip 安装 Pycel：

   pip install pycel
   

2. 安装所需的依赖库：

   pip install python-dateutil networkx numpy openpyxl ruamel.yaml
   

   如果需要使用 matplotlib 和 pydot，可以额外安装：

   pip install matplotlib pydot
   

2. 项目使用说明

2.1 快速开始

1. 下载 Pycel 库。
2. 运行示例文件以了解如何使用该工具。

2.2 主要功能

• 支持主要的数学函数（如 sin, cos, atan2 等）和运算符（如 +, /, ^ 等）。
• 支持 Excel 中的范围引用（如 A5:D7）和常用函数（如 MIN, MAX, INDEX, LOOKUP, LINEST 等）。
• 代码库小巧、运行速度较快，易于理解和扩展。

2.3 注意事项

• 目前仅支持开发者所需的函数，其他函数可以通过扩展代码来支持。
• 不支持 Excel 中的 VBA 代码，需要手动在 Python 端重新实现。

3. 项目 API 使用文档

3.1 主要 API

• Pycel.compile(excel_file): 将 Excel 文件编译为可执行的 Python 代码。
• Pycel.export_graph(graph, output_file): 导出计算图以便使用工具（如 Gephi）进行分析。

3.2 示例

from pycel import ExcelCompiler

# 编译 Excel 文件
excel = ExcelCompiler(filename='example.xlsx')

# 导出计算图
excel.export_graph('example_graph.gexf')

4. 项目安装方式

4.1 通过 pip 安装

pip install pycel

4.2 从源码安装

1. 克隆项目仓库：

   git clone https://github.com/dgorissen/pycel.git
   

2. 进入项目目录并安装：

   cd pycel
   pip install .
   

通过以上步骤，您可以顺利安装并使用 Pycel 项目，将其应用于 Excel 文件的编译和分析。