? 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.
📋 Copy link
Writes the current seed, N, M, and uncertainty level into the page URL as query parameters, then copies that URL to your clipboard. Paste it anywhere (email, thesis notes, a co-author's chat) and opening it reproduces this exact scenario — no need to manually re-enter the four values.

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. Three 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 principle that a destination that is physically dangerous, legally inaccessible, or whose host community has explicitly refused to receive evacuees cannot be made viable by good food supply or shelter.

FactorTypeWhy it matters
Security ★ GKGatekeeperCivilians cannot be moved to a site under active threat — the most fundamental access criterion.
Authority consent ★ GKGatekeeperLegal and political access; without host authority agreement, any movement is legally precarious.
Willingness ★ GKGatekeeperCommunity receptiveness; forced co-habitation can itself generate protection risks. A confirmed refusal ("Unwilling") is as disqualifying as a blocked checkpoint, so it is treated as a gatekeeper rather than a standard factor.
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. For Willingness specifically, this status is labelled "Unwilling" in the tool — a confirmed host refusal.
Unknown
Not assessed. Treated conservatively: a known unknown scores better than an unknown unknown. Distinct from "Unwilling" — this is an intelligence gap, not a confirmed exclusion.

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 500 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. Groups are sorted by urgency (immediate → urgent → can-wait) and assigned greedily in that order, deducting each assigned group's size from the destination's remaining capacity before the next group is placed. This models real capacity contention between groups — a group can be left UNASSIGNED if every viable destination is already full, which is flagged in red in the outcome table and alerts panel.

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.

8 Data sources & references

This tool uses no real-world datasets. Every destination, evacuee group, and factor status is generated synthetically by the seeded RNG described in §5 — there is no live feed, import, or historical case data behind any number on screen. What the standards below inform is parameter design: which factors exist, which are gatekeepers, and where thresholds like the 40% viability floor or the 3.5m²/person shelter norm come from.

SourceUsed for
Park & Miller (1988), CACM 31(10)Park-Miller LCG — the seeded random number generator underlying every synthetic value
ICRC (2013), Violence and the use of forceIHL framework grounding the Security factor and civilian protection obligations generally
Additional Protocol I (1977), Art. 12 & 58Protection of medical units (Medical capacity factor) and precautions against attack (Security factor)
IASC (2007) GuidelinesHost-authority consent framework grounding the Authority consent factor
SPHERE Handbook (2018, 4th ed.)Minimum humanitarian standards — 3.5m²/person shelter, 15L/person/day water — referenced in the Shelter and Food & water factors
UNHCR (2007), Handbook for Emergencies (3rd ed.)Source of the 40% minimum readiness viability threshold used in the Monte Carlo success criteria
Full citation detail, including page references and how each source maps to specific parameters, is in Evacuation_Simulator_Methodology.docx §14 (References) in the project repository. This in-app list is a summary of that document, checked against it directly — if the two ever disagree, the methodology doc is authoritative.