从shp到sumo：路网转换链路与netconvert参数实战

1. 从shp到osm再到sumo：这条链路到底在解决什么问题

做交通仿真的人迟早会撞上一个很现实的问题：手头拿到的路网数据是shp格式的。可能是从某个地理信息平台下载的，也可能是合作方给的，甚至是从CAD图纸转出来的。但sumo这个仿真工具，它原生认的是自己的.net.xml格式，而通往.net.xml最顺滑的一条路，是先有osm文件，再用netconvert去转换。

所以整条链路是这样的：shp → osm → net.xml。中间那个osm环节，很多人觉得多余，为什么不直接从shp转到net.xml？我一开始也这么想，后来发现osm这层"中间商"其实有它的价值。osm本身是一种开放的、结构化的路网描述格式，它把道路的拓扑关系、车道数、限速、道路类型这些属性用一套相对统一的标签体系表达出来。当你把shp先转成osm，相当于把原始数据"翻译"成了一种sumo更容易理解的中间语言，后续用netconvert处理时，很多拓扑构建、车道推断的工作就能自动完成，省去大量手工调整。

这条链路适合谁？如果你手上有shp格式的路网数据，想快速搭一个sumo仿真场景，又不想从零手动画路网，那这套流程就是为你准备的。它不要求你精通GIS，但需要你对shp的字段结构、osm的标签体系、sumo的netconvert参数都有基本的认识。下面我会把每一步拆开讲，包括我实际踩过的坑和最后验证有效的做法。

2. 动手之前：shp数据的"体检"与预处理

2.1 先搞清楚你的shp里到底有什么

拿到一个shp文件，别急着转。第一步是打开它看看。我习惯用QGIS或者ArcGIS，QGIS免费且够用。打开之后重点看三件事：几何类型、坐标参考系、属性字段。

几何类型决定了这个shp能不能直接用来建路网。路网数据通常是线状的（LineString或MultiLineString），如果是面状（Polygon）的，那可能是道路用地范围而不是中心线，需要先提取中心线。点状的就更不用说了，那是节点数据，得先连成线。

坐标参考系是第二个关键。shp文件可能用的是地理坐标系（比如WGS84，单位是度），也可能是投影坐标系（比如各种UTM带，单位是米）。sumo和osm都更习惯处理经纬度坐标，所以如果你的shp是投影坐标，后面转换时要做一次坐标变换。我一般会在QGIS里先确认CRS，如果是投影坐标，就先用"另存为"功能转成EPSG:4326（WGS84地理坐标系），这样后续处理最省心。

属性字段决定了你能保留多少信息。路网shp里常见的字段有：道路名称、道路等级、车道数、限速、单行道标志等。这些字段在转osm的时候，需要映射到osm的标签体系里。比如你的"道路等级"字段里写着"主干道"，那对应osm的highway标签应该是"trunk"或"primary"；写着"次干道"可能对应"secondary"。这个映射关系你得提前想清楚，不然后面转出来的osm会丢失大量语义信息。

2.2 字段映射表：shp属性到osm标签的对应关系

这一步是整条链路里最容易被忽视、但影响最大的环节。osm的道路标签体系有一套约定俗成的规范，sumo的netconvert在读取osm时，就是靠这些标签来判断道路类型、车道数、优先级等。如果你转出来的osm里所有道路都是默认标签，那netconvert就只能靠猜，结果往往惨不忍睹。

下面这张表是我在实际项目中总结的常用映射关系，你可以根据自己的数据情况调整：

shp字段示例	shp值示例	osm标签	osm值	说明
道路等级	高速/快速路	highway	motorway	最高等级，sumo中优先级最高
道路等级	主干道	highway	trunk/primary	城市主要骨架道路
道路等级	次干道	highway	secondary	城市一般道路
道路等级	支路	highway	tertiary/residential	小区或街区内部道路
车道数	4	lanes	4	直接对应车道数量
限速	60	maxspeed	60	单位默认km/h
单行道	是/1	oneway	yes	单向通行
道路名称	XX路	name	XX路	保留名称便于识别

这个映射不是死的。比如你的数据里没有"道路等级"字段，只有"道路宽度"，那你可以根据宽度来推断等级：宽度大于30米算主干道，15到30米算次干道，小于15米算支路。这种推断虽然粗糙，但比全部用默认值强得多。

注意：osm的maxspeed标签默认单位是km/h，如果你的shp里限速单位是m/s或者mph，一定要先换算。我见过有人直接把30mph写成30，结果仿真出来的车慢得像蜗牛。

