89 lines
4.4 KiB
Python
89 lines
4.4 KiB
Python
"""全项目参数中心：题面常量、协议限制、会话策略与搜索规划参数。
|
||
|
||
任何魔法数字只允许在这里出现一次。各模块通过 :class:`ProblemConfig` 读取；
|
||
命令行需要覆盖时用 ``dataclasses.replace`` 派生新配置，不散落字面量。
|
||
|
||
来源标注约定：
|
||
- ``[题面]`` 出自 issue/B题.pdf、附件1《模拟器使用说明》、附件2《通信接口说明》原文；
|
||
- ``[工程]`` 本队工程参数，可依演练实测调整，不代表官方规定。
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
from dataclasses import dataclass
|
||
|
||
Vec2 = tuple[float, float]
|
||
|
||
|
||
@dataclass(frozen=True)
|
||
class FieldConfig:
|
||
"""题目物理世界与协议硬限制。[题面]"""
|
||
|
||
omega_radius_m: float = 1800.0 # 目标区域半径，圆心为原点
|
||
channel_min: int = 1 # 有效频道范围
|
||
channel_max: int = 20
|
||
source_count_min: int = 10 # 一局源总数范围（接口不直接告知）
|
||
source_count_max: int = 16
|
||
r_eff_min_m: float = 1000.0 # 有效接收半径下界：no_signal 只能排除该圆盘
|
||
r_eff_max_m: float = 1500.0 # 有效接收半径上界：direction 隐含距离上界
|
||
near_radius_m: float = 5.0 # "距离过近"阈值，不返回示向度
|
||
clear_radius_m: float = 20.0 # 清除半径；与定向朝向无关
|
||
bearing_error_half_deg: float = 1.0 # 示向度误差幅度（题设模型）
|
||
bearing_decimals: int = 2 # 返回示向度小数位
|
||
coord_abs_limit_m: float = 2_000_000.0 # 提交坐标的绝对值上限（超出返回 HTTP 400）
|
||
directional_half_angle_deg: float = 90.0 # 定向源朝向两侧各90度覆盖（含边界）
|
||
max_virtual_duration_s: float = 360_000.0 # 虚拟世界限时（100小时）
|
||
max_real_duration_s: float = 1200.0 # /enter 成功后程序运行上限（20分钟）
|
||
test_window_s: float = 1500.0 # 确认开始后的测试窗口（25分钟）
|
||
|
||
|
||
@dataclass(frozen=True)
|
||
class CostConfig:
|
||
"""虚拟世界动作耗时模型。[题面] 附件1表1、附件2第4节。"""
|
||
|
||
speed_mps: float = 5.0 # 移动速度；耗时=直线距离/speed
|
||
measure_s: float = 5.0 # 每次检测动作耗时（无论结果）
|
||
switch_s: float = 1.0 # 任意两频道间切换耗时，仅由合法 /measure 触发
|
||
clear_success_s: float = 5.0 # 清除成功耗时 = 光学定位3s + 激光清除2s
|
||
clear_fail_s: float = 3.0 # 未发现可清除目标 = 仅光学定位3s
|
||
|
||
|
||
@dataclass(frozen=True)
|
||
class SessionConfig:
|
||
"""会话与网络策略。arena/robot/request 规则为 [题面]，其余为 [工程]。"""
|
||
|
||
arena_id: str = "default" # [题面] 固定值
|
||
base_url: str = "http://127.0.0.1:2026" # [题面] 模拟器默认接口地址
|
||
robot_id_max_bytes: int = 64 # [题面] UTF-8 长度 1..64
|
||
request_id_max_bytes: int = 128 # [题面] UTF-8 长度 1..128
|
||
request_body_max_bytes: int = 65_536 # [题面] 超出返回 HTTP 413
|
||
connect_timeout_s: float = 5.0 # [工程] 连接超时
|
||
read_timeout_s: float = 15.0 # [工程] 读超时；覆盖"服务器已处理但响应丢失"
|
||
max_attempts: int = 3 # [工程] 单动作最多尝试次数（含首次）
|
||
retry_backoff_s: float = 0.25 # [工程] 重试退避基数，按 2^n 放大
|
||
reserve_exit_s: float = 60.0 # [工程] 预留退出与故障恢复的现实秒数
|
||
real_rtt_p95_s: float = 1.0 # [工程] 现实单请求高分位估计，预算核算用
|
||
|
||
|
||
@dataclass(frozen=True)
|
||
class SearchConfig:
|
||
"""搜索与覆盖规划参数。[工程] 推导依据见 docs/B题建模分析与实施计划.md。"""
|
||
|
||
grid_step_m: float = 700.0 # P4 覆盖网格步长；单元对角 700*sqrt(2)≈989.95<=1000
|
||
grid_half_cells: int = 3 # i,j ∈ [-3,3]，49 点覆盖 [-2100,2100]^2 ⊇ Ω
|
||
fallback_clear_grid_m: float = 20.0 # P5 后备清除网格；10*sqrt(2)<=20
|
||
bearing_rounding_margin_deg: float = 0.0 # 默认不加舍入裕量；敏感性分析时显式设 0.005
|
||
|
||
|
||
@dataclass(frozen=True)
|
||
class ProblemConfig:
|
||
"""聚合配置。各模块函数的第一个默认参数，便于单测替换。"""
|
||
|
||
field: FieldConfig = FieldConfig()
|
||
cost: CostConfig = CostConfig()
|
||
session: SessionConfig = SessionConfig()
|
||
search: SearchConfig = SearchConfig()
|
||
|
||
|
||
DEFAULT_CONFIG = ProblemConfig()
|