? What is this tool?

The Evacuation Readiness & Uncertainty Simulator is a conceptual research instrument developed as part of a PhD project on civilian protection in armed conflict. It models the problem of assigning evacuee groups to destinations under conditions of incomplete, unreliable, or absent field intelligence — a situation routinely faced by humanitarian organisations and civilian protection actors.

The tool does not use real locations or real data. All scenarios are generated synthetically from a seeded random number generator, meaning any scenario can be reproduced exactly by entering the same seed. This reproducibility is a core requirement for academic peer review.

This is a demonstration tool, not an operational decision-support system. Outputs are not suitable for real evacuation planning without calibration against empirical field data.

1 The core problem

When civilians need to be evacuated in a conflict zone, decision-makers must identify suitable destinations quickly. But the information available is almost always incomplete: some sites may not have been assessed, assessments may be outdated, and field reports may be unreliable. The central question this tool explores is:

How does uncertainty in field intelligence degrade the quality of evacuation decisions — and where would better information have the highest impact?

The simulator makes this abstract problem concrete by quantifying uncertainty, propagating it through a readiness model, and running Monte Carlo simulations to show how likely a given assignment is to succeed given what we know (and don't know).

2 How to use it

The header bar contains all the controls you need to generate and explore scenarios.

Seed
A number that determines the entire randomly-generated scenario. The same seed always produces the same scenario — change it to explore a different situation.
Destinations (N)
How many potential evacuation sites to generate (2–16). More destinations increases complexity and the chance of viable alternatives.
Evacuee groups (M)
How many distinct evacuee groups to simulate (1–8). Each group is drawn from a set of IHL-grounded archetypes with different vulnerability levels and needs.
Field Uncertainty slider
Scales how much trust to place in field assessments. At 0% all reports are taken at face value; at 100% assessments are almost meaningless. Watch how success rates drop as uncertainty rises.

Click Generate Scenario to create a new random scenario. Adjust the uncertainty slider at any time — it recalculates instantly without regenerating the underlying data.

3 Readiness factors

Each destination is assessed across seven factors. Two are designated gatekeepers — they receive double weight and, if blocked, impose a hard cap of 20% readiness regardless of how strong other factors are. This reflects the IHL principle that a destination that is physically dangerous or legally inaccessible cannot be made viable by good food supply or willing hosts.

FactorTypeWhy it matters
Security ★ GKGatekeeperCivilians cannot be moved to a site under active threat — the most fundamental IHL access criterion.
Authority consent ★ GKGatekeeperLegal and political access; without host authority agreement, any movement is legally precarious.
WillingnessStandardCommunity receptiveness; forced co-habitation can itself generate protection risks.
CapacityStandardPhysical accommodation space relative to group size.
ShelterStandardQuality and availability of shelter structures.
Food & waterStandardSustenance supply chains and access to safe water.
Medical capacityStandardAvailability of medical services; weighted additionally in the assignment score for groups with medical or mobility needs.

Each factor is assessed as one of four statuses:

Operational
Fully functional. Score scales with how confident we are in the assessment.
Partial
Degraded function — present but unreliable. Half the operational score, confidence-adjusted.
Blocked
Non-functional or access denied. Score = 0. Gatekeepers trigger the readiness cap.
Unknown
Not assessed. Treated conservatively: a known unknown scores better than an unknown unknown.

4 The uncertainty model

Uncertainty operates at two levels in the model:

The model encodes a key epistemic distinction: a known unknown is less dangerous than an unknown unknown. If a factor is assessed as "Unknown" and we are highly confident in that assessment (we are sure we don't know), it scores higher than the same status with low confidence (we are not even sure our ignorance is accurate). This reflects the real-world asymmetry where a field team that explicitly reports "we could not assess food supply" provides more actionable information than a report produced under conditions where the team itself was unreliable.

5 Monte Carlo simulation

For each (evacuee group, destination) pair, the tool runs 100 Monte Carlo iterations. In each run, every factor's assessed status is subjected to a perturbation test: with a probability proportional to uncertainty, the status shifts one level (e.g. operational → partial). This simulates the distribution of what real conditions might look like given our imperfect knowledge.

A run counts as a success only if all three conditions are met:

The success rate is the proportion of runs that succeed. The standard deviation tells you how volatile the outcome is — high SD means small real-world changes could flip the result, which is itself a warning signal for decision-makers.

The uncertainty curve chart in the simulator shows how each group's success rate degrades as uncertainty rises from 0% to 100%, making it easy to identify which assignments are robust versus fragile under information degradation.

6 Assignment algorithm

Each evacuee group is assigned to the destination with the highest composite score, combining four components:

The weights reflect humanitarian evacuation priority ordering: protection quality first, physical fit second, operational burden third, population-specific needs as a tiebreaker. Assignments are made independently — no capacity contention is modelled between groups, which is a noted limitation.

7 The research argument

The simulator is designed to support a specific thesis argument: that AI-assisted field assessment would improve outcome predictability in civilian evacuation planning. The tool makes this argument legible by showing:

The practical implication is that limited intelligence-gathering or AI-assisted verification capacity (satellite imagery analysis, sensor fusion, field report NLP) should be directed toward high-weight unknown factors first — not spread evenly — to maximise decision quality under time and resource pressure.

All random values use a seeded generator — Math.random() is never called. Every scenario is fully reproducible by seed number, satisfying the peer-review reproducibility standard for computational research.