Crate legalis_sim 

Legalis-Sim: Simulation engine for Legalis-RS.

This crate provides an ECS-like simulation engine for testing legal statutes against populations of agents.

Features

Core Simulation

• Population-based simulation with parallel execution
• Realistic demographic population generation
• Time-step based temporal simulation
• Retroactive law application
• Statute effective date handling
• Agent lifecycle management
• Behavioral modeling with compliance probability
• Inter-agent relationships and organizations
• Property and asset management

Analysis & Comparison

• Statute comparison and A/B testing
• Statistical analysis (distribution, correlation, time-series)
• Comprehensive metrics collection
• Sensitivity analysis and cohort tracking

Visualization

• GraphViz DOT format export for relationship graphs
• D3.js compatible JSON output for interactive visualizations
• Geographic data export for map visualizations
• Interactive dashboard data generation

Performance & Scalability

• Batch processing for large populations
• Memory-efficient streaming mode
• Entity pooling and recycling
• Lazy attribute evaluation
• Optimized work distribution across threads
• Parallel execution with work-stealing scheduler
• Memory-mapped population storage

Incremental Simulation

• Dirty tracking for efficient re-simulation
• Delta-based updates for change tracking
• Checkpoint and restore functionality
• Simulation replay for debugging

Persistence & Recovery

• File-based checkpoint persistence (save/load to disk)
• Resume from failure detection and recovery
• Automatic periodic checkpointing
• Checkpoint validation and integrity checking

Testing & Validation

• Stress testing for memory limits
• Simulation verification tests
• Reproducible random testing

Advanced Features (2025-Q4)

• Monte Carlo simulation for probabilistic analysis
• Economic modeling (tax revenue, compliance costs, cost-benefit analysis)
• Network effects and social influence modeling
• Policy optimization (gradient-free, multi-objective)
• Calibration and validation tools
• Impact assessment and equity analysis
• Event-driven simulation and hybrid approaches
• Risk analysis (VaR, CVaR, risk metrics, tail risk)
• Portfolio analysis (efficient frontier, diversification, correlation)
• Scenario planning (scenario trees, probability weighting, sensitivity)
• Forecasting (linear trends, moving average, exponential smoothing)
• Agent Intelligence (reinforcement learning, game theory, BDI, bounded rationality)
• Demographic Modeling (census data, mortality/fertility rates, migration, households, income mobility)
• Policy Analysis (multi-objective optimization, sensitivity analysis, stakeholder impacts, distributional analysis)
• Validation Framework (empirical validation, cross-validation, confidence intervals, uncertainty quantification)
• Domain-Specific Models (tax systems, benefit eligibility, regulatory compliance, court case prediction, legislative forecasting)

GPU Acceleration (v0.2.0)

• CUDA backend for NVIDIA GPU acceleration
• OpenCL backend for cross-platform GPU support
• WebGPU backend for browser-based simulations
• GPU-optimized condition evaluation kernels
• Tensor-based population representations
• Memory pooling for efficient GPU memory management

Distributed Simulation (v0.2.1)

• Multi-node simulation framework with message passing
• Partition-based entity distribution strategies
• Cross-node communication abstractions
• Dynamic load balancing with multiple strategies
• Fault-tolerant coordination and synchronization

Agent-Based Modeling 2.0 (v0.2.2)

• Deep reinforcement learning (DQN, Actor-Critic)
• Multi-agent coordination protocols (Contract Net, AMAS)
• Emergent behavior detection
• Social network dynamics
• Cultural evolution modeling

Real-Time Simulation (v0.2.3)

• Streaming simulation updates
• Live parameter adjustment
• Real-time visualization integration
• Simulation pause/resume/rewind
• Breakpoint debugging

Synthetic Data Generation (v0.2.4)

• GAN-based entity generation
• Privacy-preserving synthetic populations (differential privacy)
• Demographic-consistent data synthesis
• Realistic income/wealth distributions (log-normal, Pareto, exponential)
• Geographic-aware population generation with clustering

