Repast Quick Start Guide

This guide is intended to provide a minimal set of instructions to download, install, and run Repast Simphony and provide the user with a path towards developing their own models. The Repast FAQ, Repast Downloads, and Repast Documentation pages all provide more detailed documentation. To get started using Repast Simphony, please follow these steps:

Step 1: Download and install Repast Simphony

  • Download and install the latest version of Repast Simphony from the downloads page.

Step 2: Run Repast and import example models

  • After Repast is installed, run the "Repast Simphony" shortcut for Windows or macOS, or simply run Eclipse for Linux. A blank workspace is set to the ReLogo perspective as shown below. Eclipse perspectives provide customized layouts of the Eclipse window components depending on the type of activity the user is doing. The ReLogo perspective provides a minimal view of development components.



  • From the window menu, select File -> Import Repast Repast Examples. The model import dialog will appear with the list of available Repast models if the Windows or macOS installer was used. Linux users should download the demo models separately (found here) and browse to the saved location.
    Select the "Zombies_Demo" at the bottom of the list of available models and click the Finish button. This will import the Zombies demo that is described in the ReLogo Getting Started tutorial.



  • Run the ReLogo zombies demo model. Click the black Run selection icon next to the Run button and select "Zombies_Demo Model" as shown in the following figure. The Repast runtime window will appear. (You may see warnings in the Eclipse console due to changes in Java 9 or later, but they have no impact on the model code, performance, or reliability, and can be safely ignored.)



  • Click the Initialize Run button to initialize the model. A number of slider buttons will appear in the User Panel from which model parameters can be adjusted. Click the model Play button and the display will initialize and run until the pre-determined stop time (when no humans are left), at which point the model run will finish.



Step 3: Select a Repast tutorial depending on your modeling needs and programming level

Guide User Experience Level or Application
ReLogo Getting Started If you are new to Repast or if your programming background is limited. ReLogo is a computer language designed to help you quickly create simpler agent-based models.
Repast Java Getting Started After you are acquainted with Repast or if you know the Java computer language and you want to develop more complex Repast Simphony models.
Repast Statecharts After you are acquainted with Repast and you would like to start developing more complex agent-behavior logic using a visual programming editor instead of writing code.
Repast Batch Runs Getting Started After you are acquainted with Repast and you would like to start running multiple individual model runs at the same time for parameter sweep and exploration.
EMEWS After you are acquainted with Repast and you would like to use the Extreme-scale Model Exploration with Swift (EMEWS) framework for large-scale experiments with agent-based models.
Repast Simphony Reference A comprehensive reference manual and code cookbook for Repast Simphony.