World Chaos Map Docs
docs.worldchaosmap.app
Live docs
Open map

How the map thinks

Turning global events into live pressure signals.

The system ingests incidents, filters them into signals, and computes a live pressure score for each country. Scores summarize recent pressure, not future predictions.

โš™๏ธ 6-hour cadence ๐Ÿงฎ 0โ€“100 pressure score ๐Ÿงญ 4 pressure bands
System snapshot
Signal types
Security, civil unrest, disaster, political
Decay window
30 days
Confidence inputs
Coverage depth + source reliability + recency

Pipeline walkthrough

Each ingest run passes through a fixed sequence: parse โ†’ normalize โ†’ relevance filters โ†’ deduplicate โ†’ cluster โ†’ score โ†’ publish. The highlight bar above tracks the active stage as you scroll.

Signal intake RSS + structured feeds.
Normalization Country/event tagging.
Dedup + cluster Reduce duplication bias.
Score + publish Confidence-aware scoring.

What the system observes

  • Country-tagged incidents from trusted feeds and local sources.
  • Event metadata: time, category, severity, and source reliability.
  • Explicit location signals when available (city/region).

What counts as a signal

Pressure is built from severity, category, source reliability, and timeโ€”no single factor dominates the outcome.

Severity
1โ€“5 scale from incident metadata.
1 = minor
5 = severe
Category weight
Baseline impact by event type.
Security 1.0
Civil unrest 0.9
Disaster 0.8
Political 0.7
Source reliability
Weighted by track record and verification.
Verified 1.0
Established 0.8
New 0.6
Time decay
Recent events weigh more than older ones.
0โ€“7 days โ‰ˆ 1.0
7โ€“30 days โ†’ 0.2

What is filtered out

  • Duplicates across sources for the same event.
  • Events without enough metadata to score reliably.
  • Out-of-window incidents beyond the 30-day memory.

Filtering exists to keep the map responsive and reduce false amplification.

Why silence โ‰  safety

Silence usually implies a lack of signal, not a lack of pressure.

Pressure, not prediction

This system does not forecast future events. Pressure scores are summaries of recent incident density and intensity.

Limits (by design)

  • Not predictive. No future forecasting.
  • Not real-time ground truth. Feeds are delayed and incomplete.
  • Not a replacement for local context and on-the-ground reporting.

Time & decay

Decay is memory fading. Old events matter less each cycle.

Now
30 days ago

The decay floor prevents permanent inflation, even in high-activity regions.

Technical details
TimeDecay = max(0.2, e ^ (-AgeDays / 10))

Why pressure scores jump

๐Ÿงฑ
Clustered events
When multiple incidents arrive together, the map shifts quickly.
๐Ÿชถ
Single events
One event rarely changes a band unless it is severe or sustained.
๐Ÿ›ฐ๏ธ
Source reliability
Higher reliability increases the weight of each signal.

Sudden color changes usually indicate clustered recent events, not long-term deterioration.

Worked example

๐Ÿ“จ
Incident arrives: severe unrest in a major city.
๐Ÿ“
Severity evaluated: 4/5.
๐Ÿ›ฐ๏ธ
Source reliability applied: established feed (0.8).
โฑ๏ธ
Time decay applied: 2 days old โ†’ near full weight.
๐Ÿงฎ
Pressure score updates: prior score decays + new impact.
๐ŸŽฏ
Band resolved: score lands in Moderate.

Interactive score example

Toggle severity, recency, and reliability to see how the pressure score responds.

Severity 6.0
Recency 10d
Reliability 70%
Pressure score
42

Bands and confidence

Stable: 0โ€“25
Moderate: 26โ€“50
Unstable: 51โ€“75
Severe: 76โ€“100

Confidence reflects coverage, not calm. Low confidence means the system cannot see clearly.

Step-by-step pipeline

  1. Events: load incident reports and country registry.
  2. Signals: deduplicate and discard low-information items.
  3. Pressure: calculate impact per incident and sum it.
  4. Decay: fade previous pressure to prevent stale inflation.
  5. Score: update pressure score and clamp between 0โ€“100.
  6. Band: map to Stable, Moderate, Unstable, Severe.
Pressure scores are designed for monitoring and trend awareness. They are not predictions.

Back to the live map

Explore the current pressure view and recent incident summaries.