Economic Simulation Extensions (v0.2.5)

• DSGE (Dynamic Stochastic General Equilibrium) models
• Input-output economic modeling (Leontief matrices)
• Financial contagion simulation with network effects
• Market microstructure modeling (order books, market depth)
• Behavioral economics (prospect theory, hyperbolic discounting, anchoring)

Healthcare Simulation (v0.2.6)

• Epidemiological models (SIR, SEIR)
• Healthcare capacity simulation with facilities and resources
• Vaccine distribution optimization with multiple strategies
• Health policy impact analysis (lockdowns, mask mandates, social distancing)
• Social determinants of health modeling

Environmental Simulation (v0.2.7)

• Climate impact modeling with IPCC scenarios
• Natural disaster simulations (hurricanes, earthquakes, floods, wildfires, etc.)
• Resource scarcity modeling (water, food, energy, minerals, land)
• Environmental policy simulation (Paris Agreement, Net Zero, Green New Deal)
• Carbon footprint tracking for individuals and populations

Urban Simulation (v0.2.8)

• Traffic and transportation modeling with congestion analysis
• Housing market dynamics with price trends and vacancy rates
• Urban sprawl simulation with land use patterns
• Infrastructure impact analysis with lifecycle costing
• Smart city policy testing with ROI and impact scoring

Integration & API (2025-Q4)

• Simulation-as-a-Service API with job queuing
• Persistent result storage with file-based backend
• Comparison API for analyzing multiple simulations
• Webhook notifications for job completion
• Priority-based job scheduling

Orchestration & Advanced Job Management (2025-Q4)

• Job retry logic with exponential/linear backoff
• Job timeout handling with configurable actions
• Batch job execution with dependency graphs
• Parameter sweep orchestration for sensitivity analysis
• Execution history tracking and statistics

Quantum Simulation (v0.3.0)

• Quantum Monte Carlo methods (variational and diffusion)
• Quantum-inspired optimization algorithms
• Quantum annealing for parameter search
• Hybrid classical-quantum simulations
• Quantum random number generation with multiple measurement bases

Digital Twin Integration (v0.3.1)

• Real-time entity synchronization between physical and digital twins
• IoT data ingestion from sensors and devices
• Predictive maintenance simulation
• Twin-based what-if analysis
• Bidirectional updates between physical and digital entities

Modules

test_seeds

Seeds for reproducible random generation in tests.

Structs

ABTest

A/B test configuration.

AMASCoordinator

Adaptive Multi-Agent System (AMAS) coordinator.

ActorCriticAgent

Actor-Critic agent for policy gradient methods.

AdministrativeCosts

Administrative costs.

AffectedPopulations

Breakdown of affected populations.

AgentMemory

Memory system for agents

AgentMessage

A message sent between agents.

AgentState

Temporal state of an agent.

AnchoringModel

Anchoring and adjustment model

AnnealingResult

Result from quantum annealing optimization.

AntitheticVariates

Variance reduction using antithetic variates.

AttributeDelta

Delta representing a change to an entity attribute

AutoCalibrationConfig

Automated calibration configuration

AutoCalibrationResult

Auto-calibration result

AutoCheckpoint

Auto-checkpoint tracker for periodic checkpointing

BacktestConfig

Historical backtest configuration

BacktestFold

Single backtest fold result

BacktestResult

Backtest result with walk-forward validation

BacktestTimeSeriesPoint

Time series data point for backtesting

BasicStatistics

Basic statistical measures.

BatchConfig

Batch processor configuration

BatchExecutor

Batch job executor

BatchIterator

Batch iterator for processing large populations in chunks

BatchResultRow

A single row in the batch results table.

BatchSimulationResults

Results from batch simulation.

BatchSimulationRunner

Batch simulation runner for executing multiple scenarios efficiently.

BatchStats

Batch execution statistics

BdiAgent

BDI Agent

BehavioralAgent

Agent with behavioral modeling.

BehavioralPopulationBuilder

Builder for creating populations with behavioral profiles.

