# halcon_vision_project

**Repository Path**: lidaise/halcon_vision_project

## Basic Information

- **Project Name**: halcon_vision_project
- **Description**: 时间：2026年1月6日13:33:24
功能：halcon 语法，git版本管理
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-06
- **Last Updated**: 2026-01-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Halcon视觉检测项目
基于Halcon的工业视觉检测项目文件夹结构，所有一级目录带序号前缀，便于排序和管理。

## 项目目录结构说明
| 序号 | 一级目录       | 功能说明                     |
|------|----------------|------------------------------|
| 01 | config | 配置文件管理（Halcon参数、相机参数、标定参数等） |
| 02 | data | 数据存储（原始图像、标定板图像、标注文件、演示样例） |
| 03 | hdev_files | Halcon HDevelop脚本核心目录（标定、匹配、检测、工具类脚本） |
| 04 | models | 模型/模板文件（匹配模板、标定结果、OCR模型、导出部署文件） |
| 05 | src | 联合编程源代码（Python/C++封装Halcon算子、相机采集、工具函数） |
| 06 | scripts | 一键执行脚本（标定、匹配、检测、模型导出、批量处理） |
| 07 | tests | 单元测试代码（验证各模块功能正确性） |
| 08 | docs | 项目文档（API说明、标定指南、问题排查手册） |
| 09 | logs | 运行日志存储（标定日志、匹配日志、检测日志） |
| 10 | outputs | 结果输出（标定报告、检测结果、匹配结果） |

## .gitignore文件说明
### 1. 核心作用
`.gitignore` 是Git版本控制系统的配置文件，用于指定「无需纳入版本管理」的文件/文件夹，避免：
- 大体积文件（如Halcon模板、模型权重）导致Git仓库臃肿；
- 本地临时文件（日志、输出结果）引发团队协作冲突；
- 敏感信息（如相机IP/密码）泄露。

### 2. 核心忽略规则（适配Halcon项目）
| 忽略项                  | 原因说明                                  |
|-------------------------|-------------------------------------------|
| 09_logs/、10_outputs/   | 本地生成的日志、检测结果，无需提交        |
| 04_models/halcon_templates/ | Halcon匹配模板体积大，建议单独备份     |
| 04_models/calib_results/ | 标定结果文件，可本地重新生成              |
| __pycache__/、venv/     | Python编译缓存、虚拟环境，无需跨环境同步  |
| *.shm、*.ppm、*.dat      | Halcon专属模板/标定文件，体积大且本地可用 |

### 3. 使用提示
- 若需追踪某类被忽略的文件（如特定标定模板），可在.gitignore中注释对应规则；
- 团队协作时，确保所有人使用相同的.gitignore规则，避免不必要的提交。

## 使用提示
1. 所有配置参数统一放在 `01_config` 目录，避免硬编码；
2. Halcon核心脚本放在 `03_hdev_files`，按功能分类管理；
3. 训练/生成的模板/模型放在 `04_models`，建议按版本命名；
4. 项目文档（如标定步骤、算子说明）补充在 `08_docs`；
5. 运行日志和检测结果分别自动存入 `09_logs` 和 `10_outputs`。

## 环境依赖
请参考项目根目录的 `requirements.txt` 安装Python依赖包。