Class CounterfactualSimulator

java.lang.Object

org.episteme.social.history.CounterfactualSimulator

public final class CounterfactualSimulator
extends Object

Simulates counterfactual historical scenarios ("What if?"). Analyzes historical contingency and potential alternative timelines based on causal chains. Modernized to use Real for internal weights and divergence factors.

Since:

1.0

Version:

1.2

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	CounterfactualSimulator.ContingencyEvent	Internal representation of a historical event with its causal dependencies.
static final record	CounterfactualSimulator.CounterfactualScenario	Defines a specific counterfactual scenario starting from a divergence point.
static final record	CounterfactualSimulator.SimulationResult	The analytical results of a counterfactual simulation.

Method Summary

Modifier and Type	Method	Description
static void	addEvent(CounterfactualSimulator.ContingencyEvent event)	Registers a contingency event in the simulation database.
static Real	calculateContingency(String eventId)	Calculates the historical contingency score of a specific event.
static void	loadSampleData()	Populates the database with sample historical dataset for simulation testing.
static CounterfactualSimulator.SimulationResult	simulate(CounterfactualSimulator.CounterfactualScenario scenario)	Simulates the cascade effects of a counterfactual scenario.
static List<String>	suggestCounterfactuals(String eventId)	Suggests plausible counterfactual outcomes.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

addEvent

public static void addEvent(CounterfactualSimulator.ContingencyEvent event)

Registers a contingency event in the simulation database.

simulate

public static CounterfactualSimulator.SimulationResult simulate(CounterfactualSimulator.CounterfactualScenario scenario)

Simulates the cascade effects of a counterfactual scenario.

calculateContingency

public static Real calculateContingency(String eventId)

Calculates the historical contingency score of a specific event.

suggestCounterfactuals

public static List<String> suggestCounterfactuals(String eventId)

Suggests plausible counterfactual outcomes.

loadSampleData

public static void loadSampleData()

Populates the database with sample historical dataset for simulation testing.