2.3 拓扑检查：断线、重叠、悬挂点

shp数据最常见的问题就是拓扑错误。道路线之间该连的地方没连上，不该连的地方又粘在一起。这些问题在GIS软件里可能看不出来，但转到osm再进sumo之后，就会变成断头路、异常连接或者孤岛路网。

我一般会在QGIS里做三件事：第一，用"拓扑检查器"找出悬挂点（dangling nodes），也就是线的端点没有和其他线连接的地方；第二，检查重叠线，两条线如果完全重合或者部分重合，会导致osm里出现重复道路；第三，检查自相交，一条线自己和自己交叉，这在立交桥数据里很常见，需要区分是平面交叉还是立体交叉。

处理这些问题没有捷径，就是手工修。悬挂点要么延伸线让它连上，要么删掉多余的短头。重叠线要合并。自相交如果是立交，需要在osm里用layer标签区分上下层，否则sumo会认为它们是平面交叉，导致车辆在立交桥上"撞车"。

3. shp转osm：工具选择与实操细节

3.1 为什么我最终选了JOSM而不是在线转换

shp转osm有好几条路可走。有人用在线转换工具，上传shp下载osm，简单是简单，但问题很多：字段映射不可控、大文件传不上去、数据隐私没保障。也有人用ogr2ogr命令行，功能强大但学习曲线陡，而且它转出来的osm标签需要额外处理。

我最后稳定用的是JOSM + OpenData插件。JOSM本来是OpenStreetMap的编辑器，但它的OpenData插件可以直接打开shp文件，然后你再另存为osm格式。这个方案的好处是：你可以在JOSM里直观地看到转换后的道路，手工调整标签，修复拓扑问题，然后再导出。整个过程是可视化的，心里有底。

具体操作步骤：打开JOSM，点"编辑"菜单里的"首选项"，在"插件"选项卡里搜索"opendata"并安装，重启JOSM。然后"文件"→"打开"，文件类型选"ESRI Shapefile"，选中你的shp。加载进来之后，你会看到道路线显示在地图上。这时候别急着导出，先检查一下标签。

3.2 在JOSM里批量修改标签的技巧

JOSM的搜索功能非常强大，可以用来批量选中的道路然后统一改标签。比如你想把所有"道路等级=主干道"的线选中，就在搜索框里输入"道路等级"="主干道"，回车，这些线就会被高亮选中。然后你在右侧的"标签/成员"面板里，把highway标签设成primary。

这里有个小技巧：如果你的shp字段名是中文，JOSM可能显示乱码。解决办法是在QGIS里先把字段名改成英文，或者用JOSM的"标签重命名"功能批量改。我一般会在QGIS里先导出一份字段名为英文的shp，再进JOSM处理，省去很多麻烦。

还有一个坑：JOSM默认会把shp的所有字段都转成osm标签，包括一些你不需要的字段（比如FID、面积、周长）。这些冗余标签会让osm文件变大，也可能干扰netconvert的判断。你可以在JOSM里用搜索-highway选中所有没有highway标签的线（理论上不应该有），或者导出前用"编辑"→"批量修改标签"删掉不需要的字段。

3.3 导出osm时的关键设置

在JOSM里导出osm，点"文件"→"另存为"，格式选".osm"。这里有个细节：JOSM默认导出的是XML格式的osm，这是对的，sumo的netconvert能直接读。但你要注意，导出的时候不要勾选"保存为压缩格式"（.osm.gz），虽然netconvert也支持gz，但调试的时候看不了内容，不方便。

导出之后，我强烈建议你用文本编辑器打开osm文件看一眼。重点看三件事：第一，<way>标签里有没有highway标签；第二，lanes标签的值是不是合理；第三，oneway标签有没有正确设置。如果发现大量way缺少highway标签，说明你的字段映射没做对，需要回JOSM重新处理。

提示：osm文件本质上是XML，你可以用grep命令快速统计各类标签的数量。比如grep -c 'highway="primary"' your.osm就能数出有多少条primary道路。这个技巧在验证转换结果时非常有用。

4. osm导入sumo：netconvert参数详解与路网生成

4.1 netconvert的基本命令与必选参数

有了osm文件，接下来就是把它转成sumo能用的net.xml。核心工具是netconvert，这是sumo自带的一个命令行程序。最基本的命令长这样：

netconvert --osm-files your.osm -o your.net.xml

