pt-mapping

Map transit schedules to road networks using the pt2matsim library.

1|Updated Oct 21, 2025
One-click install
npx skills add https://github.com/ro9er117911/matsim-example-project --skill pt-mapping
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pt-mapping
Source: https://github.com/ro9er117911/matsim-example-project/tree/main/.claude/skills/matsim-skill/2-pt-mapping
Command: npx skills add https://github.com/ro9er117911/matsim-example-project --skill pt-mapping

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps map transit schedules onto road networks with the pt2matsim mapper, troubleshoot mapping issues, and optimize parameters for different network scenarios.

Core Features & Use Cases

  • Network mapping: Project transit stops to the nearest network links or create artificial links when needed.
  • Pruning & validation: Validate stop counts, link counts, and network multimodality for reliable PT routing.
  • Use Case: You have stops spread across a city; this skill configures the mapping to produce realistic PT paths or quick artificial mode for fast testing.

Quick Start

Start with a minimal artificial mapping by setting maxLinkCandidateDistance to 0.0, run PublicTransitMapper with an artificial config, and verify that output files network-with-pt.xml.gz and transitSchedule-mapped.xml.gz are created.

Frequently Asked Questions about pt-mapping

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I map transit schedules onto a road network?

Map transit schedules to road networks using pt2matsim by configuring the PublicTransitMapper with your transit schedule and network files, setting parameters like maxLinkCandidateDistance, and running the mapper to produce network-with-pt.xml.gz and transitSchedule-mapped.xml.gz outputs.

What's the difference between artificial and real mode for PT mapping?

Artificial mode creates direct links between stops for fast testing without strict network topology; real mode projects stops onto existing network links for realistic PT routing. Choose artificial mode for quick validation, real mode for production scenarios.

Why is my transit mapping slow or producing disconnections?

Slow mappings or disconnections typically stem from network preparation issues, oversized maxLinkCandidateDistance values, or nLinkThreshold settings. Troubleshoot by validating stop and link counts, adjusting candidateDistanceMultiplier, and tuning maxTravelCostFactor for your network's topology.

Can I use pt2matsim for metro, bus, and rail networks together?

Yes, pt2matsim handles multimodal transport networks mapping stops and routes for metro, bus, rail, and mixed-mode scenarios. Configure networkRouter and numOfThreads parameters to optimize mapping performance across your mode mix.

What prerequisites do I need before mapping PT to a network?

Prerequisites include a validated transit schedule file, a reconstructed road network, and configured pt2matsim parameters. Start by validating stop and link counts, then prepare your network and set maxLinkCandidateDistance appropriately for your scenario.