chairemobilite/transition

Transition

概述

Transition是一种现代交通规划新方法，提供Node/React Web应用，用于公共交通及替代交通方式的建模、模拟与规划。该应用集成路由引擎与空间数据处理能力，支持交通网络分析、路线计算及可达性评估，适用于交通规划与城市研究领域。

核心功能与特性

• 多模式交通建模：支持公共交通、步行、骑行、驾驶等多种交通方式的网络建模
• 路线模拟与计算：基于OSRM（道路网络）和trRouting（公共交通）引擎的路线规划
• 空间数据处理：集成PostgreSQL/PostGIS进行地理数据存储与空间分析
• 自定义区域配置：支持通过GeoJSON多边形定义分析区域，自动下载与处理OpenStreetMap数据
• 性能优化：通过Rust编写的json2capnp缓存服务提升大量交通数据处理效率

非Node依赖

• PostgreSQL 10+ 及 https://postgis.net/%EF%BC%9A%E7%A9%BA%E9%97%B4%E6%95%B0%E6%8D%AE%E5%BA%93%E6%94%AF%E6%8C%81
• OSRM：开放街道图路由引擎，用于步行、骑行、驾驶等模式的路线计算
• trRouting：开源公共交通路由引擎，支持公共交通网络的起终点路线及可达性分析
• yarn：包管理工具（https://classic.yarnpkg.com/en/docs/install/#debian-stable 或 https://classic.yarnpkg.com/en/docs/install/#mac-stable 版本）
• Rust：用于运行json2capnp缓存服务，提升数据处理性能

安装与使用

独立桌面安装

对于无需手动安装所有依赖仅需运行Transition的用户，可按照使用Docker Desktop设置Transition的分步说明操作。

使用Docker部署

构建镜像

shell
docker build -t testtransition .

可将testtransition替换为自定义镜像名称，更换后需同步更新相关命令及compose文件。

注意：默认项目目录为/app/examples/runtime，缓存服务在此路径启动。如需修改，需调整Dockerfile第68行的json2capnp缓存目录参数。

使用docker-compose运行

仓库提供示例docker-compose.yml文件，可启动Transition前端及PostGIS数据库等依赖服务：

shell
docker-compose up -d

首次运行配置

首次启动需执行数据库初始化命令：

shell
# 数据库设置
docker exec transition_transition-www_1 yarn setup

# 更新数据库schema
docker exec transition_transition-www_1 yarn migrate

# 创建管理员用户（交互式）
docker exec -it transition_transition-www_1 yarn create-user

# 重启服务
docker-compose restart

加载OSRM道路网络数据

路线计算需OSRM引擎及道路网络数据，步骤如下：

1. 准备区域多边形：通过geojson.io创建分析区域的GeoJSON多边形文件

2. 导入并处理数据：

shell
# 复制多边形文件到容器
docker cp /本地路径/区域多边形.geojson transition_transition-www_1:/app/examples/runtime/imports/polygon.geojson

# 下载OSM网络数据
docker exec -it transition_transition-www_1 yarn node --max-old-space-size=4096 /app/packages/chaire-lib-backend/lib/scripts/osrm/downloadOsmNetworkData.task.js --polygon-file /app/examples/runtime/imports/polygon.geojson

# 处理OSM数据（供OSRM使用）
docker exec -it transition_transition-www_1 yarn node --max-old-space-size=4096 /app/packages/chaire-lib-backend/lib/scripts/osrm/prepareOsmNetworkData.task.js

配置说明

环境配置文件

1. 复制示例环境文件并修改：

shell
cp .env.example .env

2. 关键配置项：
   • PG_CONNECTION_STRING_PREFIX：PostgreSQL连接字符串，格式为postgres://用户名:密码@主机:端口/
   • EXPRESS_SESSION_SECRET_KEY：随机字符串（无空格），用于会话加密
   • PROJECT_CONFIG：项目配置文件路径，默认指向示例配置

项目配置文件（config.js）

核心配置参数：

• mapDefaultCenter：地图默认中心点坐标（经纬度），通常设为分析区域中心
• projectDirectory：运行时文件（用户数据、OSRM文件、日志等）存储路径
• OSRM服务器配置：支持本地自动启动或连接外部服务，示例（步行模式）：

javascript
walking: {
    port: 5001,          // 端口号
    host: "https://external.osrm-server",  // 外部服务器地址
    autoStart: false,    // 禁用本地自动启动
    enabled: true        // 启用该模式
}

启动应用

服务器启动命令

• 正常启动：yarn start
• 调试模式：yarn start:debug（输出额外调试信息）
• 追踪模式：yarn start:tracing（需根目录tracing.js配置文件，基于OpenTelemetry）

访问应用

启动后，通过浏览器访问 http://localhost:8080 进入登录页面。

贡献

参见CONTRIBUTING.md

许可证

https://app.fossa.com/api/projects/git%2Bgithub.com%2Fchairemobilite%2Ftransition.svg?type=large](https://app.fossa.com/projects/git%2Bgithub.com%2Fchairemobilite%2Ftransition?ref=badge_large)