这一行命令就能跑，但跑出来的路网往往不能用。为什么？因为netconvert默认会做很多"猜测"：它猜你的道路怎么连接、猜车道怎么分配、猜交叉口怎么处理。猜对了是运气，猜错了是常态。

所以实际项目中，我一般会用一组更完整的参数：

netconvert \ --osm-files your.osm \ --output-file your.net.xml \ --geometry.remove \ --ramps.guess \ --junctions.join \ --tls.guess-signals \ --tls.discard-simple \ --no-turnarounds \ --offset.disable-normalization \ --lefthand false

每个参数都有它的用意，下面我逐个解释。

4.2 那些让路网"能用"的关键参数

--geometry.remove：这个参数会移除几何上的冗余点。osm里的道路线往往有很多中间点，这些点对仿真来说没有意义，反而增加计算量。移除之后路网更简洁。

--ramps.guess：自动识别匝道。如果你的路网里有高速出入口，这个参数能帮netconvert判断哪些是匝道，从而正确处理连接关系。没有这个参数，匝道可能被当成普通道路，导致连接错误。

--junctions.join：合并距离很近的交叉口。现实中一个大的十字路口，在osm里可能被拆成好几个小节点。这个参数会把它们合并成一个逻辑交叉口，避免sumo里出现一堆莫名其妙的短路段。

--tls.guess-signals和--tls.discard-simple：这两个参数配合使用，让netconvert根据osm里的信号灯标签来生成交通信号灯，同时丢弃那些不完整的信号灯信息。如果你的osm里没有信号灯数据，这两个参数不会起作用，但加上也无妨。

--no-turnarounds：禁止掉头。在很多仿真场景里，我们不需要车辆在路口掉头，这个参数可以简化路网逻辑。当然，如果你的场景需要掉头，就去掉这个参数。

--offset.disable-normalization：禁止坐标归一化。sumo默认会把路网坐标平移到一个以原点为中心的范围，这个参数保持原始坐标。如果你后续要和其他地理数据对齐，这个参数很重要。

--lefthand false：指定右侧通行。国内是右侧通行，所以设false。如果你的数据是左侧通行地区，设true。

4.3 转换后的验证：怎么判断路网"对了"

netconvert跑完之后，别急着开仿真。先用sumo自带的netedit打开net.xml看一眼。netedit是sumo的图形化路网编辑器，能直观显示路网结构。

重点检查这几个地方：第一，连通性。随便选一条路，看它能不能通过交叉口连到其他路上。如果发现大量孤立的道路片段，说明拓扑有问题。第二，车道数。看看主要道路的车道数是不是和你预期的一致。如果所有路都是1车道，说明lanes标签没生效。第三，交叉口。看看交叉口的连接关系是否合理，有没有出现车辆"飞过"交叉口的情况。

我还会用netconvert的一个辅助功能来检查：netconvert --sumo-net-file your.net.xml --plain-output-prefix check。这个命令会把net.xml拆成几个纯文本文件（节点、边、连接关系），你可以用文本编辑器打开看细节。特别是连接关系文件，能看出每个交叉口的具体转向逻辑。

5. 踩坑实录：那些让我熬夜的典型问题

5.1 断头路：osm里看着连着，sumo里却是孤岛

这是最常见的问题。在JOSM里看，两条路明明端点重合，但转到sumo之后，它们就是不连通。原因通常是：两条路的端点虽然坐标相同，但在osm里它们是两个独立的节点（node），没有共享同一个node ID。netconvert在构建拓扑时，只认共享节点，不认坐标重合。

解决办法有两个：一是在JOSM里用"合并节点"功能，把重合的端点合并成一个节点；二是在netconvert里加--junctions.join参数，让它自动合并距离很近的节点。我一般两个都用，先手工合并明显的，再用参数兜底。

5.2 车道数丢失：为什么我的四车道变成了单车道

osm里的lanes标签必须是纯数字，不能带单位。我见过有人写成lanes="4车道"，netconvert直接忽略。还有人写成lanes="4;3"，想表示可变车道，但netconvert不认这种语法。

另外，lanes标签要加在way上，不是加在node上。如果你在JOSM里选中了一条路，但标签面板里显示的是节点的标签，那说明你选中的是节点而不是线。要确保选中整条线（双击线），再添加lanes标签。

还有一个隐藏问题：如果你的osm里同时有lanes和lanes:forward、lanes:backward标签，netconvert会优先使用后者。如果你只想简单指定总车道数，就只用lanes，别加forward/backward。

