开源孪创hutb地图与天气系统详解:13张城镇地图切换与环境定制技巧

原创2026-10-28 15:08:151,815 阅读
文章标签:自动驾驶机器人物理引擎数字孪生具身智能科研

开源孪创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)。

hutb 13张城镇地图切换效果全景总览

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 章节。

hutb Town01 城镇地图:河流、桥梁与T形路口

hutb Town03 城市地图环岛与大路口

hutb Town04 山区小镇高架桥道路

进阶技巧:用 _Opt 分层地图控制场景密度

除普通地图外,hutb 还提供以 _Opt 结尾的分层地图(如 Town01_Opt)。分层地图允许你在加载时指定保留哪些图层——道路、人行道、红绿灯是必选的最小布局,建筑和停车车辆等图层可自由开关:

world = client.load_world(
    'Town01_Opt',
    carla.MapLayer.Buildings | carla.MapLayer.ParkedVehicles)

这一技巧特别适合训练数据生成场景:关闭无关图层可以显著提升渲染性能,是 hutb 环境定制中最实用的手段之一(图层 API 说明见 Docs/core_map.md)。

hutb Town05 方格路网城市地图停车场细节

天气系统:一行代码定制雨雾与日照

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 沙尘暴强度

hutb 天气系统:黄昏浓雾中的乡村场景

更快:使用内置天气预设

不想逐个调参?直接套用预设枚举即可,一行完成环境切换:

world.set_weather(carla.WeatherParameters.WetCloudySunset)

预设列表(ClearNoon、WetCloudy、HeavyRain、Fog、Dusk、Snow 等)完整定义见 Docs/python_api.md 中的 carla.WeatherParameters 章节。

动态天气:两个官方脚本

hutb 官方提供了两个开箱即用的脚本,让天气随时间自然变化:

hutb Town06 多车道高速公路地图

hutb Town07 乡村地图水面与道路

hutb Town10 城市地图摩天楼街景

大型地图:Town11~Town13 与超大规模场景

Town11、Town12、Town13 属于 Large Maps 特性,支持分块流式加载,可容纳远超传统城镇的超大范围场景。Town12/13 内置高层住宅、高速、公园、水域等多种区域:

hutb Town13 大型地图多区域总览

大型地图的原理与 RoadRunner 工作流介绍见 Docs/large_map_overview.md 与 Docs/large_map_roadrunner.md。

从源码级定制:用 Unreal 蓝图设置默认天气

如果你从源码构建 hutb 并拥有 Unreal Editor,还可以在编辑器层面为地图设置默认天气(教程见 Docs/tuto_M_custom_weather_landscape.md):

  1. BP_Sky — 场景中的天空与光照蓝图,用于在保存前预览各种天气参数(注意场景中只允许存在一个 BP_Sky,否则会出现"双太阳");
  2. 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。

登录后查看全文
hutb