MATSim requires at least Java 1.6.

To run large simulations, you'll need a high-end machine with enough RAM and disk space. The provided examples are smaller ones and should run on all machines where Java 1.6 is running.

More details can be found at the System Requirements page for MATSim.

If you run a simulation with the standard MATSim Controler, a log-file should be created inside the output directory of your simulation.

 If you call "java -cp .../matsim.jar ...", it is the directory where you execute this command.

In Eclipse, it is normally the root of the project. So if you have a project called MATSim, and a directory "inputs" inside this, you need to say "./inputs/...".

Java may try to access some X11 features when creating image buffers for graphs. If your server doesn't have X11 installed, this leads to Exceptions like

Exception in thread "main" java.lang.NoClassDefFoundError:
Could not initialize class sun.awt.X11GraphicsEnvironment

Try starting MATSim with the Java option -Djava.awt.headless=true set, i.e.:

java -Djava.awt.headless=true -cp MATSim.jar org.matsim.run.Controler config.xml

There are two types of places in the config file that need to be filled out correctly for this:

• The "SYSTEM" path needs to be a local path (filename), not a http path.
• The config-parameter "localDTDBase" in the config-module "global" must be correctly set to a local directory containing copies of the DTDs. Usually, this is "./dtd/". If this parameter is correctly set and no internet connection is available, MATSim tries to find the DTD files specified in the SYSTEM-path in XML files in that directory.

If your computer has a working network connection, but no internet access, there can be some delays when parsing XML files due to connection time outs. Java thinks that when a network connection is active, that than the internet should also be reachable and waits several seconds before giving up.

Most pages feature, near the bottom, a button "printer-friendly version", which does not only print the page itself, but also all pages "underneath" it in the hierarchy.