BehavioralProfile

Behavioral parameters for an agent.

Belief

Belief in BDI architecture

BenefitPreset

Benefit eligibility configuration preset

BidirectionalSync

Bidirectional update manager for twin synchronization.

Bill

Bill definition for legislative forecasting

BootstrapSample

Bootstrap sample for ensemble validation

BoundedRationalityAgent

Bounded rationality decision model

Breakpoint

Breakpoint for debugging.

BreakpointHit

Record of a breakpoint being hit.

CalibrationResult

Calibration result.

CarbonFootprint

Carbon footprint tracker

CaseFactor

Factor that influences case outcome

CensusData

Census data representation for a region

CentralityMetrics

Network centrality metrics.

Checkpoint

Simulation checkpoint for save/restore

CheckpointManager

Checkpoint manager for handling multiple checkpoints

CheckpointStore

File-based checkpoint store

ClimateImpact

Climate impact model for population effects

ClusterCoordinator

Distributed simulation coordinator

Cohort

Cohort definition for grouping entities.

CohortAnalysis

Cohort analysis results.

CohortAnalyzer

Cohort analyzer for population segmentation.

CohortStatuteMetrics

Cohort metrics for a specific statute.

CommunicationNetwork

Agent communication network.

CommunityDetectionResult

Community detection result.

CommunityStats

Community statistics for analysis.

ComparativeRiskAnalysis

Comparative risk analysis between multiple statutes.

ComparisonAPI

API for comparing simulation results

ComplianceAction

Compliance action requirement

ComplianceBurden

Compliance burden analysis.

ComplianceContext

Context for a compliance decision.

ComplianceCost

Compliance cost calculation

ComplianceModel

Agent decision model for compliance.

CompliancePreset

Regulatory compliance configuration preset

ComplianceStats

Population-level compliance statistics.

CompositeForecast

Comprehensive forecast with multiple methods.

ConditionalVaR

Conditional Value at Risk (CVaR), also known as Expected Shortfall.

ConfidenceInterval

Confidence interval

ConfidenceIntervalCalculator

Confidence interval calculator

ConfidenceIntervals

Confidence intervals for simulation metrics.

ConstraintChecker

Constraint satisfaction checker.

ContagionResult

Result of contagion simulation

Contract

A contract between parties.

ContractConditions

Contract-based condition evaluator.

ContractNetProtocol

Contract Net Protocol coordinator.

ContractRegistry

Registry for managing contracts.

Cooperation

Cooperation instance in AMAS.

CorrelationAnalyzer

Correlation analyzer.

CorrelationMatrix

Correlation matrix for statute interactions.

CourtCasePreset

Court case outcome prediction preset

CrossValidationResult

Cross-validation result.

CrossValidator

Cross-validator for model validation.

CulturalAgent

Agent with cultural traits.

CulturalEvolution

Cultural evolution simulator.

D3Graph

D3.js force-directed graph data

D3Link

D3.js compatible link data

D3Node

D3.js compatible node data

DQNAgent

Deep Q-Network agent with experience replay.

DQNExperience

Single experience tuple for replay buffer.

DSGEModel

DSGE (Dynamic Stochastic General Equilibrium) Model

DSGEState

DSGE model state

DashboardData

Dashboard data structure for interactive visualizations

DashboardUpdate

Real-time dashboard update for streaming visualizations

DataPoint

Empirical data point for calibration.

DeltaLog

Delta log for tracking all changes

DemographicConstraint

Demographic constraint for data synthesis

DemographicProfile

Demographic profile for population generation.

DemographicSynthesizer

Demographic-consistent data synthesizer

DependentJob

Job with dependencies

Desire

Desire/Goal in BDI architecture

DifferentialAnalysis

Differential analysis between two sets of metrics.

DiffusionResult

Result of diffusion simulation.

DigitalTwin

Digital twin of a physical entity with real-time synchronization.

DirtyTracker

Tracks which entities have changed and need re-simulation

DisparateImpact

Disparate impact analysis.

