README.md · k18700474961/GCBS-GPU

# GCBS-GPU 用户手册

GCBS-GPU是一款用于评估显示芯片性能水平的测评工具。该工具根据GPU硬件管线特点，基于OpenGL、OpenGLES、OpenCL、Vulkan等主流图形编程接口，面向图形渲染场景和并行计算场景，通过运行典型性能基准用例，测试显示芯片性能（每秒的图形渲染帧率和典型数据的运算能力）。

### 软硬件要求

- C，C++编译器，cmake（版本>`3.14.1`）构建工具

- Python3

- PyPDF2（版本>`1.26.0`）
  - reportlab（版本>`3.5.42`）
  - Pillow第三方软件包

### 安装

1. 安装 GCBS-GPU

GCBS-GPU 采用免安装模式，下载 GCBS-GPU 软件包**GCBS-GPU.tar.gz**到被测系统上解压即可。

```bash
   tar -jxvf GCBS-GPU.tar.bz2
   ```

2. 准备运行环境，运行前确保已安装依赖软件及工具

对于`x86_64` 、`aarch64`、`loongarch`、`sw_64`架构， GCBS-GPU 内置了`CMake`和`Python3` (包括`PyPDF2`、`reportlab`、`Pillow`和`libjpeg.so.62`)工具，用户只需安装C、C++编译器等即可。

准备: 安装依赖包（如果脚本执行报错，则需手动安装和配置）
     ```sh
     cd ~/GCBS-GPU/docs/utils/beforeRun
     ./before-run.sh desktop
     cd ../../../
     ```

### 运行

1. 修改配置文件

根据被测环境系统信息及测试目的，修改**config/config_sample.ini**文件里面的配置项

- 配置文件语法
     大小写敏感
     注释以`#`或`;`开头
     **注意**：空格或缩进表示本行内容为前一个配置项的参数
     详情[参考配置文件使用](/docs/config.md)指南

2. 切换到GCBS-GPU的安装目录，直接执行gcbs.sh

- 采用默认配置文件运行 **config/config_sample.ini**

```sh
     ./gcbs.sh
     ```

- 运行过程中跳过执行失败/不支持的用例。

```sh
     ./gcbs.sh --skipfail 1
     ```

- 指定要运行的测试项，既可以通过配置文件设置，也可以通过命令行指定

```
     ./gcbs.sh -i 1 -s 1 -d 1 -f opencl -t bs-download-speed
     ./gcbs.sh -t opencl
     ./gcbs.sh -t vulkan
     ./gcbs.sh -t bs-download-speed
     ```
     
     更多选项请参考`./gcbs.sh -h`及参阅[配置文件使用指南](/docs/config.md )

### 查看结果

GCBS-GPU运行结束后：

- 会在工作目录（默认是<install_dir>/results）固定生成machine_info.txt、LOG 、JSON 文件
- 根据用户配置（配置文件或命令行 report 字段）生成 PDF/TXT/CSV 格式测试报告

- 每次运行都会创建单独的报告子目录，以日期时间后缀命名，例如 **GCBS_single_2023-03-06-14-56-15/** 。

k18700474961/GCBS-GPU

简介

发行版

贡献者

近期动态

k18700474961/GCBS-GPU .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

k18700474961/GCBS-GPU