MATSim Simulation Execution

Configure and run MATSim simulations via CLI, Maven, or GUI.

1|Updated Oct 21, 2025
One-click install
npx skills add https://github.com/ro9er117911/matsim-example-project --skill matsim-simulation-execution
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: MATSim Simulation Execution
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-execution

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Running and configuring MATSim simulations can be intricate, often leading to convergence issues or errors. This Skill simplifies the entire simulation lifecycle, from validating configurations to monitoring execution and troubleshooting common problems, ensuring your transport models run smoothly and deliver reliable results.

Core Features & Use Cases

  • Streamlined Configuration: Set up MATSim simulations with optimal parameters for various scenarios (e.g., PT-only, multimodal).
  • Flexible Execution: Execute simulations via command-line, Maven, or GUI, with parameter overrides.
  • Comprehensive Troubleshooting: Diagnose and resolve common problems like non-convergence, out-of-memory errors, or stuck agents.
  • Use Case: You've prepared your network and population. Use this Skill to run a MATSim simulation for 10 iterations using scenarios/equil/config.xml, saving the output to a new directory test_output to avoid overwriting previous results.

Quick Start

Run a MATSim simulation using 'scenarios/equil/config.xml', setting the last iteration to 10 and the output directory to 'test_output', overwriting if it exists.

Frequently Asked Questions about MATSim Simulation Execution

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

FAQPage Schema
How do I run a MATSim simulation from the command line?

Run MATSim simulations via CLI by executing the JAR file with your config.xml file and optional parameter overrides. The Skill handles configuration validation, execution method selection (CLI, Maven, or GUI), and real-time monitoring to ensure your transport model completes successfully.

What causes MATSim simulations to fail or not converge?

Non-convergence, out-of-memory errors, and stuck agents are common MATSim issues stemming from misconfigured parameters or invalid input data. This Skill diagnoses and resolves these problems through configuration validation against defaultConfig.xml guidance and comprehensive troubleshooting during execution.

How do I validate my MATSim configuration before running a simulation?

Validate MATSim configurations by checking config.xml existence and XML validity against schema requirements. This Skill performs input validation and verifies adherence to defaultConfig.xml standards before execution to prevent runtime failures.

Can I override MATSim parameters when executing a simulation?

Yes, MATSim simulations support parameter overrides at execution time across CLI, Maven, and GUI methods. This Skill applies your parameter changes, validates the configuration, and monitors convergence and results for both PT-only and multimodal transport scenarios.

How do I verify MATSim simulation results after execution completes?

Post-run validation checks convergence metrics and result integrity for your transport model output. This Skill performs real-time monitoring during execution and verifies results across PT-only and multimodal scenarios to ensure reliable, usable simulation data.

What's the best way to manage multiple MATSim simulation runs without overwriting results?

Designate separate output directories for each MATSim simulation run to preserve previous results. This Skill supports flexible output directory configuration and overwrite control, allowing you to organize and compare multiple transport model executions systematically.