Class UrbanEvolutionEngine

java.lang.Object

org.episteme.social.architecture.UrbanEvolutionEngine

public final class UrbanEvolutionEngine
extends Object

Historical simulation engine that models the architectural and demographic evolution of a city over centuries. It tracks transitions between architectural styles, building construction cycles, and urban prosperity.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	UrbanEvolutionEngine.ArchitecturalStyle	Major architectural styles and their defining characteristics.
static final record	UrbanEvolutionEngine.Building	Represents a single notable building within the city.
static enum	UrbanEvolutionEngine.BuildingType	Functional classes for building simulation.
static final record	UrbanEvolutionEngine.CityParameters	Controls the simulation dynamics.
static final record	UrbanEvolutionEngine.CityState	Snapshots the complete state of a city at a specific moment in history.
static enum	UrbanEvolutionEngine.HistoricalPeriod	Defined historical periods for urban categorization.

Method Summary

Modifier and Type	Method	Description
static String	describeEvolution(List<UrbanEvolutionEngine.CityState> timeline)	Generates a structural summary of city evolution over the simulated timeline.
static List<UrbanEvolutionEngine.CityState>	simulateEvolution(String cityName, int startYear, int endYear, int intervalYears, UrbanEvolutionEngine.CityParameters params)	Simulates the evolution of a city over a defined time span.

Methods inherited from class Object

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

Method Details

simulateEvolution

public static List<UrbanEvolutionEngine.CityState> simulateEvolution(String cityName,
 int startYear,
 int endYear,
 int intervalYears,
 UrbanEvolutionEngine.CityParameters params)

Simulates the evolution of a city over a defined time span.

Parameters:

cityName - name of the city

startYear - beginning of simulation

endYear - end of simulation

intervalYears - time step in years

params - simulation parameters

Returns:

timeline of CityState snapshots

describeEvolution

public static String describeEvolution(List<UrbanEvolutionEngine.CityState> timeline)

Generates a structural summary of city evolution over the simulated timeline.

Parameters:

timeline - the simulated evolution history

Returns:

a multi-line human-readable summary