Home

MC

MC is a command-line tool for working with MATSim config files. Naturally, the inputs consist of partially or fully formed config files in specific formats, or individual parameter choices to insert into existing configs. Outputs are mostly MATSim config files.

1. What is MC and what can you achieve with it?

MC facilitates easier creation, inspection, alteration and comparison of configuration files that match the format required by MATSim. There are also methods for converting between file formats. As a CLI, the methods are individually discoverable and detailed so this will be only a high-level overview.

2. Input data expectations

The requirements for input data depend on which function is being used, but in general the main supported file formats are:

• .xml
• .json

There are also commands that accept a combination of these formats plus literal values that are interpolated into the provided file.

The build command has the most extensive data requirements, as it combines multiple literal inputs with files at provided paths to create a complete MATSim config. At input_dir location, there is the expectation to already exist an:

• attributes.xml
• population.xml
• transitschedule.xml
• transitVehicles.xml
• network.xml

that also adhere to the formats MATSim expects. More information on the network, schedule and vehicles inputs can be found here.

3. Output data expectations

For the build, fill and gen commands, the output will be a valid MATSim config.xml