SwissRailRaptor PT Configuration & Troubleshooting

Diagnose SwissRailRaptor PT routing configuration issues in MATSim simulations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Configuring SwissRailRaptor for realistic public transit routing in MATSim can be challenging, often leading to agents not boarding or transfers failing. This Skill provides comprehensive guidance to correctly set up SwissRailRaptor, diagnose routing problems, and ensure your PT agents move efficiently through the network.

Core Features & Use Cases

  • Optimal Configuration: Set up the SwissRailRaptor algorithm for optimal public transit routing, including intermodal access/egress.
  • PT Routing Troubleshooting: Diagnose problems like zero boarding events, failed transfers, or agents preferring other modes.
  • Transfer Station Validation: Ensure transfer stations are correctly configured with stopAreaId for seamless agent movement.
  • Use Case: Your MATSim agents aren't using public transit or aren't transferring correctly. Use this Skill to diagnose why PT agents aren't boarding vehicles, verify your useIntermodalAccessEgress setting, and ensure transfer stations have matching stopAreaIds.

Quick Start

Configure SwissRailRaptor for a PT-only scenario with simple population plans, setting useIntermodalAccessEgress to false and transfer penalties to zero for initial testing.

Frequently Asked Questions about SwissRailRaptor PT Configuration & Troubleshooting

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

FAQPage Schema
Why aren't my MATSim agents boarding public transit in SwissRailRaptor?

Agents fail to board when the transit module isn't activated, SwissRailRaptor parameters are misconfigured, or stopAreaId consistency is broken across transfer stations. Validate transit module activation, verify SwissRailRaptor algorithm settings, and ensure all transfer stations share matching stopAreaId values for seamless boarding and transfers.

How do I configure SwissRailRaptor for multimodal and intermodal access/egress routing?

Set useIntermodalAccessEgress to true in your SwissRailRaptor configuration, define access and egress modes, and configure transfer penalties appropriately. Start with a PT-only scenario using false and zero penalties to validate core routing before enabling intermodal features.

What causes transfer failures between PT stops in MATSim simulations?

Transfer failures occur when transfer stations lack consistent stopAreaId configuration or when transfer penalties are set too high, blocking agent movement between routes. Diagnose by validating that all stops in a transfer station share the same stopAreaId and adjusting transfer penalty parameters for your scenario.

How do I troubleshoot zero boarding events in my public transit simulation?

Zero boarding events indicate configuration gaps: verify the transit module is activated, check that SwissRailRaptor is enabled, confirm useIntermodalAccessEgress matches your scenario design, and validate that stopAreaId consistency holds across all transfer stations using debugging and test-run validation.

Can I use SwissRailRaptor for PT-only scenarios without intermodal access/egress?

Yes. SwissRailRaptor supports PT-only routing by setting useIntermodalAccessEgress to false and transfer penalties to zero for initial testing. This simplifies validation and allows you to verify core routing logic before enabling multimodal features.

What are the key differences between SwissRailRaptor routing and teleported PT modes?

SwissRailRaptor provides realistic network-based PT routing with boarding events and transfers; teleported modes skip network simulation. Use SwissRailRaptor when agents must follow actual transit schedules, stops, and transfer constraints; use teleported modes for rapid prototyping when PT detail isn't critical.