PrefaceDeveloping complex so ware for over a decade with a heterogeneous group of engineers and scientists, each with widely di erent skill levels and expertise across multiple locations around the world, requires dedication and mechanisms unusual for a university environment. This book is one of these mechanisms. It allows us, collectively, to take stock and present a coherent state-of-the-system: for us and anyone interested in this approach. It highlights basics for the student who wants to undertake a small rst research project as part of his or her degree, provides a description of the main functionalities, in detail, for the engineer setting up MATSim (MultiAgent Transport Simulation) to conduct a policy analysis and, nally, ts the approach into the theoretical background of complex systems in computer science and physics.The choice of the additional e-book format is an advantage, as it allows us to keep the book upto-date with future chapters, revisions and, if necessary, errata. Equally importantly it allows you, the readers, to select those sections relevant to your needs.The book comes at an important time for the system; for most of the rst decade, its use was limited to the original developers and users in Berlin and Zürich. It is now much more widely consulted around the world, as we document in the chapter summarizing contributions on scenarios so far.Scenario: This term will occur again and again. In MATSim context, it is de ned as the combination of speci c agent populations, their initial plans and activity locations (home, work, education), the network and facilities where, and on which, they compete in time-space for their slots and modules, i.e., behavioral dimensions, which they can adjust during their search for equilibrium. Within these scenarios, the user can experiment and explore with behavioral utility function parameters, with the sampling rate of the population between 1 % and 100 %, with algorithm parameters, e.g., the share of the sample engaged in replanning in any iteration, or behavioral dimensions or exact settings necessary to avoid gridlock due to the tra c ow dynamics. The creation of a scenario is a substantial e ort, and the framework makes a number of tools available to accelerate it: population synthesizers, network editors, network converters between popular formats and the MATSim representation, e.g., OSM (OpenStreetMap) or GTFS (General Transit Feed Speci cation), semi-automatic network matching to join information, among others.A large group of colleagues has been involved and many of them are contributors to this book; this is a list of those involved, other than ourselves, in Berlin, Singapore and Zürich. Additional contributors are mentioned as authors of their respective chapters in this book. We hope to acknowledge the contributions of more colleagues from other groups in future versions of this book and in the so ware.Special thanks go to a number of people who greatly helped improving this book beyond their own chapters. Benjamin Kickhöfer's deep knowledge of ...