DistributedConfig

Distributed simulation coordinator for multi-node execution.

DistributedCoordinator

Distributed simulation coordinator.

DistributedNode

Distributed simulation node

DistributionAnalyzer

Distribution analyzer.

DistributionFit

Statistical distribution fit.

DistributionalImpact

Distributional impact across income/wealth groups.

DiversificationMetrics

Portfolio diversification metrics.

EconomicImpact

Economic impact analysis result.

EconomicImpactSummary

Economic impact summary.

EfficientFrontier

Efficient frontier analysis for statute portfolios.

EligibilityRequirement

Eligibility requirement

EligibilityResult

Result of eligibility check

EmergentBehaviorDetector

Emergent behavior detector.

EmergentPattern

Emergent behavior pattern.

EmpiricalData

Empirical dataset for calibration.

EmpiricalDataPoint

Empirical data point for validation

EmpiricalDataset

Empirical validation dataset

EmpiricalValidator

Empirical validator

EnsembleValidationResult

Ensemble validation result

EnsembleValidator

Ensemble validator using bootstrap aggregating

EntityPartition

Entity partition assignment

EntityPool

Entity pool for recycling entity objects

EntityRecord

Entity record for CSV/JSON import.

EntitySnapshot

Snapshot of entity state at a point in time

EntityTensor

Tensor representation of entity data for GPU processing

EnvironmentalPolicy

Environmental policy intervention

EquityAnalysis

Equity analysis results.

Event

Simulation event.

EventDrivenSimulator

Event-driven simulation engine.

EventLogger

Event logger for debugging.

ExecutionAttempt

Job execution attempt record

ExecutionHistory

Job execution history

ExecutiveSummary

Executive summary of impact assessment.

Experience

Experience entry for episodic memory

ExperienceReplay

Experience replay buffer for DQN training.

ExponentialSmoothingForecast

Exponential smoothing forecast.

FairnessMetrics

Fairness metrics for policy evaluation.

FertilityModel

Fertility rate model

FinancialContagionModel

Financial contagion simulator

FinancialInstitution

Financial institution node for contagion modeling

ForecastPoint

Forecast data point.

FrontierPoint

Efficient frontier point representing a risk-return trade-off.

GANEntityGenerator

GAN-based entity generator for creating synthetic populations

GameTheoreticAgent

Game-theoretic agent

GdpImpactAnalysis

GDP impact analysis from policy changes

GeoDataPoint

Geographic data point for map visualizations

GeographicDistribution

Geographic distribution model

GoodnessOfFit

Goodness-of-fit metrics.

GpuConfig

GPU configuration for simulations

GpuDevice

GPU device information

GpuExecutor

GPU executor for running simulations on GPU

GpuKernel

GPU kernel for condition evaluation

GpuMemoryPool

GPU memory pool for efficient allocation

GraphVizOptions

GraphViz export options

GridSearchOptimizer

Grid search optimizer.

HealthPolicyIntervention

Health policy intervention

HealthcareFacility

Healthcare facility with capacity constraints

HealthcareSystem

Healthcare system with multiple facilities

HeatmapData

Heatmap data for visualization

HistoricalBacktester

Historical backtester for time series validation

HistoryStats

Overall history statistics

HistoryTracker

Execution history tracker

Household

Household structure

HouseholdFormationModel

Household formation model

HousingMarket

Housing market state and dynamics

HousingUnit

Housing unit

HybridResult

Result from a hybrid classical-quantum simulation.

HybridSimulation

Hybrid classical-quantum simulation framework.

HybridSimulator

Hybrid simulator combining time-step and event-driven approaches.

HyperbolicDiscounting

Hyperbolic discounting model

HypothesisTest

Statistical hypothesis testing utilities.

ImpactReport

Regulatory impact assessment report.

IncomeMobilityModel

Income mobility model (transition matrix between quintiles)

IncomeWealthGenerator

Income/wealth distribution generator

InflationAdjuster

Inflation adjuster for converting between nominal and real values

