PonyGE2 项目使用教程

1. 项目目录结构及介绍

PonyGE2 项目的目录结构如下：

PonyGE2/
├── datasets/
├── grammars/
├── parameters/
├── seeds/
├── src/
│   ├── ponyge.py
│   └── ...
├── .gitignore
├── CONTRIBUTORS.md
├── LICENSE
├── README.md
└── requirements.txt

目录介绍

• datasets/: 存放数据集文件。
• grammars/: 存放语法文件，用于定义生成程序的结构。
• parameters/: 存放参数配置文件。
• seeds/: 存放种子文件，用于初始化随机数生成器。
• src/: 源代码目录，包含主要的 Python 脚本。
  • ponyge.py: 项目的启动文件。
• .gitignore: Git 忽略文件配置。
• CONTRIBUTORS.md: 贡献者列表。
• LICENSE: 项目许可证文件。
• README.md: 项目介绍和使用说明。
• requirements.txt: 项目依赖库列表。

2. 项目启动文件介绍

启动文件：src/ponyge.py

ponyge.py 是 PonyGE2 项目的启动文件，用于运行 Grammatical Evolution (GE) 算法。通过该文件，用户可以执行默认的回归问题示例，也可以通过命令行参数自定义运行配置。

基本使用方法

$ cd src
$ python ponyge.py

此命令将运行默认的回归问题示例，并在当前目录下生成一个 results 文件夹，包含运行结果、统计数据、图表和最佳个体信息。

详细输出模式

$ cd src
$ python ponyge.py --verbose

在详细输出模式下，每一代的进化过程都会在命令行中打印出来，显示当前运行的统计数据。

查看所有可用参数

$ python ponyge.py --help

此命令将列出所有可用的命令行参数，用户可以根据需要进行配置。

3. 项目配置文件介绍

配置文件：parameters/ 目录

parameters/ 目录下存放了多个配置文件，用于定义 PonyGE2 运行时的各种参数。每个配置文件通常包含以下内容：

• 算法参数: 如种群大小、进化代数、选择策略等。
• 语法文件路径: 指定使用的语法文件。
• 数据集路径: 指定使用的数据集文件。
• 输出路径: 指定结果输出目录。

示例配置文件

# parameters/example.txt

--POPULATION_SIZE 500
--GENERATIONS 100
--GRAMMAR_FILE grammars/regression.txt
--DATASET_FILE datasets/regression_data.csv
--OUTPUT_PATH results/example_run

用户可以根据需要编辑这些配置文件，或者创建新的配置文件来满足不同的实验需求。

依赖库配置：requirements.txt

requirements.txt 文件列出了 PonyGE2 项目所需的所有 Python 依赖库，包括 matplotlib, numpy, scipy, scikit-learn, pandas 等。用户可以通过以下命令安装这些依赖库：

$ pip install -r requirements.txt

或者使用 Anaconda 来满足所有依赖需求。

---

通过以上内容，用户可以了解 PonyGE2 项目的目录结构、启动文件的使用方法以及配置文件的设置方式。希望这份教程能帮助用户顺利使用 PonyGE2 进行 Grammatical Evolution 的研究和实验。