概述

MATSim 提供了一个用于运行和实现大规模基于代理的交通模拟的工具箱。该工具箱由多个模块组成，这些模块可以组合使用，也可以单独使用。用户可以用自己的实现替换某些模块，以测试自己工作的特定方面。目前，MATSim 提供了需求建模、基于代理的出行模拟（交通流模拟）、重新规划、用于迭代运行模拟的控制器，以及分析各模块生成输出的方法。

所有可用扩展的列表都可以在 contribs 文件夹中找到。

更多信息请访问项目官网：http://www.matsim.org/。

问题

您有任何疑问吗？请访问 https://matsim.org/faq，看看是否已有解答。如果没有，请提出新问题。

开发

问题跟踪器位于 https://matsim.org/issuetracker。

通过以下命令进行构建（请从本目录而非任何子目录执行）：

mvn package -DskipTests

如果您只想安装核心部分，可以运行：

mvn install --also-make --projects matsim

二进制文件

发布版本（包括基于 PR 的发布和每周发布）以及快照可以在 https://repo.matsim.org/ 找到。

一个包含完整 pom.xml 的示例项目，可以帮助您开始自己的项目，可在 https://github.com/matsim-org/matsim-example-project 找到。

代码示例则位于 https://github.com/matsim-org/matsim-code-examples。

MATSim-Libs 快速上手指南

MATSim 是一个用于运行和实现大规模基于智能体（Agent-based）的交通模拟工具箱。它包含需求建模、交通流模拟、重规划及结果分析等核心模块，支持模块化组合与自定义扩展。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux、macOS 或 Windows
• Java 开发工具包 (JDK)：建议安装 JDK 11 或更高版本（具体版本取决于您使用的 MATSim 发行版，通常推荐 LTS 版本）。
• 构建工具：必须安装 Apache Maven (3.6+)。
  • 验证安装：在终端运行 mvn -v。
• 网络环境：构建过程需要从 Maven 中央仓库及 MATSim 专属仓库下载依赖。
  • 国内加速建议：若下载缓慢，建议配置 Maven 的 settings.xml 使用国内镜像（如阿里云镜像），并在 pom.xml 中确保已添加 MATSim 仓库地址 (https://repo.matsim.org)。

安装步骤

本项目采用源码编译方式构建。请克隆仓库后，在项目根目录执行以下命令。

1. 编译整个项目（跳过测试以加快速度）

如果您需要构建所有模块：

mvn package -DskipTests

2. 仅安装核心模块

如果您只关注核心功能 (matsim 模块) 并希望将其安装到本地 Maven 仓库供其他项目调用：

mvn install --also-make --projects matsim

注意：请在项目根目录运行上述命令，不要进入子目录。

基本使用

MATSim 通常作为依赖库集成到您自己的 Java 项目中，而非直接作为命令行工具运行。以下是启动一个新项目的标准流程：

1. 参考示例项目

官方提供了完整的项目模板和代码示例，强烈建议以此为基础开始开发：

• 项目模板（含完整的 pom.xml 配置）： https://github.com/matsim-org/matsim-example-project
• 代码示例集： https://github.com/matsim-org/matsim-code-examples

2. 配置依赖

在您自己项目的 pom.xml 中，确保添加 MATSim 仓库并引入核心依赖。示例如下：

<repositories>
    <repository>
        <id>matsim</id>
        <url>https://repo.matsim.org/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>org.matsim</groupId>
        <artifactId>matsim</artifactId>
        <version>YOUR_VERSION_HERE</version> <!-- 请替换为最新版本号 -->
    </dependency>
</dependencies>

3. 运行模拟

集成依赖后，您可以编写 Java 代码来配置控制器（Controller）、加载场景（Scenario）并运行迭代模拟。最简单的入口通常是继承或实例化 Controler 类，加载配置文件后调用 run() 方法。

详细 API 用法请参考上述“代码示例集”中的具体实现。