InfluenceConfig

Social influence model configuration.

InfrastructureImpact

Infrastructure impact analysis

InfrastructureProject

Infrastructure project

InputOutputModel

Input-Output economic model (Leontief)

Intention

Intention (committed plan) in BDI architecture

InterruptedSimulation

Information about an interrupted simulation

IoTDataIngestion

IoT data ingestion framework for collecting sensor data.

JobDependency

Job dependency specification

JobQueue

Job queue for managing simulation jobs

KFoldValidationFold

K-fold validation fold

KFoldValidationResult

K-fold validation result

KFoldValidator

K-fold validator

LaborMarket

Labor market state and dynamics

LandParcel

Land parcel

LawApplicationResult

Result of applying a law to an entity.

LazyAttributeCache

Lazy attribute cache for delayed evaluation

LegislativePreset

Legislative impact forecasting preset

LimitOrder

Limit order in order book

LinearForecast

Linear trend forecast.

LiveParameter

Parameter that can be adjusted during simulation.

LoadBalancer

Load balancer for distributing work across nodes

MacroeconomicIndicators

Macroeconomic indicators for context and analysis

MarketDepth

Market depth information

Meme

Meme (cultural unit) in cultural evolution.

MemoryMappedPopulation

Memory-mapped population manager

Message

Message for cross-node communication

MessageQueue

Message queue for storing and retrieving messages

MetricsDiff

Differences between two simulation metrics.

MigrationModel

Migration pattern model

MonteCarloConfig

Configuration for Monte Carlo simulation.

MonteCarloResult

Results from a Monte Carlo simulation run.

MonteCarloRunner

Monte Carlo runner for probabilistic simulation.

MortalityModel

Mortality rate model

MovingAverageForecast

Moving average forecast.

MultiObjectiveOptimizer

Multi-objective policy optimizer

MultiObjectiveResult

Multi-objective optimization result

NaturalDisaster

Natural disaster event

NelderMeadOptimizer

Nelder-Mead simplex optimizer (gradient-free).

NodeInfo

Node information in a distributed cluster

OptimizationResult

Optimization result.

OrderBook

Market microstructure model (order book)

Organization

Organization hierarchy (e.g., company structure).

OutcomePrediction

Court case outcome prediction

PageRankResult

PageRank result for identifying influential entities.

ParallelExecutor

Parallel work executor with optimized distribution

ParameterAdjuster

Manager for live parameter adjustments.

ParameterAdjustment

Record of a parameter adjustment.

ParameterBounds

Parameter bounds for optimization.

ParameterCalibrator

Parameter calibrator.

ParameterConfig

Interactive parameter configuration for tuning UI

ParameterRange

Parameter range for sensitivity analysis

ParameterSensitivity

Sensitivity analysis result for a single parameter

ParameterSweep

Parameter sweep configuration

ParameterSweepOrchestrator

Multi-parameter sweep orchestrator

ParameterTuningUI

Interactive parameter tuning UI data

ParetoFrontier

Pareto frontier for multi-objective optimization.

PartitionManager

Partition manager for distributing entities across nodes

PartyComposition

Party composition in legislature

PassageForecast

Legislative passage forecast

PayoffMatrix

Payoff matrix for 2-player games

Penalty

Penalty for non-compliance

PersistenceConfig

Configuration for persistence

PolicyComparison

Policy comparison result

PolicyDistributionalAnalysis

Policy distributional analysis

PolicyDistributionalImpact

Policy distributional impact data

PolicyObjective

Represents a policy objective to be optimized

PolicySensitivity

Policy sensitivity analysis

PopulationBuilder

Builder for creating test populations.

PopulationCarbonTracker

Aggregate carbon tracking for populations

PopulationGenerator

Population generator with demographic modeling.

PopulationImporter

Population importer for CSV and JSON files.

PopulationMetadata

Memory-mapped population storage for large datasets

PopulationSegment

Population segment analysis.

PopulationValidator

Population validator.

PortfolioOptimizer

Portfolio optimizer for finding optimal statute combinations.

