Novolis.Economy.Simulation
2026.1.0.57
dotnet add package Novolis.Economy.Simulation --version 2026.1.0.57
NuGet\Install-Package Novolis.Economy.Simulation -Version 2026.1.0.57
<PackageReference Include="Novolis.Economy.Simulation" Version="2026.1.0.57" />
<PackageVersion Include="Novolis.Economy.Simulation" Version="2026.1.0.57" />
<PackageReference Include="Novolis.Economy.Simulation" />
paket add Novolis.Economy.Simulation --version 2026.1.0.57
#r "nuget: Novolis.Economy.Simulation, 2026.1.0.57"
#:package Novolis.Economy.Simulation@2026.1.0.57
#addin nuget:?package=Novolis.Economy.Simulation&version=2026.1.0.57
#tool nuget:?package=Novolis.Economy.Simulation&version=2026.1.0.57
Novolis.Economy.Simulation
Composition and execution layer for economic models: EconomyWorld, clocks,
ordered phases, model profiles, agents, run manifests, metrics, and stable
fingerprints.
Holds operational collections for orchestration; OwnershipClaim and
FirmLedger remain Accounting compatibility/input projections. Economic
authority is Novolis.Economy.Core (EconomyWorld.CoreState),
including positions, cash positions, claims, and Core share holdings. This
layer selects and runs the period engine; Core never owns the clock or phase
ordering.
EconomicRegion + AddRegion / household AddCohort living clamp; region labor pools; production slots for mfg/assembly only.
Registration is strict by default. Hosts that deliberately want game-friendly
implicit Core entities, assets, or regions must pass
RegistrationMode.Implicit to EconomyWorld or EconomyWorldBuilder.
SmallOpenRegionalTradeModel is the flagship operational composition. It
creates bounded regional capacity, retail restocking, cohort food demand,
explicit external-sector procurement/export schedules, a working-capital
facility, and replayable rules-based firm/carrier actors. Its period boundary
advances Core's period marker after hourly effects have already been applied;
the deterministic bounded profile is the model that runs the full sixteen-step
teaching pipeline.
Does not reference Novolis.Simulation.* (spatial stack).
Install
dotnet add package Novolis.Economy.Simulation
Quick start
using Novolis.Economy;
using Novolis.Economy.Production;
using Novolis.Economy.Simulation;
using Novolis.Economy.Simulation.Extensions;
var world = new EconomyWorldBuilder()
.AddRegion(areaId, livingCapacityHouseholds: 10_000, productionSlots: 50)
.Build();
var sim = EconomySimulation.FromModel(
seed: 42,
new Models.SmallOpenRegionalTradeModel());
sim.Enqueue(new SetProductionPlan(firmId, facilityId, productId, Quantity.From(50m)));
await sim.AdvanceAsync(SimulationDuration.FromHours(24));
Console.WriteLine(WorldReportFormatter.Format(world.ToReportSnapshot()));
Custom phase order (tests): new EconomySimulation(seed, world, PhasePipeline.CreateDefault()).
API
| Type | Role |
|---|---|
EconomySimulation |
Command queue, AdvanceAsync, throughput mode |
IEconomySimulation |
Simulation contract |
SimulationModelDefinition |
Complete model composition surface |
SmallOpenRegionalTradeModel |
Documented flagship open regional model |
DeterministicBoundedModel |
Finite, replayable secondary profile |
SimulationRun / SimulationRunRequest |
Model-owned run execution and results |
SimulationRunManifest |
Reproducibility identity and selected rules |
SimulationMetrics / SimulationSweep |
Run observations and parameter sweeps |
EconomyWorld |
Firms, regions, inventory, ledgers, loans, hub book |
EconomyWorldBuilder |
Fluent world setup (AddRegion, AddFirm, AddProduct, …) |
EconomyWorldExtensions |
ToReportSnapshot() |
PhasePipeline / DefaultPhases |
Ordered hourly + period-close phases |
ISimulationPhase |
Single phase hook |
SimulationPhaseOrder |
Phase enum ordering |
CoreEconomyBridge |
Bind hub regions; period execution stays in the selected model |
CoreInventoryBridge / CoreCashBridge |
Reconcile operational detail into Core authority |
DefaultConsequenceEngine |
Post-command side effects |
LegalEntity / LegalEntityKind |
Ops party records |
CohortBudgetResetMode |
When cohort budgets refresh |
MoneyStock |
Aggregate money diagnostics |
WorldReportFormatter |
Format(WorldReportSnapshot) text report |
Dogfooding / apps
Composition root for novolis-dogfooding apps/economy/ (EconomyBoard, TrampFreighterPlay).
Related
| Package | Role |
|---|---|
Novolis.Economy.Core |
BM kernel advanced at period boundaries |
Novolis.Economy.Production |
Command / event types enqueued here |
Novolis.Economy.Agents |
Tick agents before each hour |
Novolis.Economy.Finance |
SettleFinance uses LoanEngine |
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Novolis.Economy.Abstractions (>= 2026.1.0.57)
- Novolis.Economy.Accounting (>= 2026.1.0.57)
- Novolis.Economy.Agents (>= 2026.1.0.57)
- Novolis.Economy.Core (>= 2026.1.0.57)
- Novolis.Economy.Finance (>= 2026.1.0.57)
- Novolis.Economy.Logistics (>= 2026.1.0.57)
- Novolis.Economy.Markets (>= 2026.1.0.57)
- Novolis.Economy.Population (>= 2026.1.0.57)
- Novolis.Economy.Primitives (>= 2026.1.0.57)
- Novolis.Economy.Production (>= 2026.1.0.57)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 2026.1.0.57 | 113 | 10/18/2026 |
| 2026.1.0.55 | 97 | 10/18/2026 |
| 2026.1.0.54 | 95 | 10/4/2026 |
| 2026.1.0.53 | 94 | 10/1/2026 |
| 2026.1.0.52 | 93 | 9/30/2026 |