# gel-image-helper

**Repository Path**: deepoo/gel-image-helper

## Basic Information

- **Project Name**: gel-image-helper
- **Description**: 处理原胶图，旋转，调色，缩放等
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-23
- **Last Updated**: 2025-12-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# gel-image-helper

## :orange_book: 介绍

> 胶图素材处理：尺寸调整，亮度，旋转等

:dart: **处理流程步骤**
1. 准备原胶图
    - 从共享盘复制近一个月的胶图
2. 原胶图处理成 `imgsz * imgsz` 的正方形
    - 如果图片`单边尺寸>=1280`则整理成`1280*1280`
    - 如果图片`640<=单边尺寸<=1280`则整理成`640*640`
    - 如果图片`320<=单边尺寸<640`则整理成`320*320`
    - 如果图片`单边尺寸<320`则整理成`320*320`
    - 保持`32`的倍数
3. 人工标注
    - `marker` 正常marker
    - `pollution` 污染
    - `handmade` 手工
    - `leakage` 漏液
4. 亮度处理
    - 分别调亮2级
    - 再调暗2级
    - 标注数据复制步骤3
5. 图片旋转
    - 顺时针逆时针分别旋转2个角度
    - 标注数据是步骤3对应的旋转

:file_folder: **胶图处理目录结构**
- static
    - glue0
        - 1.source
        - 2.resize
        - 3.label
        - 4.rotate
        - 5.brightness


## :blue_book: 使用方法

### :one: 虚拟环境

#### :star: 配置 uv
```bash
mkdir -p ~/.config/uv
touch ~/.config/uv/uv.toml
```
```toml
[pip]
index-url = "https://mirrors.aliyun.com/pypi/simple"
```
#### :star: 创建虚拟环境+安装依赖
```bash
# 创建虚拟环境
uv venv
# 安装依赖
uv pip install -e .
# uv pip install -e . -i https://mirrors.aliyun.com/pypi/simple
```

### :two: 项目配置

编辑 `config.yaml` 文件可修改以下参数：

```yaml
resize:
  input_dir: "/home/lgf/dev/datasets/glue0/1.source"
  output_dir: "/home/lgf/dev/datasets/glue0/2.resize"
```

### :three: 运行程序

#### :herb: 方式一：
```bash
# 激活虚拟环境
source .venv/bin/activate

# 1.收集原图（手工）

# 2.执行调整图片大小
python main.py --process=resize

# 3.执行标注（手工）

# 4.执行亮度调整
python main.py --process=brightness

# 5.执行旋转
python main.py --process=rotate
```

#### :herb: 方式二：
```bash
# 直接使用 uv run 执行 （会创建临时虚拟环境）
uv run python main.py --process=resize
```


## :paperclip: 附录

### labelImg
- labelImg 缺少 distutils 是因为 Python 3.12 已经移除了 distutils 模块。distutils 现在包含在 setuptools 中，安装它即可：
    - `uv pip install setuptools -i https://mirrors.aliyun.com/pypi/simple`