Precedent

Legal precedent

PredictionAccuracy

Comprehensive prediction accuracy metrics

PredictiveMaintenance

Predictive maintenance model for equipment.

PrivacyPreservingGenerator

Privacy-preserving synthetic population generator

ProgressTracker

Progress tracker for long-running simulations.

ProjectionConfig

Configuration for future projection.

Property

Property or asset ownership.

PropertyRegistry

Registry of all properties.

Proposal

Proposal for a task.

ProspectTheory

Behavioral economics prospect theory value function

QLearningAgent

Q-Learning agent for reinforcement learning

QMCResult

Result from a Quantum Monte Carlo simulation.

QuantumAnnealing

Quantum-inspired optimization using quantum annealing principles.

QuantumInspiredOptimizer

Quantum-inspired optimizer for combinatorial problems.

QuantumMonteCarlo

Quantum Monte Carlo sampler for enhanced sampling in high-dimensional spaces.

QuantumOptimizationResult

Result from quantum-inspired optimization.

QuantumRNG

Quantum random number generator using quantum principles.

QueueStats

Queue statistics

QuintileImpact

Impact on a specific income quintile.

RealTimeDashboard

Real-time dashboard stream handler

Region

Geographic region for population distribution.

Relationship

A relationship between two entities.

RelationshipConditions

Relationship-based condition evaluator.

RelationshipGraph

Graph of relationships between agents.

ResourceScarcity

Resource availability and scarcity model

ResultStorage

Result storage system

ResumeManager

Resume manager for handling simulation recovery

RetryConfig

Retry configuration for failed jobs

RetryableJob

Retryable job wrapper

RiskAnalysisReport

Comprehensive risk analysis report.

RiskMetrics

Comprehensive risk metrics for simulation results.

SEIRModel

Extended SEIR model (Susceptible, Exposed, Infected, Recovered)

SIRModel

Compartmental model for disease spread (SIR - Susceptible, Infected, Recovered)

SarsaAgent

SARSA agent (on-policy reinforcement learning)

Scenario

A policy scenario with associated probability and metrics.

ScenarioComparison

Scenario comparison utilities for A/B testing.

ScenarioEvaluator

Multi-criteria scenario evaluator.

ScenarioNode

A node in a scenario tree representing a decision point or outcome.

ScenarioRanking

Scenario ranking by multiple criteria.

ScenarioResult

Result of running a what-if scenario.

ScenarioSensitivity

Sensitivity analysis for scenario assumptions.

ScenarioSet

Collection of scenarios for analysis.

ScenarioTree

Scenario tree for decision analysis.

SensitivityAnalysis

Sensitivity analysis for statute parameters.

SensitivityAnalyzer

Automated sensitivity analyzer

SensitivityPoint

Policy sensitivity analysis data point

SensitivityResults

Results of sensitivity analysis.

SensorData

IoT sensor data point.

SensorValidationRule

Validation rule for sensor data.

SimEngine

Simulation engine for running legal simulations.

SimEngineBuilder

Builder for configuring and creating a simulation engine.

SimdBatchProcessor

SIMD-accelerated batch operations for numeric data.

SimulationAPI

Simulation-as-a-Service API

SimulationComparison

Comparison API for comparing simulation results

SimulationController

Controller for simulation execution.

SimulationDebugger

Debugger for simulations.

SimulationJob

A simulation job in the queue

SimulationMetrics

Metrics collected during simulation.

SimulationReplay

Simulation replay for debugging and analysis

SimulationResult

Storage for simulation results

SimulationSnapshot

Snapshot of simulation state at a time step.

SimulationState

Simulation state for event-driven simulation.

SmartCityPolicy

Smart city policy

SmartCityPortfolio

Smart city policy portfolio

SocialDeterminants

Social determinants of health

SocialNetworkDynamics

Social network dynamics simulator.

SocialNode

Social network node representing an agent.

Stakeholder

Stakeholder group for impact analysis

StakeholderImpact

