Network Validation & Troubleshooting

Validate MATSim network.xml.gz files and diagnose common network issues.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensuring MATSim networks are valid and error-free is crucial but often complex. This Skill automates the validation, diagnosis, and cleaning of your transport networks, preventing simulation failures and saving you hours of manual debugging.

Core Features & Use Cases

  • Automated Network Inspection: Automatically inspect network files for integrity and consistency.
  • Diagnose Common Issues: Identify problems like disconnected components, zero-length links, and mode mismatches.
  • Prepare for PT Mapping: Clean and optimize networks specifically for public transit integration.
  • Use Case: Before running a public transit simulation, use this Skill to automatically clean your network.xml.gz file, ensuring all subway links have the 'pt' mode and removing any disconnected components that could cause errors.

Quick Start

Validate your MATSim network file 'network.xml.gz' and clean it for public transit mapping, saving the cleaned network as 'network-cleaned.xml.gz'.

Frequently Asked Questions about Network Validation & Troubleshooting

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

FAQPage Schema
How do I validate a MATSim network file before running a simulation?

Network validation checks your network.xml.gz file for integrity issues like disconnected components, zero-length links, and mode mismatches that would cause simulation failures. This Skill automates inspection of node counts, link bounds, coordinate consistency, and PT mode assignment to catch errors before you run the simulation.

What common network issues can I diagnose in MATSim?

Common issues include disconnected components, zero-length links, PT mode mismatches on subway/rail links, mode configuration inconsistencies between network and config files, and invalid coordinate bounds. This Skill identifies these problems automatically so you can fix them without manual debugging.

Can I prepare my MATSim network specifically for public transit mapping?

Yes. This Skill cleans and optimizes networks for PT integration by ensuring all subway and rail links have the 'pt' mode assigned, removing disconnected components, and validating population-link references. It outputs a cleaned network.xml.gz ready for public transit simulation.

Does this work with compressed network files like network.xml.gz?

Yes. This Skill accepts MATSim networks packaged as network.xml.gz and performs validation checks on compressed files directly, then outputs a cleaned network-cleaned.xml.gz without requiring manual decompression.

What checks does this Skill perform on my network?

Validation includes node and link counts, coordinate bounds verification, zero-length link detection, PT mode assignment on transit links, config-network mode consistency, and disconnected component identification. These operational checks ensure your network meets MATSim simulation requirements.

Do I need to manually fix network errors after validation?

This Skill automates diagnosis and cleaning, removing many common issues automatically and outputting a corrected network file. You receive a detailed report of detected problems and the cleaned network ready to use, reducing manual debugging time.