开源孪创hutb地图与天气系统详解:13张城镇地图切换与环境定制技巧
开源孪创hutb地图与天气系统详解:13张城镇地图切换与环境定制技巧
hutb(人车模拟器 Human-vehicle Simulator)内置了 13 张可直接加载的城镇地图,并提供了完整的天气系统——你可以用一行 Python 代码切换地图,用一组天气参数(cloudiness、precipitation、fog 等)定制雨雾、日照、风暴环境。本文面向新手,带你快速掌握 hutb 地图切换与环境定制的核心技巧。
3 分钟上手:加载与切换城镇地图
hutb 基于 Python API 控制整个仿真世界。切换地图的核心方法是 client.load_world('地图名'),例如:
import carla
client = carla.Client('localhost', 2000)
world = client.load_world('Town01') # 加载 Town01 地图
- 每次
load_world都会销毁旧世界并创建新世界,因此地图切换是全局操作; - 用
client.available_maps可查询当前可用的地图列表; - 地图加载完成后,可通过
world.get_map()获取地图对象,访问车道、导航网格、Waypoint 等信息(详见 Docs/core_map.md)。
13 张内置城镇地图怎么选?
hutb 覆盖了从乡村、小城到超大型城区的多种场景,每张地图的文档都放在 Docs/ 目录下,方便按需查阅。
| 地图 | 特点 | 文档 |
|---|---|---|
| Town01 | 小型城镇,河流与多座桥梁 | map_town01.md |
| Town02 | 小型城镇,住宅与商业建筑混合 | map_town02.md |
| Town03 | 大型城市,含环岛与大路口 | map_town03.md |
| Town04 | 山区小镇,含"8字形"无限高速 | map_town04.md |
| Town05 | 方格路网、多车道,适合变道测试 | map_town05.md |
| Town06 | 多车道高速公路,出入口众多(附加内容) | map_town06.md |
| Town07 | 乡村环境,窄路、玉米地、谷仓(附加内容) | map_town07.md |
| Town10 | 市中心高楼 + 海滨长廊 | map_town10.md |
| Town11 | 大型地图 Large Map 概念验证 | map_town11.md |
| Town12 | 大型地图:高层、住宅、乡村多区域 | map_town12.md |
| Town13 | 大型地图:高速、公园、水域等区域 | map_town13.md |
💡 Town06 与 Town07 属于附加内容包,不在标准安装包中,安装主程序后需单独导入,说明见 Docs/core_map.md 的 Additional Maps 章节。
进阶技巧:用 _Opt 分层地图控制场景密度
除普通地图外,hutb 还提供以 _Opt 结尾的分层地图(如 Town01_Opt)。分层地图允许你在加载时指定保留哪些图层——道路、人行道、红绿灯是必选的最小布局,建筑和停车车辆等图层可自由开关:
world = client.load_world(
'Town01_Opt',
carla.MapLayer.Buildings | carla.MapLayer.ParkedVehicles)
这一技巧特别适合训练数据生成场景:关闭无关图层可以显著提升渲染性能,是 hutb 环境定制中最实用的手段之一(图层 API 说明见 Docs/core_map.md)。
天气系统:一行代码定制雨雾与日照
hutb 的天气不是独立类,而是世界(World)上的一组参数。通过 carla.WeatherParameters 构造天气,再用 world.set_weather() 应用:
weather = carla.WeatherParameters(
cloudiness=80.0, # 云量(0~100)
precipitation=30.0, # 降水量(0~100)
sun_altitude_angle=70.0) # 太阳高度角
world.set_weather(weather)
print(world.get_weather()) # 读取当前天气
常用参数速查:
| 参数 | 含义 |
|---|---|
cloudiness |
云量 |
precipitation / precipitation_deposits |
降水量 / 地面沉积 |
fog_density / fog_distance |
雾浓度 / 雾距离 |
wetness |
路面湿滑程度 |
sun_azimuth_angle / sun_altitude_angle |
太阳方位角 / 高度角(决定昼夜) |
dust_storm |
沙尘暴强度 |
更快:使用内置天气预设
不想逐个调参?直接套用预设枚举即可,一行完成环境切换:
world.set_weather(carla.WeatherParameters.WetCloudySunset)
预设列表(ClearNoon、WetCloudy、HeavyRain、Fog、Dusk、Snow 等)完整定义见 Docs/python_api.md 中的 carla.WeatherParameters 章节。
动态天气:两个官方脚本
hutb 官方提供了两个开箱即用的脚本,让天气随时间自然变化:
- PythonAPI/util/environment.py — 通过命令行参数在
clear、overcast、rain等预设间切换,实时调整光照与车辆灯光; - PythonAPI/examples/dynamic_weather.py — 内置多组天气预设并在其间平滑插值,模拟动态天气演变,适合长时间数据录制。
大型地图:Town11~Town13 与超大规模场景
Town11、Town12、Town13 属于 Large Maps 特性,支持分块流式加载,可容纳远超传统城镇的超大范围场景。Town12/13 内置高层住宅、高速、公园、水域等多种区域:
大型地图的原理与 RoadRunner 工作流介绍见 Docs/large_map_overview.md 与 Docs/large_map_roadrunner.md。
从源码级定制:用 Unreal 蓝图设置默认天气
如果你从源码构建 hutb 并拥有 Unreal Editor,还可以在编辑器层面为地图设置默认天气(教程见 Docs/tuto_M_custom_weather_landscape.md):
- BP_Sky — 场景中的天空与光照蓝图,用于在保存前预览各种天气参数(注意场景中只允许存在一个 BP_Sky,否则会出现"双太阳");
- BP_Weather — 定义每张地图的默认天气数组,参数与 Python API 中的
WeatherParameters完全一致。打开Content/Carla/Blueprints/Weather/BP_Weather,为你的城镇添加一条记录并填写参数,保存即可。
配合 Python API 的 set_weather,就构成了"默认天气 + 运行时覆盖"的完整定制链路。
总结:hutb 地图与环境定制要点
| 目标 | 方法 |
|---|---|
| 切换地图 | client.load_world('Town03') |
| 查询可用地图 | client.available_maps |
| 降低场景密度 | 加载 Town01_Opt + MapLayer 掩码 |
| 应用预设天气 | world.set_weather(carla.WeatherParameters.ClearNoon) |
| 自定义天气参数 | carla.WeatherParameters(...) + world.set_weather() |
| 动态天气 | PythonAPI/examples/dynamic_weather.py |
| 设置地图默认天气 | Unreal 蓝图 BP_Weather(见 Docs/tuto_M_custom_weather_landscape.md) |
掌握以上内容,你就能在 hutb 中自由切换 13 张城镇地图,并灵活定制从正午晴空到浓雾暴雨的各种仿真环境。更多世界 API 细节请阅读 Docs/core_world.md。