Impact on a stakeholder group

StakeholderMatrix

Stakeholder impact matrix

StateUpdate

State update between physical and digital entities.

StatuteComparison

Comparison result between two statute versions.

StatuteMetrics

Metrics for a single statute.

StatutePortfolio

A portfolio of statutes with their associated metrics.

StreamingProcessor

Streaming processor for memory-efficient population processing

SummaryStats

Calculates summary statistics from a list of values.

SyncResult

Result of a synchronization operation.

SynchronizationManager

Real-time synchronization manager for digital twins.

SyntheticPopulationGenerator

Comprehensive synthetic population generator

Task

Task in Contract Net Protocol.

TaxBracket

Tax bracket definition

TaxCalculation

Result of tax calculation

TaxCredit

Tax credit definition

TaxSystemPreset

Tax system configuration preset

TemporalConfig

Configuration for temporal simulation.

TemporalMetrics

Temporal simulation metrics.

TemporalSimBuilder

Builder for temporal simulations.

TemporalSimEngine

Temporal simulation engine.

TemporalStatute

Temporal statute wrapper with effective dates.

TimeLapseFrame

Animated time-lapse frame for temporal simulations

TimeLapseVisualization

Animated time-lapse visualization

TimeSeries

Time series of simulation metrics.

TimeSeriesAnalyzer

Time-series analyzer.

TimeSeriesPoint

Time-series data point for D3 visualization

TimeSnapshot

Snapshot of simulation state at a point in time.

TimedJob

Job with timeout tracking

TimeoutConfig

Timeout configuration for jobs

TrafficEdge

Traffic network edge (road segment, transit line)

TrafficNode

Traffic network node (intersection, station, etc.)

Transaction

Transaction record

TransportationNetwork

Transportation network

TwinQueueStats

Statistics about update queues.

TwinScenarioComparison

Comparison of multiple scenario results.

UncertaintyQuantification

Uncertainty quantification result

UnintendedConsequence

Unintended consequence identified.

UpdateStream

Stream of simulation updates.

UrbanHousingMarket

Urban housing market with detailed unit tracking

UrbanSprawlModel

Urban sprawl model

VaccineDistribution

Vaccine distribution plan

ValidationError

Validation error.

ValidationResult

Validation result comparing simulated vs empirical data

ValueAtRisk

Value at Risk (VaR) calculation for policy outcomes.

VisualizationIntegration

Manager for real-time visualization integration.

VotingPattern

Historical voting pattern

VulnerableImpact

Impact on vulnerable populations.

WebhookDelivery

Webhook delivery system

WebhookNotification

Webhook notification system

WhatIfAnalysis

What-if analysis engine for digital twins.

WhatIfScenario

What-if analysis scenario for digital twins.

WorkScheduler

Work scheduler for optimal thread distribution

Enums

AgeGroup

Age group categories

BenefitAmount

Benefit amount calculation

BenefitType

Type of benefit program

BreakpointCondition

Breakpoint condition.

ClimateScenario

Climate scenario based on IPCC projections

ClusterMessageType

Message type for cross-node communication

CohortFilter

Filter for cohort membership.

ComparisonOperator

Comparison operator for breakpoint conditions.

ComplianceDecision

Compliance decision result.

ComplianceType

Type of regulatory compliance

ContractStatus

Status of a contract.

ContractType

Type of contract.

CoordinationMessage

Message types for multi-agent coordination.

CourtLevel

Court level

DecisionStrategy

Decision-making strategy for agents.

DiffusionModel

Information diffusion model.

DisasterSeverity

Severity level of a disaster

DisasterType

Type of natural disaster

Distribution

Distribution type for numeric attributes.

DistributionModel

Income/wealth distribution model

DistributionType

Type of statistical distribution.

EducationLevel

Education level categories

EmploymentStatus

Employment status categories

EventType

Event type classification.

FactorType

Type of case factor

GdpComponent

GDP components

Gender

Gender categories

GpuBackend

GPU backend type

HouseholdType

Household type

HousingType

