Welcome to GoTrackIt’s documentation!

作者：唐铠

邮箱：794568794@qq.com，tangkai@zhechengdata.com

项目源码：项目GitHub主页

GoTrackIt 是一个基于隐马尔可夫模型实现的地图匹配包, 通过概率图建模的方式将车辆的GPS数据匹配到道路路网, 获取车辆的标准化时空轨迹, 有效支撑车辆导航、浮动车轨迹溯源、路况计算、公交车监测等应用场景.

Note

这个项目正处在频繁的升级迭代期, 当前版本v0.2.4

文档内容

• 💡简介
  • 1. 关于gotrackit
  • 2. 地图匹配问题
  • 3. 隐马尔可夫模型
  • 4. 相关视频教程
• 🚀 如何使用
  • 1. 安装gotrackit
  • 2. 算法包概览
    • 2.1. 模块概览
      • 2.1.1. GPS数据生产
      • 2.1.2. 路网生产
      • 2.1.3. 地图匹配
      • 2.1.4. kepler可视化
    • 2.2. 数据要求
      • 2.2.1. 路网数据
        • (1) 路网-点层
        • (2) 路网-线层
        • (3) 点层、线层关联关系
      • 2.2.2. GPS定位数据
  • 3. GPS数据生产
    • 3.1. 所需数据
    • 3.2. 代码示例
  • 4. 路网生产
    • 4.1. 指定矩形区域, 基于矩形区域随机构造OD, 获取路网
    • 4.2. 自定义面域文件, 基于自定义区域随机构造OD, 获取路网
    • 4.3. 自定义面域文件, 基于多个自定义区域构造区域-区域的OD, 获取路网
    • 4.4. 基于路径源文件, 获取路网
    • 4.5. 基于自定义OD, 进行路径请求获取路网
    • 4.6. 清洗你的路网线层数据
    • 4.7. 基于已有路网线层, 生产点层
    • 4.8. 基于已有标准路网, 检查路网的联通性并进行修复
    • 4.9. 路段划分
    • 4.10. id重映射
    • 4.11. 路网路段、节点重塑
    • 4.12. 处理环路和相同(from_node，to_node)的路段
    • 4.13. 坐标转换(如有需要)
  • 5. 地图匹配
    • 5.1. 所需数据
    • 5.2. 常规匹配代码示例
    • 5.3. 启用路径预存储进行加速
    • 5.4. 启用多核进行并行匹配
    • 5.5. 匹配结果可视化
    • 5.6. 匹配结果不正确的调参方法
      • 5.6.1. 程序提示-预处理后GPS点不足两个,无法匹配
      • 5.6.2. 在html可视化结果中看到匹配路径不连续
  • 6. 常见报错以及解决方案
    • 6.1. 构建net对象错误报坐标系不匹配
    • 6.2. 使用jupyter报net对象无planar_crs属性
    • 6.3. pyogrio.errors.FieldError
    • 6.4. shapely库警告
• 🐧 地图匹配流程
  • 1. 清洗GPS数据
    • 1.1. 坐标系核查
    • 1.2. 基本数据清洗
    • 1.3. 行程切分
  • 2. 校核路网数据
    • 2.1. 认识路网数据
    • 2.2 路网文件的常见存储类型
    • 2.3. 认识连通性
  • 3. 依据GPS数据质量合理选择gotrackit的匹配参数
• 🔎类方法汇总
  • 1. Net类
    • 1.1. Net类初始化
      • Net
    • 1.2. Net类方法
      • create_computational_net
        • Net.create_computational_net
    • 1.3. Net类属性
      • crs
  • 2. NetReverse类
    • 2.1. NetReverse类初始化
      • NetReverse
    • 2.2. NetReverse类方法
      • (1) generate_net_from_request
        • NetReverse.generate_net_from_request
      • (2) generate_net_from_pickle
        • NetReverse.generate_net_from_pickle
      • (3) create_node_from_link
        • NetReverse.create_node_from_link
      • (4) topology_optimization
        • NetReverse.topology_optimization
      • (5) modify_conn
        • NetReverse.modify_conn
      • (4) redivide_link_node
        • NetReverse.redivide_link_node
  • 3. HiddenMarkov类
  • 4. GpsPointsGdf类
    • 4.1. GpsPointsGdf类初始化
      • GpsPointsGdf
    • 4.2. GpsPointsGdf类方法
      • (1) lower_frequency
      • (2) rolling_average
      • (3) get_gps_array_buffer
  • 5. Viterbi类
• 🖥️迭代记录
  • 1. v0.1.1
  • 2. v0.1.3
  • 3. v0.1.5
  • 4. v0.1.6
  • 5. v0.1.7
  • 6. v0.1.8
  • 7. v0.1.9
  • 8. v0.2.0
  • 9. v0.2.1
  • 10. v0.2.2
  • 11. v0.2.3
  • 12. v0.2.4