refactor(arch): redesign the code structure
This commit is contained in:
+12
-12
@@ -182,15 +182,15 @@ $$
|
||||
|
||||
## 八、运行方式和代码入口
|
||||
|
||||
核心算法仅用Python标准库,支持Python3.10及以上;本次在Python3.12.14中验证。在项目根目录运行:
|
||||
核心算法仅用Python标准库,支持Python3.10及以上;工程依赖仅 `requests`(测试另需 `pytest`)。在项目根目录运行:
|
||||
|
||||
```powershell
|
||||
python -m geometry examples/q1/triangle.json -o output/q1/triangle_recomputed.json
|
||||
python main.py examples/q1/normal.json
|
||||
python -m geometry examples/q1/normal.json --rounding-margin-deg 0.005
|
||||
python -m unittest discover -s tests -v
|
||||
python scripts/build_q1_demo.py
|
||||
python scripts/benchmark_q1.py
|
||||
uv run python -m mcm26b.geometry examples/q1/triangle.json -o output/q1/triangle_recomputed.json
|
||||
uv run mcm26b q1 examples/q1/normal.json
|
||||
uv run python -m mcm26b.geometry examples/q1/normal.json --rounding-margin-deg 0.005
|
||||
uv run pytest
|
||||
uv run python scripts/build_q1_demo.py
|
||||
uv run python scripts/benchmark_q1.py
|
||||
```
|
||||
|
||||
输入JSON的最小格式:
|
||||
@@ -209,22 +209,22 @@ python scripts/benchmark_q1.py
|
||||
|
||||
| 文件 | 职责 |
|
||||
| --- | --- |
|
||||
| `geometry/localization.py` | 测向角域、半平面、区域分类、直径和包围圆 |
|
||||
| `geometry/planning.py` | 问题二首次测向的距离保证候选圆盘;独立于问题一模型 |
|
||||
| `geometry/__main__.py`、`main.py` | JSON命令行输入输出 |
|
||||
| `src/mcm26b/geometry/localization.py` | 测向角域、半平面、区域分类、直径和包围圆 |
|
||||
| `src/mcm26b/geometry/planning.py` | 问题二首次测向的距离保证候选圆盘;独立于问题一模型 |
|
||||
| `src/mcm26b/geometry/__main__.py`、`src/mcm26b/cli.py` | JSON命令行输入输出 |
|
||||
| `tests/test_geometry.py` | 解析反例、随机几何、独立裁剪对照与退化测试 |
|
||||
| `tests/test_practice_replay.py` | 离线复算演练计时与观测结果,不连接模拟器 |
|
||||
| `tests/test_geometry_certificates.py` | 增量圆与穷举法对照、覆盖证据、清除阈值、舍入选项及首次选点证书 |
|
||||
| `scripts/benchmark_q1.py` | 局部性能对比与官方演练误差界敏感性复算 |
|
||||
| `scripts/capture_practice.py` | 在已经启动且已核验的演练中采集少量测向 |
|
||||
| `scripts/build_q1_demo.py` | 用Python算法生成案例、结果和交互图数据 |
|
||||
| `visualization/q1.template.html` | 可视化源模板;不另写一套求解算法 |
|
||||
| `scripts/assets/q1.template.html` | 可视化源模板;不另写一套求解算法 |
|
||||
| `output/q1/question1.html` | 可直接打开的离线交互式模拟,所有数据已内嵌 |
|
||||
|
||||
如需再次采集,先在模拟器明确启动“问题3演练测试”,等待接口就绪,读取案例编码,然后运行:
|
||||
|
||||
```powershell
|
||||
python scripts/capture_practice.py --robot-id 你的参赛队号 --practice-confirmed --case-code 界面中的演练案例编码
|
||||
uv run python scripts/capture_practice.py --robot-id 你的参赛队号 --practice-confirmed --case-code 界面中的演练案例编码
|
||||
```
|
||||
|
||||
接口协议没有返回演练/正式模式的字段,`--practice-confirmed` 是操作者确认已核验界面的显式参数,不能替代界面核查。采集脚本没有启动测试的功能,没有正式模式选项,只会调用 `/enter`、`/measure`、`/exit`。禁止在正式测试会话中运行。
|
||||
|
||||
Reference in New Issue
Block a user