README_CN.md

English | 简体中文 | 🗃️项目开发报告

yaTuner

一个编译器自动调优器。

开始

使用 make init 可以创建一个虚拟环境，示例位于 examples 目录下。

在对一个项目进行优化前，使用 yatuner -g <filename> 生成初始调优脚本模板，对此模板进行修改以适应项目具体情况。生成的初始模板中包含了有关对象的具体信息。

在 yatuner.utils 模块中包含了一些可能会用到的工具，此处是一个简单的汇总：

工具	功能
yatuner.utils.execute	执行命令
yatuner.utils.fetch_perf_stat	获取 perf stat 的结果
yatuner.utils.fetch_arch	获取平台架构
yatuner.utils.fetch_gcc_version	获取 gcc 版本
yatuner.utils.fetch_gcc_optimizers	获取 gcc 优化器
yatuner.utils.fetch_gcc_parameters	获取 gcc 优化参数
yatuner.utils.fetch_gcc_enabled_optimizers	获取 gcc 中某一个选项所打开的优化器
yatuner.utils.fetch_size	获取文件大小

这些工具可以在调优脚本中使用以加快开发速度，详见 examples 中具体的使用例子.

优化过程及有关方法及其功能总结如下表。

方法	功能
yatuner.Tuner.initialize	初始化工作区
yatuner.Tuner.test_run	预测试运行
yatuner.Tuner.hypotest_optimizers	对 optimizers 假设检验
yatuner.Tuner.hypotest_parameters	对 parameters 假设检验
yatuner.Tuner.optimize	使用贝叶斯优化对 parameters 调优
yatuner.Tuner.optimize_linUCB	使用 LinUCB 对 parameters 调优
yatuner.Tuner.run	测试运行并生成结果
yatuner.Tuner.plot_data	生成结果小提琴图

对 yatuner.Tuner 和 yatuner.utils 模块的具体文档可以在 docs 中找到。

模块	文档
yatuner.Tuner	docs/yatuner.tuner.md
yatuner.utils	docs/yatuner.utils.md

使用

1. 安装 yatuner.
2. 使用 yatuner -g <filename> 自动生成初始调优脚本.
3. 手动对调优脚本进行微调.
4. 使用 python <filename> 运行调优脚本.

架构

graph TB
subgraph 用户界面
    O([yaTuner]) --> A
    A[(自动生成调优脚本)] -- 手动微调 --> B[(调优脚本)]
end
B == 运行 ==> C
subgraph 调优过程
    C(自动获取编译器选项) --> D(对 Optimizers 假设检验) 
    D --> E(对 Optimizers 调优)
    E --> F(对 Parameters 假设检验)
    F --> G(对 Parameters 调优)
    G -- 运行测试并比较 --> I[(调优报告)]
end
G -- 存储 --> H[(调优结果)]
E -- 存储 --> H
subgraph 调优器
    J([LinUCB 优化器]) -.-> G
    K([贝叶斯优化器]) -.-> G
    K -.-> E
end
subgraph 预定义函数
    B == 定义 ==> L([comp])
    B == 定义 ==> M([run])
    B == 定义 ==> N([perf])
end
N -.-> J
L & M -.-> J & K

Loading

许可协议

yaTuner 使用 Mulan PSL v2 许可证，见 LICENSE。

关于

本项目是对 2022全国大学生操作系统比赛功能赛道 proj105 题目的实现，详见 proj105 repo。