ODMatrix Viewer

HELP CENTER

ODMatrix Viewer 使用说明

这个页面汇总了导入数据、交互操作、CSV 格式要求与常见问题。内容基于当前项目实现编写，可直接作为项目内置帮助页使用。

打开主视图 编辑分类配置

快速开始

  1. 点击 Load CSV Dataset 导入 OD 数据文件。
  2. 如需空间背景，点击 Import Base Map (PNG/JPG) 导入底图。
  3. 使用左侧面板调整时间、网格精度、地图范围与图层透明度。
  4. 使用右侧面板切换 O / D 图层和出行原因分类。
建议先完成 CSV 导入，再调整网格与筛选参数，这样更容易观察不同配置下的聚合结果。

交互操作

  • 鼠标滚轮：缩放视图。
  • 左键拖拽：平移地图与热力图。
  • 双击网格：锁定单个聚焦格，查看与该格相关的流动分布。
  • Shift + 左键拖拽：框选一个区域，查看与该区域相关的整体流动。
  • Esc：清除单格或区域聚焦。

面板说明

左侧面板

  • Base Map Opacity：控制底图透明度。
  • Heatmap Opacity：控制热力图透明度。
  • Map Size (Tiles)：设置参与分析的地图范围。
  • Grid Resolution：设置网格粒度，当前换算约为 1u = 8m。
  • Time Slice：按小时查看数据。
  • Show All Day (24h)：切换为全天聚合模式。

右侧面板

  • Origin (O) 与 Destination (D) 可独立开关。
  • 出行原因分类可多选，用于筛除不关心的类别。

CSV 格式

解析器会跳过首行表头，并按固定列位读取关键字段。

列索引 用途
1 时间值，预期为 0.0 ~ 1.0，会换算到 0 ~ 23 小时
3 出行原因原始值
5 Origin X
6 Origin Y / Z
7 Destination X
8 Destination Y / Z
当前 CSV 解析是轻量实现，采用简单的逗号分割，不支持复杂引号转义或字段内嵌逗号。

高级配置

进入 Advanced Settings 页面后，可以编辑出行原因映射 JSON。默认配置来自项目内置文件，用户保存后的结果会写入浏览器本地存储。

  • 修改只影响当前浏览器环境。
  • 恢复默认会清空本地覆盖配置。
  • 颜色和分类数量都会随着 JSON 配置动态变化。

常见问题

为什么导入后没有显示颜色？

通常是因为坐标超出当前地图范围、筛选条件全部关闭，或当前小时切片没有命中任何记录。

为什么全天模式下时间滑块不可用？

这是预期行为。启用全天模式后会聚合全部 24 小时数据，因此单小时滑块会被禁用。

为什么设置页改了分类但别的浏览器没变化？

因为配置保存在当前浏览器的 LocalStorage，不会自动同步到其他浏览器或仓库文件。

已知限制

  • 这是纯前端工具，没有后端存储、登录或协作能力。
  • 空间坐标使用项目内部世界坐标，不是 GIS 经纬度。
  • 底图只支持手动导入图片，不包含自动地理配准。