5.3 立交桥变平面交叉：车辆在桥上"打架"

立交桥在osm里需要用layer标签区分上下层。比如上层道路layer=1，下层道路layer=0或layer=-1。如果没有这个标签，netconvert会认为两条路在同一平面，生成平面交叉口，结果就是桥上桥下的车互相干扰。

在JOSM里设置layer很简单：选中立交桥的上层道路，在标签面板里添加layer=1。注意，layer的值可以是负数，表示地下通道。另外，bridge=yes和tunnel=yes标签也有助于netconvert判断，但它们不能替代layer。

5.4 坐标偏移：路网跑到几千公里外去了

这个问题通常出现在shp本身是投影坐标、但转换时没有做坐标变换的情况下。投影坐标的单位是米，数值很大（比如几百万），osm和sumo会把这些数值当成经纬度，结果路网就跑到地球另一端去了。

解决办法：在QGIS里先把shp转成EPSG:4326，再进JOSM。如果你已经转好了osm但发现坐标不对，可以在netconvert里用--offset.x和--offset.y手动平移，但这只是补救，不如从源头解决。

6. 从能跑到好用：路网优化的几个进阶思路

6.1 用netedit手工微调交叉口

自动生成的路网，交叉口逻辑往往不够精细。比如一个复杂的十字路口，netconvert可能生成了过多的连接线，导致车辆在路口内频繁变道。这时候可以用netedit打开net.xml，手工删除多余的连接，或者调整连接的车道对应关系。

netedit里有个"连接模式"，可以直观看到每个交叉口的连接线。你可以选中不需要的连接线删掉，也可以拖动连接线改变它的起止车道。这个工作很繁琐，但对于关键交叉口，花时间调一调是值得的。

6.2 补充交通需求：让路网"活"起来

路网建好只是第一步，没有车流的sumo场景就是个空壳。下一步是生成交通需求，也就是车流的出发地、目的地、出发时间。sumo提供了几种方式：可以用duarouter根据OD矩阵生成路线，也可以用randomTrips.py脚本生成随机车流。

我一般先用randomTrips.py快速生成一批车流，看看路网能不能跑通。命令大概是：

python randomTrips.py -n your.net.xml -o trips.xml -b 0 -e 3600 -p 1.5

这个命令会生成从0秒到3600秒、平均每1.5秒发一辆车的出行需求。然后配合duarouter生成路线文件，最后在sumo-gui里加载net.xml和rou.xml就能看到车跑了。

6.3 性能优化：大路网怎么跑得快

如果你的路网很大（比如整个城市），sumo跑起来会很慢。几个优化方向：第一，用--geometry.remove和--junctions.join减少路网复杂度；第二，在netconvert里加--no-internal-links，去掉交叉口内部的连接线，能显著减少计算量；第三，仿真时用--step-length调大仿真步长，比如从默认的1秒调到2秒，速度会快很多，但精度会下降。

还有一个技巧：如果你的仿真不需要GUI，就用命令行版的sumo而不是sumo-gui，速度能快好几倍。调试的时候用GUI，跑数据的时候用命令行，这是我惯用的做法。

7. 一些零散但有用的经验

关于shp字段的命名，我建议全部用英文小写，不要用中文，也不要用空格。中文在某些工具里会乱码，空格在命令行里要转义，都是麻烦。用下划线连接单词，比如road_class、lane_num、speed_limit，清晰又安全。

关于osm文件的版本，JOSM导出的osm默认是0.6版本，netconvert完全支持。但如果你从其他渠道拿到osm，注意看一下文件头的version属性，太老的版本可能需要先升级。

关于netconvert的日志，它跑的时候会输出很多信息，包括警告和错误。别忽略这些日志，尤其是warning。很多问题在warning里已经提示了，比如"junction is not connected"或者"edge has no lanes"。我习惯把日志重定向到文件里，跑完之后用grep搜warning和error，逐个排查。

最后说一个心态问题：从shp到sumo这条路，第一次走大概率不会一次成功。路网数据的问题千奇百怪，每个数据集都有自己的脾气。我的建议是先用一小块区域试通整个流程，确认方法可行之后，再处理完整数据。这样即使出问题，排查范围也小得多。我在实际项目中，通常会把整个流程脚本化，shp预处理、JOSM转换、netconvert参数、验证步骤都写成脚本或者文档，下次遇到新数据直接套用，效率能提升不少。