# GCBS-GPU

**Repository Path**: perfbenchmark/gcbs-gpu

## Basic Information

- **Project Name**: GCBS-GPU
- **Description**: GCBS-GPU，显示芯片性能测试套件（每秒图形渲染帧率和典型数据运算能力） ，适用于测试通用图形处理器硬件设备基础性能、图形系统软件性能、并行计算性能等  。     
- **Primary Language**: C
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 58
- **Forks**: 25
- **Created**: 2023-03-21
- **Last Updated**: 2025-08-19

## Categories & Tags

**Categories**: testing

**Tags**: None

## README

# 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/** 。