Type of housing unit

IncomeQuintile

Income quintile

InfrastructureType

Type of infrastructure

JobPriority

Priority level for simulation jobs

JobStatus

Status of a simulation job

LandUse

Land use type

LegislativeLevel

Legislative level

LoadBalanceStrategy

Load balancing strategy

MaintenanceUrgency

Maintenance urgency level.

Majority

Required voting majority

MeasurementBasis

Measurement basis for quantum RNG.

MessageType

Type of message agents can communicate.

NodeStatus

Status of a node in the cluster

Objective

Optimization objective.

OrderType

Order type in market

OrganizationRole

Role within an organization.

OrganizationType

Type of organization.

ParameterType

Type of parameter

PartitionStrategy

Partitioning strategy for distributing entities across nodes

PenaltyType

Type of penalty

Progressivity

Progressivity indicator for tax/regulatory burden.

ProjectionModel

Projection model for future simulation.

PropertyType

Type of property.

RealtimeSimulationState

Simulation control state.

RelationshipType

Type of relationship between agents.

RequirementType

Type of eligibility requirement

ResourceType

Resource type for scarcity modeling

SimulationError

Errors that can occur during simulation.

SimulationUpdate

Update event from a running simulation.

SmartCityPolicyType

Smart city policy type

SyncStatus

Synchronization status between physical entity and digital twin.

TaxType

Type of tax system

TemporalEvent

An event that occurs during temporal simulation.

TimeStep

Time step granularity for simulations.

TimeoutAction

Action to take when a job times out

TransportMode

Mode of transportation

TrendDirection

Trend direction.

UpdatePriority

Priority level for state updates.

UpdateType

Type of dashboard update

VaccinationStrategy

Vaccine distribution strategy

ValidationRule

Validation rule for population consistency.

Traits

EventHandler

Event handler trait.

Functions

aggregate_metrics

Aggregates multiple simulation metrics into a single combined metric.

aggregate_metrics_parallel

Aggregates multiple simulation metrics in parallel for large datasets. This is more efficient than aggregate_metrics for very large metric collections.

calculate_betweenness_centrality

Calculate betweenness centrality for each entity. Betweenness measures how often an entity appears on shortest paths.

calculate_centrality_metrics

Calculate all centrality metrics for a relationship graph.

calculate_closeness_centrality

Calculate closeness centrality for each entity. Closeness is based on the average distance to all other entities.

calculate_degree_centrality

Calculate degree centrality for each entity. Degree centrality is the number of connections an entity has.

calculate_eigenvector_centrality

Calculate eigenvector centrality using power iteration. Eigenvector centrality measures influence based on connections to influential entities.

calculate_pagerank

Calculates PageRank scores for entities in the network. PageRank identifies the most influential nodes based on network structure.

compare_metrics

Compares two sets of simulation metrics and returns the differences.

create_correlation_heatmap

Creates a heatmap from correlation matrix

create_dashboard_data

Create comprehensive dashboard data from simulation results

detect_communities_connected_components

Detects communities using simple connected components. Treats each connected component as a separate community.

detect_communities_label_propagation

Detects communities using label propagation algorithm. This is a fast, semi-supervised algorithm for community detection.

export_geographic_data

Export entities with geographic attributes to GeoJSON-like format

export_metrics_to_timeseries

Export metrics to time-series format for D3

export_to_d3

Export relationship graph to D3.js compatible JSON

export_to_graphviz

Export a relationship graph to GraphViz DOT format

hash_based_probability

Helper function for deterministic pseudo-random probability based on UUID.

set_behavior_seed^⚠

Sets the random seed for reproducible behavior tests.

set_population_seed^⚠

Sets the random seed for reproducible tests.

simulate_diffusion

Simulate information diffusion through the network.

simulate_influence_propagation

Simulate influence propagation through the network.

Type Aliases

MessageId

Message identifier for tracking

NodeId

Node identifier in a distributed system

SimResult

Result type for simulation operations.

VisualizationHook

Visualization update hook.