matsim-simulation

Configure and run MATSim simulations with validated XML parameters.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps configure and run MATSim simulations with proper parameters and troubleshoot execution issues.

Core Features & Use Cases

  • Validate configuration files (config.xml) and ensure referenced resources exist.
  • Review defaultConfig.xml for critical parameters (iterations, coordinate system, outputs).
  • Choose execution method (Command-line JAR, Maven exec) and run with sane defaults for quick tests.
  • Monitor progress and validate results (scorestats.png, modestats.csv, logs) to ensure convergence.

Quick Start

  • Build the MATSim project (./mvnw clean package) and run with the default config.xml for a quick test, or execute with a small lastIteration (e.g., 5-10) to iterate rapidly and verify outputs in the designated outputDirectory.

Frequently Asked Questions about matsim-simulation

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

FAQPage Schema
How do I configure and run a MATSim simulation?

Configure a MATSim simulation by validating your config.xml file, checking critical parameters like lastIteration, coordinateSystem, and outputDirectory against defaultConfig.xml, then execute via CLI JAR, Maven, or GUI. Monitor progress through log output and verify convergence using generated scorestats.png and modestats.csv files.

What parameters are required to run MATSim simulations successfully?

Required MATSim parameters include lastIteration, coordinateSystem, outputDirectory, overwriteFiles, networkModes, and useTransit settings. Validate these fields in config.xml before execution; consult defaultConfig.xml for safe defaults to ensure successful simulation runs.

How do I troubleshoot MATSim simulation convergence issues?

Troubleshoot convergence by validating XML syntax and parameter values, verifying referenced resources exist, checking scorestats.png and modestats.csv outputs, and reviewing logs for errors. Start with a small lastIteration (5-10) to iterate rapidly and identify configuration problems early.

Can I run MATSim simulations for both PT-only and multimodal scenarios?

Yes, this Skill supports configuring and running MATSim across PT-only and multimodal scenarios by validating parameters specific to each mode, verifying networkModes and useTransit settings, and validating results for both scenario types.

What execution methods are available for running MATSim?

MATSim simulations can be executed via Command-line JAR, Maven exec, or GUI. Choose based on your workflow; CLI and Maven support automated runs and monitoring, while GUI provides interactive configuration and progress tracking.

How do I validate MATSim configuration files and referenced resources?

Validate configuration by enforcing XML validity, verifying all critical fields are present and correct, ensuring referenced input files (network, population, transit) exist in specified paths, and checking that outputDirectory is writable before execution.