PurePLES 开源项目使用教程
1. 项目的目录结构及介绍
PurePLES 是一个纯 Python 库,用于 ES-HyperNEAT。项目的目录结构如下:
pureples/
├── .gitignore
├── LICENSE.txt
├── PUREPLES.png
├── README.md
├── setup.py
└── pureples/
├── __init__.py
├── es_hyperneat.py
├── hyperneat.py
├── neat_reporter.py
├── neat_python/
│ ├── __init__.py
│ ├── config.py
│ ├── population.py
│ ├── reproduction.py
│ ├── species.py
│ └── visualize.py
└── tests/
├── __init__.py
├── test_es_hyperneat.py
└── test_hyperneat.py
目录结构介绍
.gitignore
: Git 忽略文件配置。LICENSE.txt
: 项目许可证文件。PUREPLES.png
: 项目图标。README.md
: 项目说明文档。setup.py
: 项目安装脚本。pureples/
: 项目主代码目录。__init__.py
: 模块初始化文件。es_hyperneat.py
: ES-HyperNEAT 实现文件。hyperneat.py
: HyperNEAT 实现文件。neat_reporter.py
: NEAT 报告生成文件。neat_python/
: NEAT-Python 实现目录。__init__.py
: 模块初始化文件。config.py
: 配置文件处理模块。population.py
: 种群处理模块。reproduction.py
: 繁殖处理模块。species.py
: 物种处理模块。visualize.py
: 可视化模块。
tests/
: 测试代码目录。__init__.py
: 模块初始化文件。test_es_hyperneat.py
: ES-HyperNEAT 测试文件。test_hyperneat.py
: HyperNEAT 测试文件。
2. 项目的启动文件介绍
项目的启动文件是 setup.py
。该文件用于安装和配置项目。
setup.py
文件介绍
from setuptools import setup, find_packages
setup(
name='pureples',
version='0.1',
packages=find_packages(),
install_requires=[
'neat-python',
],
author='ukuleleplayer',
author_email='example@example.com',
description='Pure Python Library for ES-HyperNEAT',
license='MIT',
keywords='neuroevolution hyperneat es-hyperneat',
url='https://github.com/ukuleleplayer/pureples',
)
启动步骤
- 克隆项目仓库:
git clone https://github.com/ukuleleplayer/pureples.git
- 进入项目目录:
cd pureples
- 安装项目依赖:
pip install -r requirements.txt
- 运行项目:
python setup.py install
3. 项目的配置文件介绍
项目的配置文件位于 pureples/neat_python/config.py
。该文件用于配置 NEAT 和 ES-HyperNEAT 的参数。
config.py
文件介绍
# 配置文件示例
config = {
'population_size': 100,
'max_generations': 100,
'fitness_threshold': 0.9,
'compatibility_threshold': 3.0,
'species_elitism': 2,
'c1': 1.0,
'c2': 1.0,
'c3': 0.4,
'survival_threshold': 0.2,
'stagnation_limit': 15,
'elitism': 2,