# ComputerLive

**Repository Path**: ttx-sky_admin/computer-live

## Basic Information

- **Project Name**: ComputerLive
- **Description**: 模拟生命
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-09
- **Last Updated**: 2025-04-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ComputerLive

#### 介绍
模拟生命

#### 项目结构

```
src/
├── api/             # 核心算法模块
│   ├── Animals.py    # 生物行为与遗传算法
│   ├── Food.py       # 资源生成与消耗模型
│   └── TrainingModel.py # 机器学习预测模块
├── core/            # 可视化界面组件
├── lib/             # 配置常量与工具函数
└── test_model.py    # 主测试入口
```
#### 软件架构

**系统架构**
- 核心模块：`src/core` 实现遗传算法与能量模型
- API接口层：`src/api` 提供训练模型接口
- 可视化模块：`src/test_model.py` 集成Tkinter/Matplotlib
- 数据层：`src/model` 存储训练结果与进化记录

**技术栈**
- Python 3.8+ 
- NumPy 1.22+ 数值计算
- OpenCV 4.5+ 视觉处理
- Matplotlib 3.6+ 数据可视化

**算法实现**

### 遗传算法
- 基因重组机制：在`Animal.breed()`方法中实现父代基因的加权平均（权重0.6/0.4）
- 突变率控制：基础突变率15%（速度±22.5%，视野±7.5%）
- 模型预测融合：使用`TrainingModel`预测结果进行30%的权重修正

### 模型训练
- 世代追踪：通过`all_animals`队列记录种群进化历史
- 特征预测：基于当前世代数预测下一代的理想速度/视野参数
- 在线学习：每1000代自动保存模型参数到`src/model/`

### 视觉处理
- OpenCV实时渲染：通过`src/test_model.py`实现动态热力图
- 视觉范围模拟：基于`vision`属性计算费舍尔投影变换
- 竞争感知：50像素半径内的同类数量影响觅食决策

#### 快速开始

```bash
# 启动进化模拟可视化界面
python main.py

```

### 遗传算法与进化模拟
- 基于动态能量消耗的移动决策算法
- 基因重组机制（速度/视野遗传）
- 自适应繁殖冷却系统
- 多线程环境感知与竞争评估

### GUI测试框架
- Tkinter可视化模拟界面
- 实时生物运动轨迹追踪
- Matplotlib进化趋势图表集成
- OpenCV视觉处理模块

#### 贡献指南

1. 分支规范
   - 功能分支: `feat/功能名称`
   - 修复分支: `fix/问题描述`
   
2. 代码要求
   - PEP8编码规范
   - 重要函数需包含docstring
   - 单元测试覆盖率不低于80%

3. 提交流程
   ```bash
   # 创建特性分支
   git checkout -b feat/new-feature
   
   # 提交前运行测试
   python -m pytest tests/
   
   # 提交说明需包含英文描述
   git commit -m "feat: add new mutation algorithm [EN]"
   ```