Getting Started

Installation & Setup

System Requirements

  • Java 11 (or later)
  • Repast Simphony 2.11.0
  • Eclipse IDE (recommended for development)
  • R 4.0+ (for analysis scripts)

See System Requirements for detailed setup instructions.

Project Structure

single-facility/
├── src/                          # Java source code
│   ├── agents/                   # Agent classes (Person, DischargedPatient)
│   ├── agentcontainers/          # Container classes (Facility, Region)
│   ├── builders/                 # Simulation builder (SingleFacilityBuilder)
│   ├── disease/                  # Disease logic (Disease, FacilityOutbreak, PersonDisease)
│   ├── processes/                # Process definitions (Admission)
│   ├── data/                     # Data classes (PatientData)
│   └── utils/                    # Utility classes (TimeUtils, Chooser)
│
├── single-facility.rs/           # Repast Simphony configuration
│   ├── parameters.xml            # Parameter defaults
│   ├── batch_params.xml          # Batch run configuration
│   └── scenario.xml              # Scenario definition
│
├── launchers/                    # Eclipse launch configurations
│   └── single-facility Model.launch
│
├── new_analysis/                 # R analysis scripts
└── Makefile                      # Build targets

Running Your First Simulation

Eclipse

  1. Import Project
    • File → Import → General → Existing Projects into Workspace
    • Select the project directory
    • Click Finish
  2. Launch and Run
    • Use the green run button with the drop-down to select the single-run version of the launcher
    • Configure the parameters in the parameters tab, initialize the simulation and run it
    • Look in the root folder for the txt files
Note

TODO: make a animated gif example of running the single-run

Manual Parameter Configuration

Configure parameters through the Repast runtime or by manually editing the parameters file.

Parameters File

Edit single-facility.rs/parameters.xml to configure:

<!-- Disease transmission -->
<parameter name="longTermAcuteCareBeta" value="0.0615"/>

<!-- Importation probability -->
<parameter name="importationRate" value="0.206"/>

<!-- Decolonization timing -->
<parameter name="avgDecolonizationTime" value="387"/>

<!-- Surveillance -->
<parameter name="daysBetweenTests" value="14"/>
<parameter name="admissionSurveillanceAdherence" value="0.911"/>
<parameter name="midstaySurveillanceAdherence" value="0.954"/>

<!-- Isolation effectiveness -->
<parameter name="isolationEffectiveness" value="0.5"/>

See Parameters for complete documentation.

Understanding Output

After running a simulation, check:

  • Batch-run Mode:
    • simulation_results.demo.txt - Summary statistics and aggregates - One row per iteration
  • Single-run Mode:
    • daily_population_stats.demo.txt Time series data (one row per day)
    • admissions.demo.txt - Patient admission events
    • transmissions.demo.txt - Transmission events (if enabled)
    • clinicalDetection.demo.txt - Clinical detection events
    • decolonization.demo.txt - Decolonization outcomes
    • surveillance.demo.txt - Surveillance test results

Next Steps

Troubleshooting

No Launchers Availble in Repast IDE

  • make sure the name of the local project is the same as the name of the scenario folder, without the .rs.
  • find the appropriate launcher in the launchers folder. Right click and “run as..”

Resources